https://api.nexscope.ai/seo/backlinkPageIntersectionEjecutar esta API
Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.
Endpoint
| Método | POST |
| Ruta | https://api.nexscope.ai/seo/backlinkPageIntersection |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
limit | integer | opcional | Valor de Limit usado por esta operación de API. Predeterminado: 10 Mínimo: 1 Máximo: 20 |
target1 | object | obligatorio | Valor de Target1 usado por esta operación de API. |
target1.kind | string | obligatorio | Valor de Kind usado por esta operación de API. Permitidos: DOMAIN, PAGE |
target1.target | string | obligatorio | Valor de Target usado por esta operación de API. Longitud mínima: 1 Longitud máxima: 2048 |
target2 | object | obligatorio | Valor de Target2 usado por esta operación de API. |
target2.kind | string | obligatorio | Valor de Kind usado por esta operación de API. Permitidos: DOMAIN, PAGE |
target2.target | string | obligatorio | Valor de Target usado por esta operación de API. Longitud mínima: 1 Longitud máxima: 2048 |
Respuesta de ejemplo
Estructura de respuesta de ejemplo del contrato documentado de la API de SEO.
{
"code": 0,
"cost": "-1",
"data": {
"callId": "synthetic-call",
"completedAt": null,
"coverage": {
"missing": [
{
"field": "synthetic",
"reason": "UPSTREAM_FIELD_MISSING"
}
],
"status": "PARTIAL"
},
"requestedAt": "123",
"result": {
"inputTarget1": {
"kind": "synthetic",
"target": "synthetic"
},
"inputTarget2": {
"kind": "synthetic",
"target": "synthetic"
},
"items": [
{
"first": [
{
"anchor": "synthetic",
"dofollow": false,
"firstSeenAt": 9007199254740992,
"fromUrl": "synthetic",
"isLost": false,
"isNew": false,
"lastSeenAt": 9007199254740992,
"linksCount": 9007199254740992,
"missing": [
{
"field": "synthetic",
"reason": "synthetic"
}
],
"rank": 9007199254740992,
"spamScore": 9007199254740992,
"toUrl": "synthetic"
}
],
"missing": [
{
"field": "synthetic",
"reason": "synthetic"
}
],
"referringPage": "synthetic",
"second": [
{
"anchor": "synthetic",
"dofollow": false,
"firstSeenAt": 9007199254740992,
"fromUrl": "synthetic",
"isLost": false,
"isNew": false,
"lastSeenAt": 9007199254740992,
"linksCount": 9007199254740992,
"missing": [
{
"field": "synthetic",
"reason": "synthetic"
}
],
"rank": 9007199254740992,
"spamScore": 9007199254740992,
"toUrl": "synthetic"
}
]
}
],
"missing": [
{
"field": "synthetic",
"reason": "synthetic"
}
],
"normalizedTarget1": {
"kind": "synthetic",
"target": "synthetic"
},
"normalizedTarget2": {
"kind": "synthetic",
"target": "synthetic"
},
"providerTotalCount": 9007199254740992,
"requestedLimit": 1,
"returnedCount": 1,
"sourceKind": "synthetic",
"sourceProduct": "synthetic",
"truncated": false
},
"schemaVersion": "synthetic",
"source": "synthetic",
"status": "PARTIAL",
"usage": {
"billingStatus": "UNAPPROVED",
"chargedCredits": "0"
}
},
"msg": null,
"time": "2026-01-01 00:00:00",
"traceId": "synthetic-trace",
"ts": "9007199254740993"
}Campos de respuesta
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | integer | obligatorio | 0 indica un sobre de respuesta satisfactorio; comprueba data.status por separado. Permitidos: 0, 42008, 42009 |
cost | string | obligatorio | Milisegundos transcurridos de procesamiento; no es el precio. -1 en un contexto no web. |
data | object | obligatorio | Valor de Data usado por esta operación de API. |
data.callId | string | null | opcional | Valor de Call id usado por esta operación de API. |
data.completedAt | string | integer | null | opcional | Valor de Completed at usado por esta operación de API. |
data.coverage | object | opcional | Valor de Coverage usado por esta operación de API. |
data.coverage.missing | array | opcional | Valor de Missing usado por esta operación de API. |
data.coverage.missing[] | object | obligatorio | Elemento de data coverage missing. |
data.coverage.missing[].field | string | opcional | Valor de Field usado por esta operación de API. |
data.coverage.missing[].reason | string | opcional | Valor de Reason usado por esta operación de API. |
data.coverage.status | string | opcional | Valor de Status usado por esta operación de API. |
data.requestedAt | string | integer | null | opcional | Valor de Requested at usado por esta operación de API. |
data.result | object | null | obligatorio | Valor de Result usado por esta operación de API. |
data.result.inputTarget1 | object | obligatorio | Valor de Input target1 usado por esta operación de API. |
data.result.inputTarget1.kind | string | obligatorio | Valor de Kind usado por esta operación de API. Permitidos: DOMAIN, PAGE |
data.result.inputTarget1.target | string | obligatorio | Valor de Target usado por esta operación de API. Longitud mínima: 1 Longitud máxima: 2048 |
data.result.inputTarget2 | object | obligatorio | Valor de Input target2 usado por esta operación de API. |
data.result.inputTarget2.kind | string | obligatorio | Valor de Kind usado por esta operación de API. Permitidos: DOMAIN, PAGE |
data.result.inputTarget2.target | string | obligatorio | Valor de Target usado por esta operación de API. Longitud mínima: 1 Longitud máxima: 2048 |
data.result.items | array | obligatorio | Valor de Items usado por esta operación de API. Cantidad mínima de elementos: 0 Cantidad máxima de elementos: 20 |
data.result.items[] | object | obligatorio | Elemento de data result items. |
data.result.items[].first | array | obligatorio | Valor de First usado por esta operación de API. Cantidad mínima de elementos: 1 Cantidad máxima de elementos: 5 |
data.result.items[].first[] | object | obligatorio | Elemento de data result items[] first. |
data.result.items[].first[].anchor | string | null | obligatorio | Valor de Anchor usado por esta operación de API. |
data.result.items[].first[].dofollow | boolean | null | obligatorio | Valor de Dofollow usado por esta operación de API. |
data.result.items[].first[].firstSeenAt | integer | null | obligatorio | Valor de First seen at usado por esta operación de API. Mínimo: 0 |
data.result.items[].first[].fromUrl | string | obligatorio | Valor de From url usado por esta operación de API. |
data.result.items[].first[].isLost | boolean | null | obligatorio | Valor de Is lost usado por esta operación de API. |
data.result.items[].first[].isNew | boolean | null | obligatorio | Valor de Is new usado por esta operación de API. |
data.result.items[].first[].lastSeenAt | integer | null | obligatorio | Valor de Last seen at usado por esta operación de API. Mínimo: 0 |
data.result.items[].first[].linksCount | integer | null | obligatorio | Valor de Links count usado por esta operación de API. Mínimo: 0 |
data.result.items[].first[].missing | array | obligatorio | Valor de Missing usado por esta operación de API. Cantidad mínima de elementos: 0 |
data.result.items[].first[].missing[] | object | obligatorio | Elemento de data result items[] first[] missing. |
data.result.items[].first[].missing[].field | string | obligatorio | Valor de Field usado por esta operación de API. |
data.result.items[].first[].missing[].reason | string | obligatorio | Valor de Reason usado por esta operación de API. Permitidos: UPSTREAM_FIELD_MISSING, UPSTREAM_FIELD_INVALID, DUPLICATE_UPSTREAM_ITEM, UPSTREAM_ITEM_MISSING |
data.result.items[].first[].rank | integer | null | obligatorio | Valor de Rank usado por esta operación de API. Mínimo: 0 Máximo: 1000 |
data.result.items[].first[].spamScore | integer | null | obligatorio | Valor de Spam score usado por esta operación de API. Mínimo: 0 Máximo: 100 |
data.result.items[].first[].toUrl | string | obligatorio | Valor de To url usado por esta operación de API. |
data.result.items[].missing | array | obligatorio | Valor de Missing usado por esta operación de API. Cantidad mínima de elementos: 0 |
data.result.items[].missing[] | object | obligatorio | Elemento de data result items[] missing. |
data.result.items[].missing[].field | string | obligatorio | Valor de Field usado por esta operación de API. |
data.result.items[].missing[].reason | string | obligatorio | Valor de Reason usado por esta operación de API. Permitidos: UPSTREAM_FIELD_MISSING, UPSTREAM_FIELD_INVALID, DUPLICATE_UPSTREAM_ITEM, UPSTREAM_ITEM_MISSING |
data.result.items[].referringPage | string | obligatorio | Valor de Referring page usado por esta operación de API. |
data.result.items[].second | array | obligatorio | Valor de Second usado por esta operación de API. Cantidad mínima de elementos: 1 Cantidad máxima de elementos: 5 |
data.result.items[].second[] | object | obligatorio | Elemento de data result items[] second. |
data.result.items[].second[].anchor | string | null | obligatorio | Valor de Anchor usado por esta operación de API. |
data.result.items[].second[].dofollow | boolean | null | obligatorio | Valor de Dofollow usado por esta operación de API. |
data.result.items[].second[].firstSeenAt | integer | null | obligatorio | Valor de First seen at usado por esta operación de API. Mínimo: 0 |
data.result.items[].second[].fromUrl | string | obligatorio | Valor de From url usado por esta operación de API. |
data.result.items[].second[].isLost | boolean | null | obligatorio | Valor de Is lost usado por esta operación de API. |
data.result.items[].second[].isNew | boolean | null | obligatorio | Valor de Is new usado por esta operación de API. |
data.result.items[].second[].lastSeenAt | integer | null | obligatorio | Valor de Last seen at usado por esta operación de API. Mínimo: 0 |
data.result.items[].second[].linksCount | integer | null | obligatorio | Valor de Links count usado por esta operación de API. Mínimo: 0 |
data.result.items[].second[].missing | array | obligatorio | Valor de Missing usado por esta operación de API. Cantidad mínima de elementos: 0 |
data.result.items[].second[].missing[] | object | obligatorio | Elemento de data result items[] second[] missing. |
data.result.items[].second[].missing[].field | string | obligatorio | Valor de Field usado por esta operación de API. |
data.result.items[].second[].missing[].reason | string | obligatorio | Valor de Reason usado por esta operación de API. Permitidos: UPSTREAM_FIELD_MISSING, UPSTREAM_FIELD_INVALID, DUPLICATE_UPSTREAM_ITEM, UPSTREAM_ITEM_MISSING |
data.result.items[].second[].rank | integer | null | obligatorio | Valor de Rank usado por esta operación de API. Mínimo: 0 Máximo: 1000 |
data.result.items[].second[].spamScore | integer | null | obligatorio | Valor de Spam score usado por esta operación de API. Mínimo: 0 Máximo: 100 |
data.result.items[].second[].toUrl | string | obligatorio | Valor de To url usado por esta operación de API. |
data.result.missing | array | obligatorio | Valor de Missing usado por esta operación de API. Cantidad mínima de elementos: 0 |
data.result.missing[] | object | obligatorio | Elemento de data result missing. |
data.result.missing[].field | string | obligatorio | Valor de Field usado por esta operación de API. |
data.result.missing[].reason | string | obligatorio | Valor de Reason usado por esta operación de API. Permitidos: UPSTREAM_FIELD_MISSING, UPSTREAM_FIELD_INVALID, DUPLICATE_UPSTREAM_ITEM, UPSTREAM_ITEM_MISSING |
data.result.normalizedTarget1 | object | obligatorio | Valor de Normalized target1 usado por esta operación de API. |
data.result.normalizedTarget1.kind | string | obligatorio | Valor de Kind usado por esta operación de API. Permitidos: DOMAIN, PAGE |
data.result.normalizedTarget1.target | string | obligatorio | Valor de Target usado por esta operación de API. Longitud mínima: 1 Longitud máxima: 2048 |
data.result.normalizedTarget2 | object | obligatorio | Valor de Normalized target2 usado por esta operación de API. |
data.result.normalizedTarget2.kind | string | obligatorio | Valor de Kind usado por esta operación de API. Permitidos: DOMAIN, PAGE |
data.result.normalizedTarget2.target | string | obligatorio | Valor de Target usado por esta operación de API. Longitud mínima: 1 Longitud máxima: 2048 |
data.result.providerTotalCount | integer | null | obligatorio | Valor de Provider total count usado por esta operación de API. Mínimo: 0 |
data.result.requestedLimit | integer | obligatorio | Valor de Requested limit usado por esta operación de API. Mínimo: 1 |
data.result.returnedCount | integer | obligatorio | Valor de Returned count usado por esta operación de API. Mínimo: 0 |
data.result.sourceKind | string | obligatorio | Valor de Source kind usado por esta operación de API. Constante: dataforseo_backlink_index |
data.result.sourceProduct | string | obligatorio | Valor de Source product usado por esta operación de API. Constante: backlinks |
data.result.truncated | boolean | obligatorio | Valor de Truncated usado por esta operación de API. |
data.schemaVersion | string | null | opcional | Valor de Schema version usado por esta operación de API. |
data.source | string | null | opcional | Valor de Source usado por esta operación de API. |
data.status | string | opcional | Valor de Status usado por esta operación de API. Permitidos: SUCCESS, PARTIAL, EMPTY, PROCESSING, UNKNOWN, FAILED |
data.usage | object | null | opcional | Valor de Usage usado por esta operación de API. |
data.usage.billingStatus | string | null | opcional | Valor de Billing status usado por esta operación de API. |
data.usage.chargedCredits | string | integer | null | opcional | Valor de Charged credits usado por esta operación de API. |
msg | string | null | obligatorio | Para los casos satisfactorios y los fallos se prefiere el valor disponible de msg/errmsg/message del proveedor; el chino se traduce al inglés. Si falta el mensaje de éxito, su valor es null. Los errores propios de la plataforma y los estados de las tareas utilizan el inglés de la plataforma. El texto del mensaje nunca determina el éxito ni el reintento. |
time | string | obligatorio | yyyy-MM-dd HH:mm:ss |
traceId | string | null | obligatorio | Valor de Trace id usado por esta operación de API. |
ts | string | obligatorio | Milisegundos desde el inicio de la época; serializador global de enteros long. |
Respuesta de procesamiento aceptado
code 0 confirma la aceptación. Usa data.callId para consultar la misma solicitud; el procesamiento no implica finalización.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | integer | obligatorio | 0 indica un sobre de respuesta satisfactorio; comprueba data.status por separado. Constante: 0 |
cost | string | obligatorio | Milisegundos transcurridos de procesamiento; no es el precio. -1 en un contexto no web. |
data | object | obligatorio | Valor de Data usado por esta operación de API. |
data.callId | string | null | obligatorio | Valor de Call id usado por esta operación de API. |
data.reason | string | obligatorio | Valor de Reason usado por esta operación de API. Constante: IN_PROGRESS |
data.retryable | boolean | opcional | Valor de Retryable usado por esta operación de API. |
data.status | string | obligatorio | Valor de Status usado por esta operación de API. Constante: PROCESSING |
data.taskId | string | null | opcional | Valor de Task id usado por esta operación de API. |
msg | string | null | obligatorio | Para los casos satisfactorios y los fallos se prefiere el valor disponible de msg/errmsg/message del proveedor; el chino se traduce al inglés. Si falta el mensaje de éxito, su valor es null. Los errores propios de la plataforma y los estados de las tareas utilizan el inglés de la plataforma. El texto del mensaje nunca determina el éxito ni el reintento. |
time | string | obligatorio | yyyy-MM-dd HH:mm:ss |
traceId | string | null | obligatorio | Valor de Trace id usado por esta operación de API. |
ts | string | obligatorio | Milisegundos desde el inicio de la época; serializador global de enteros long. |
Respuesta de error
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | integer | obligatorio | 0 indica un sobre de respuesta satisfactorio; comprueba data.status por separado. |
cost | string | obligatorio | Milisegundos transcurridos de procesamiento; no es el precio. -1 en un contexto no web. |
data | object | obligatorio | Valor de Data usado por esta operación de API. |
data.callId | string | null | obligatorio | Valor de Call id usado por esta operación de API. |
data.reason | string | null | obligatorio | Valor de Reason usado por esta operación de API. |
data.retryable | boolean | opcional | Valor de Retryable usado por esta operación de API. |
data.status | string | null | obligatorio | Valor de Status usado por esta operación de API. |
data.taskId | string | null | opcional | Valor de Task id usado por esta operación de API. |
msg | string | null | obligatorio | Para los casos satisfactorios y los fallos se prefiere el valor disponible de msg/errmsg/message del proveedor; el chino se traduce al inglés. Si falta el mensaje de éxito, su valor es null. Los errores propios de la plataforma y los estados de las tareas utilizan el inglés de la plataforma. El texto del mensaje nunca determina el éxito ni el reintento. |
time | string | obligatorio | yyyy-MM-dd HH:mm:ss |
traceId | string | null | obligatorio | Valor de Trace id usado por esta operación de API. |
ts | string | obligatorio | Milisegundos desde el inicio de la época; serializador global de enteros long. |
Obtener un resultado en procesamiento
Una respuesta conPROCESSING y un callIdsignifica que el resultado aún se está preparando. Usa la consulta de resultado siguiente con el identificador devuelto. Esta consulta lee el resultado guardado y no consume créditos.
curl -X GET https://api.nexscope.ai/seo/backlinkPageIntersection/calls/{callId} \
-H "Authorization: Bearer nk-xxxxxxxxxxxxxxxxx"Respuestas
| Código | Descripción |
|---|---|
| 200 | Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado. |
| 429 | Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente. |
| 503 | La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente. |
| Opcional | X-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como la ausencia de una clave API (code 11209), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200. |
Fuente de datos, vigencia y limitaciones
La fuente, la vigencia, la cobertura, los límites de frecuencia y las notas de estimación no se especifican en esta definición de API salvo que aparezcan en la documentación de campos de solicitud o respuesta anterior. No supongas datos oficiales del mercado ni actualización en tiempo real cuando no estén documentados explícitamente.