DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Intersección de páginas
Las páginas que enlazan a varias URL de destino a la vez, en lugar de los dominios. ⚠️ targets es un objeto indexado por posición y acepta URL completas, no dominios sin protocolo. Cada fila incluye page_intersection y un summary por target. El equivalente a nivel de dominio es post_dataforseo_backlinks_domain_intersection_live, que conviene consultar primero.
Referencia de precios
- Medición: Coste de la respuesta notificado.
- Estimación de referencia por solicitud: USD 0.033.
- Multiplicador de referencia del cliente: 1.0. No volver a aplicarlo a un importe de cliente ya liquidado.
Solo metadatos de referencia, no una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.
- Tipo: array (object | null)[]
- backlinksTipo: string | null
_status _type define qué backlinks devolver y contar
campo opcional
puedes usar este campo para elegir qué backlinks se devolverán y se usarán para las métricas agregadas de tustargets;
valores posibles:all- se devolverán y contarán todos los backlinks;live- se devolverán y contarán los backlinks encontrados en la última comprobación;lost- se devolverán y contarán los backlinks perdidos;valor predeterminado:
live - excludeTipo: boolean | null
_internal _backlinks indica si los backlinks internos de subdominios al
targetse excluirán de los resultados
campo opcional
si se define comotrue, los resultados no incluirán datos sobre backlinks internos de subdominios del mismo dominio que eltarget
si se define comofalse, los enlaces internos se incluirán en el resultado
valor predeterminado:true - excludeTipo: array string[] | null
_targets dominios, subdominios o páginas web que quieres excluir
campo opcional
puedes definir hasta 10 dominios, subdominios o páginas web
si usas este array, los resultados contendrán las páginas de referencia que enlazan atargetspero no aexclude_targets
ejemplo:"exclude_targets": [<br>"bbc.com",<br>"https://www.apple.com/iphone/*",<br>"https://dataforseo.com/apis/*"] - filtersTipo: array (object | null)[] | null
array de parámetros de filtrado de resultados
campo opcional
puedes añadir varios filtros a la vez (8 filtros como máximo)
define un operador lógicoandoorentre las condiciones
se admiten los siguientes operadores:regex,not_regex,=,<>,in,not_in,like,not_like,ilike,not_ilike,match,not_match
puedes usar el operador%conlikeynot_likepara coincidir con cualquier cadena de cero o más caracteres
ejemplo:["1.rank",">","80"][["2.page_from_rank",">","55"],
"and",
["1.original","=","true"]][["1.first_seen",">","2017-10-23 11:31:45 +00:00"],
"and",
[["1.acnhor","like","%seo%"],"or",["1.text_pre","not_like","%seo%"]]]Objeto vacío - includeTipo: boolean | null
_indirect _links indica si los enlaces indirectos a los
targetsse incluirán en los resultados
campo opcional
si se define comotrue, los resultados incluirán datos sobre enlaces indirectos que apuntan a una página que redirige a un destino o apunta a una página canónica
si se define comofalse, los enlaces indirectos se ignorarán
valor predeterminado:true - includeTipo: boolean | null
_subdomains indica si los subdominios de los
targetsse incluirán en la búsqueda
campo opcional
si se define comofalse, los subdominios se ignorarán
valor predeterminado:true - internalTipo: integer | null
_list _limit número máximo de elementos dentro de los arrays internos
campo opcional
puedes usar este campo para limitar el número de elementos de los siguientes arrays:attributesdomain_from_platform_typevalor predeterminado:
10
valor máximo:1000 - intersectionTipo: string | null
_mode indica si se deben intersecar los backlinks
campo opcional
usa este campo para intersecar o combinar resultados de las URL especificadas
valores posibles:all,partialall- los resultados se basan en todos los backlinks;partial- los resultados se basan solo en los backlinks que se intersecan;
valor predeterminado:all - limitTipo: integer | null
el número máximo de backlinks devueltos
campo opcionalvalor predeterminado:
100
valor máximo:1000 - offsetTipo: integer | null
desplazamiento en el array de resultados de los backlinks devueltos
campo opcionalvalor predeterminado:
0
si especificas el valor10, se omitirán los diez primeros backlinks del array de resultados y los datos se proporcionarán para los backlinks siguientes - orderTipo: array string[] | null
_by reglas de ordenación de los resultados
campo opcional
puedes usar los mismos valores que en el arrayfilterspara ordenar los resultados
tipos de ordenación posibles:asc- los resultados se ordenarán en orden ascendentedesc- los resultados se ordenarán en orden descendente
usa una coma para definir el tipo de ordenación
ejemplo:["rank,desc"]
ten en cuenta que puedes definir como máximo tres reglas de ordenación en una sola solicitud
usa una coma para separar varias reglas de ordenación
ejemplo:["domain_from_rank,desc","page_from_rank,asc"] - rankTipo: string | null
_scale define la escala utilizada para calcular y mostrar los valores de
rank,domain_from_rankypage_from_rank
campo opcionalpuedes usar este parámetro para elegir si los valores de rank se presentan en una escala de 0–100 o de 0–1000
valores posibles:
one_hundred— los valores de rank se muestran en una escala de 0–100one_thousand— los valores de rank se muestran en una escala de 0–1000valor predeterminado:
one_thousandobtén más información sobre cómo funciona este parámetro y cómo se calculan las métricas de ranking en este artículo del Centro de ayuda
- tagTipo: string | null
identificador de tarea definido por el usuario
campo opcional
el límite de caracteres es 255
puedes usar este parámetro para identificar la tarea y relacionarla con el resultado
encontrarás el valor detagespecificado en el objetodatade la respuesta - targetsTipo: object | null
dominios, subdominios o páginas web para obtener enlaces
campo obligatorio
puedes definir hasta 20 dominios, subdominios o páginas web
un dominio o subdominio debe especificarse sinhttps://ywww.
una página debe especificarse con URL absoluta (incluidohttp://ohttps://)
ejemplo:"targets": {<br>"1": "http://planet.postgresql.org/",<br>"2": "http://gborg.postgresql.org/"<br>}- propertyTipo: string | null
Name
- Tipo: object | null · Response36Afe1097B20_BacklinksPageIntersectionLiveResponseInfo200
- Tipo: number | null Formato: doublecost
costo total de las tareas, USD
- Tipo: integer | nullstatus
_code código de estado general puedes encontrar la lista completa de los códigos de respuesta aquí
- Tipo: string | nullstatus
_message mensaje informativo general puedes encontrar la lista completa de los mensajes informativos generales aquí
- Tipo: array (object | null)[] | nulltasks
array de tareas
- Tipo: object | null · Response36Afe1097B20_BacklinksPageIntersectionLiveTaskInfo
- costTipo: number | null Formato: double
costo total de las tareas, USD
- dataTipo: object | null
contiene los mismos parámetros que especificaste en la solicitud POST
- propertyTipo: object | null
Name
- idTipo: string | null
identificador de la tarea identificador único de la tarea en nuestro sistema en formato UUID
- pathTipo: array (string | null)[] | null
ruta de la URL
- resultTipo: array (object | null)[] | null
array de resultados
- itemsTipo: array (object | null)[] | null
contiene backlinks relevantes y datos de dominios de referencia
- pageTipo: object | null
_intersection contiene datos sobre las páginas que enlazan a los destinos correspondientes especificados en el array POST
los datos se proporcionan en objetos separados correspondientes a las páginas especificadas en el objetotargets- propertyTipo: array (object | null)[] | null
Name - altTipo: string | null
texto alternativo de la imagen
este campo seránullsi eltypedel backlink no es image - anchorTipo: string | null
texto de ancla del backlink
- attributesTipo: array (string | null)[] | null
atributos de enlace de los enlaces de referencia
ejemplo:nofollow - backlinkTipo: integer | null
_spam _score - dofollowTipo: boolean | null
indica si el backlink es dofollow
si esfalse, el backlink es nofollow - domainTipo: string | null
_from dominio que hace referencia al dominio o la página web de destino
- domainTipo: string | null
_from _country código de país ISO del dominio de referencia
- domainTipo: string | null
_from _ip dirección IP del dominio de referencia
- domainTipo: boolean | null
_from _is _ip indica si el dominio es una IP
si estrue, el dominio funciona como una dirección IP y no tiene nombre de dominio - domainTipo: array (string | null)[] | null
_from _platform _type tipos de plataforma del dominio de referencia
valores posibles:
cms,blogs,ecommerce,message-boards,wikis,news,organization - domainTipo: integer | null
_from _rank rank de dominio del dominio de referencia
indica el rank del dominio en el momento en que nuestro rastreador vio el backlink por última vez;domain_from_rankse calcula según el método de clasificación de nodos en una base de datos enlazada — un principio usado en el algoritmo PageRank original de Google
obtén más información sobre la métrica y cómo se calcula en este artículo del Centro de ayuda - domainTipo: string | null
_to dominio al que apunta el backlink
- firstTipo: string | null
_seen fecha y hora en que nuestro rastreador encontró el backlink por primera vez
en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ejemplo:2019-11-15 12:57:46 +00:00 - groupTipo: integer | null Formato: int64
_count indica el número total de backlinks de este dominio
por ejemplo, simodese define comoone_per_domain, este campo indicará el número total de backlinks procedentes de este dominio - indirectTipo: array (object | null)[] | null
_link _path ruta del enlace indirecto
indica una URL o una secuencia de URLs que conducen aurl_to- statusTipo: integer | null
_code código de estado general
puedes encontrar la lista completa de códigos de respuesta aquí
Nota: recomendamos encarecidamente diseñar un sistema necesario para gestionar las condiciones excepcionales o de error relacionadas - typeTipo: string | null
tipo de elemento
- urlTipo: string | null
URL del enlace indirecto
- isTipo: boolean | null
_broken indica si el backlink está roto
si estrue, el backlink apunta a una página que responde con un código de estado 4xx o 5xx - isTipo: boolean | null
_indirect _link indica si el backlink es un enlace indirecto
si estrue, el backlink es un enlace indirecto que apunta a una página que redirige aurl_too apunta a una página canónica - isTipo: boolean | null
_lost indica si se eliminó el backlink
si estrue, se eliminó el backlink o la página entera - isTipo: boolean | null
_new indica si el backlink es nuevo
si estrue, el backlink se encontró en la página la última vez que nuestro rastreador la visitó - itemTipo: string | null
_type tipo de enlace
valores posibles:anchor,image,link,meta,canonical,alternate,redirect - lastTipo: string | null
_seen fecha más reciente en que nuestro rastreador visitó el backlink
en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ejemplo:2019-11-15 12:57:46 +00:00 - linksTipo: integer | null Formato: int64
_count número de backlinks idénticos encontrados en la página de referencia
- originalTipo: boolean | null
indica si el backlink estaba presente en la página de referencia cuando nuestro rastreador la visitó por primera vez
- pageTipo: string | null
_from _encoding codificación de caracteres de la página de referencia
ejemplo:utf-8 - pageTipo: integer | null
_from _external _links número de enlaces externos encontrados en la página de referencia
- pageTipo: integer | null
_from _internal _links número de enlaces internos encontrados en la página de referencia
- pageTipo: string | null
_from _language idioma de la página de referencia
en formato ISO 639-1
ejemplo:en - pageTipo: integer | null
_from _rank - pageTipo: integer | null
_from _size tamaño de la página de referencia, en bytes
ejemplo:63357 - pageTipo: integer | null
_from _status _code código de estado HTTP devuelto por la página de referencia
ejemplo:200 - pageTipo: string | null
_from _title título de la página de referencia
- prevTipo: string | null
_seen fecha anterior a la más reciente en que nuestro rastreador visitó el backlink
en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ejemplo:2019-11-15 12:57:46 +00:00 - rankTipo: integer | null
- semanticTipo: string | null
_location - textTipo: string | null
_post fragmento después del texto de ancla
- textTipo: string | null
_pre fragmento de texto antes del texto de ancla
- tldTipo: string | null
_from dominio de nivel superior de la URL de referencia
- typeTipo: string | null
tipo de elemento
- urlTipo: string | null
_from URL de la página donde se encuentra el backlink
- urlTipo: boolean | null
_from _https indica si la URL de referencia está protegida con HTTPS
si estrue, la URL de referencia está protegida con HTTPS - urlTipo: string | null
_to URL a la que apunta el backlink
- urlTipo: boolean | null
_to _https indica si la URL a la que apunta el backlink está protegida con HTTPS
si estrue, la URL está protegida con HTTPS - urlTipo: string | null
_to _redirect _target URL de destino de la redirección
página de destino a la que apunta la redirección - urlTipo: integer | null
_to _spam _score - urlTipo: integer | null
_to _status _code código de estado de la página referenciada
si el valor esnull, nuestro rastreador aún no ha visitado la página web a la que apunta el enlace
ejemplo:200
- summaryTipo: object | null · Response36Afe1097B20_IntersectionSummaryInfo
contiene el resumen de intersecciones de páginas
- intersectionsTipo: integer | null Formato: int64
_count número total de intersecciones
- itemsTipo: integer | null Formato: int64
_count el número de resultados devueltos en el array
items - targetsTipo: object | null
targetsde un array POST- propertyTipo: string | null
Name
- totalTipo: integer | null Formato: int64
_count cantidad total de resultados relevantes para la solicitud
- resultTipo: integer | null Formato: int64
_count número de elementos en el array de resultados
- statusTipo: integer | null
_code código de estado de la tarea generado por DataForSEO; puede estar dentro del siguiente intervalo: 10000-60000 puedes encontrar la lista completa de los códigos de respuesta aquí
- statusTipo: string | null
_message mensaje informativo de la tarea puedes encontrar la lista completa de los mensajes informativos generales aquí
- timeTipo: string | null
tiempo de ejecución, segundos
- Tipo: integer | null Formato: int64tasks
_count el número de tareas en el array de tareas
- Tipo: integer | null Formato: int64tasks
_error el número de tareas en el array de tareas devueltas con un error
- Tipo: string | nulltime
tiempo total de ejecución, en segundos
- Tipo: string | nullversion
la versión actual de la API
application/json - 400
No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.
- 401
Se requiere una clave de API de Felo válida.
- 402
La solicitud no puede continuar porque no se cumple un requisito de facturación.
- 403
La cuenta no tiene permiso para realizar esta operación.
- 429
Se ha alcanzado un límite de solicitudes o de gasto.
- 502
El servicio no pudo completar la solicitud.
- 503
La API o el servicio de facturación no están disponibles temporalmente.
- 504
El servicio agotó el tiempo de espera al procesar la solicitud.
- default
Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/page_intersection/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"targets": {
"1": "football.com",
"2": "fifa.com"
},
"exclude_targets": [
"skysports.com"
],
"limit": 5,
"order_by": [
"1.rank,desc"
],
"filters": [
[
"2.domain_from_rank",
">",
400
],
"and",
[
"1.dofollow",
"=",
true
]
]
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"targets": null,
"total_count": null,
"items_count": null,
"items": [
{
"page_intersection": null,
"summary": "[Max Depth Exceeded]"
}
]
}
]
}
]
}