DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Páginas del dominio
Las páginas de un target que tienen enlaces entrantes, con la visión del rastreador de cada una: main_domain, domain, tld, page, ip, first_visited, prev_visited y fetch_time. Úsalo para descubrir qué páginas realmente consiguen enlaces. Para recuentos de enlaces por página en lugar de metadatos de rastreo, usa post_dataforseo_backlinks_domain_pages_summary_live.
Referencia de precios
- Medición: Coste de la respuesta notificado.
- Estimación de referencia por solicitud: USD 0.0276.
- 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: array (object | null)[] | null
_filters filtra los backlinks de tu
target
campo opcional
puedes usar este campo para filtrar los backlinks iniciales que se incluirán en el conjunto de datos de métricas agregadas de tutarget
puedes filtrar los backlinks por todos los campos disponibles en la respuesta de este endpoint
con este parámetro, puedes incluir solo backlinks dofollow en la respuesta y crear un conjunto de datos de backlinks flexible para calcular las métricas
ejemplo:"backlinks_filters": ["dofollow", "=", true]Objeto vacío - 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;
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 los resultados
valor predeterminado:true - 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:["meta.internal_links_count",">","1"][["meta.external_links_count",">","2"],
"and",
["backlinks",">","10"]][["first_visited",">","2017-10-23 11:31:45 +00:00"],
"and",
[["title","like","%seo%"],"or",["referring_domains",">","10"]]]Objeto vacío - includeTipo: boolean | null
_subdomains indica si los subdominios del
targetse 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:referring_links_tldreferring_links_typesreferring_links_attributesreferring_links_platform_typesreferring_links_semantic_locationsvalor predeterminado:
10
valor máximo:1000 - limitTipo: integer | null
el número máximo de páginas devueltas
campo opcional
valor predeterminado:100
valor máximo:1000 - offsetTipo: integer | null
desplazamiento en el array de resultados de páginas devueltas
campo opcional
valor predeterminado:0
si especificas el valor10, las diez primeras páginas del array de resultados se omitirán y los datos se proporcionarán para las páginas 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:["page_summary.backlinks,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:["page_summary.backlinks,desc","page_summary.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 - targetTipo: string
dominio o subdominio
campo obligatorio
un dominio o subdominio debe especificarse sinhttps://ywww.
ejemplo:forbes.com
- Tipo: object | null · Response36Afe1097B20_BacklinksDomainPagesLiveResponseInfo200
- 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_BacklinksDomainPagesLiveTaskInfo
- 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
array items
- contentTipo: string | null
_encoding tipo de codificación
- domainTipo: string | null
dominio
dominio donde se encontró la página - encodedTipo: integer | null
_size tamaño de la página después de la codificación
indica el tamaño de la página codificada, en bytes - fetchTipo: string | null
_time fecha y hora más recientes en que nuestro rastreador visitó la página
en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ejemplo:2017-01-24 13:20:59 +00:00 - firstTipo: string | null
_visited fecha y hora de la primera visita a la página
fecha y hora en que nuestro rastreador visitó esta página por primera vez
en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ejemplo:2017-01-24 13:20:59 +00:00 - ipTipo: string | null
dirección IP
- locationTipo: string | null
cabecera de ubicación
indica la URL a la que redirigir una página, si existe - mainTipo: string | null
_domain dominio principal del sitio web
el dominio principal del sitio web no incluye subdominios - mediaTipo: string | null
_type tipos de medios usados para mostrar una página
- metaTipo: object | null · Response36Afe1097B20_BacklinksPageMeta
metadatos de la página
- canonicalTipo: string | null
página canónica
- charsetTipo: string | null
codificación de caracteres
ejemplos:utf-8 - externalTipo: integer | null Formato: int64
_links _count número de enlaces externos en la página
- h1Tipo: array (string | null)[] | null
etiqueta h1
contenido de las etiquetash1 - h2Tipo: array (string | null)[] | null
etiqueta h2
contenido de las etiquetash2 - h3Tipo: array (string | null)[] | null
etiqueta h3
contenido de las etiquetash3 - imagesTipo: array (string | null)[] | null
_alt contenido de las etiquetas
alt - imagesTipo: integer | null Formato: int64
_count número de imágenes en la página
- internalTipo: integer | null Formato: int64
_links _count número de enlaces internos en la página
- languageTipo: string | null
idioma del contenido de la página
ejemplo:en - pageTipo: integer | null
_spam _score - platformTipo: array (string | null)[] | null
_type tipo de plataforma
- poweredTipo: array (string | null)[] | null
_by detalles del CMS
- socialTipo: object | null
_media _tags - propertyTipo: string | null
Name
- technologiesTipo: object | null
tecnologías del sitio web
- propertyTipo: string | null
Name
- titleTipo: string | null
título de la página
- wordsTipo: integer | null Formato: int64
_count número de palabras en la página
- pageTipo: string | null
URL de la página
URL de la página relevante - pageTipo: object | null · Response36Afe1097B20_PageSummary
_summary contiene datos de backlinks de esta página
- backlinksTipo: integer | null Formato: int64
indica el número de backlinks
- backlinksTipo: integer | null Formato: int64
_spam _score - brokenTipo: integer | null Formato: int64
_backlinks número de enlaces entrantes rotos
número de enlaces entrantes rotos que apuntan a lapage - brokenTipo: integer | null
_pages número de páginas rotas
número de páginas que responden con códigos de estado 4xx o 5xx a las que apuntan los backlinks - 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 - lostTipo: string | null
_date fecha y hora en que se perdió el último enlace entrante de esta página
indica la fecha y hora en que nuestro rastreador visitó la página y esta respondió con un código de estado 4xx o 5xx, o en que se eliminó el último enlace entrante
en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ejemplo:2017-01-24 13:20:59 +00:00 - rankTipo: integer | null
- referringTipo: integer | null Formato: int64
_domains indica el número de dominios de referencia
- referringTipo: integer | null Formato: int64
_domains _nofollow número de dominios que apuntan al menos un enlace nofollow a la
page - referringTipo: integer | null Formato: int64
_ips número de direcciones IP de referencia
número de direcciones IP que apuntan a esta página - referringTipo: object | null
_links _attributes - propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- referringTipo: object | null
_links _countries - propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- referringTipo: object | null
_links _platform _types - propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- referringTipo: object | null
_links _semantic _locations - propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- referringTipo: object | null
_links _tld - propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- referringTipo: object | null
_links _types - propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- referringTipo: integer | null Formato: int64
_main _domains indica el número de dominios principales de referencia
- referringTipo: integer | null Formato: int64
_main _domains _nofollow Signed 64-bit integers (long type).
- referringTipo: integer | null Formato: int64
_pages indica el número de páginas que apuntan a la
page - referringTipo: integer | null Formato: int64
_pages _nofollow número de páginas de referencia que apuntan al menos un enlace nofollow a la
page - referringTipo: integer | null Formato: int64
_subnets número de subredes de referencia
- prevTipo: string | null
_visited fecha anterior a la más reciente en que nuestro rastreador visitó la página
en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ejemplo:2017-01-24 13:20:59 +00:00 - serverTipo: string | null
versión del servidor
- sizeTipo: integer | null
indica el tamaño de la página, en bytes
- 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 - tldTipo: string | null
- typeTipo: string | null
tipo de elemento
- itemsTipo: integer | null Formato: int64
_count número de elementos del array
items - targetTipo: string | null
targeten un array POST - totalTipo: integer | null Formato: int64
_count número total de elementos relevantes en la base de datos
- 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/domain_pages/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "forbes.com",
"limit": 5,
"filters": [
[
"page_summary.backlinks",
">",
5
],
"and",
[
"page",
"like",
"%sites%"
]
]
}
]'
{
"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": [
{
"target": null,
"total_count": null,
"items_count": null,
"items": [
{
"type": null,
"main_domain": null,
"domain": null,
"tld": null,
"page": null,
"ip": null,
"first_visited": null,
"prev_visited": null,
"fetch_time": null,
"status_code": null,
"location": null,
"size": null,
"encoded_size": null,
"content_encoding": null,
"media_type": null,
"server": null,
"meta": {
"0": "[",
"1": "M",
"2": "a",
"3": "x",
"4": " ",
"5": "D",
"6": "e",
"7": "p",
"8": "t",
"9": "h",
"10": " ",
"11": "E",
"12": "x",
"13": "c",
"14": "e",
"15": "e",
"16": "d",
"17": "e",
"18": "d",
"19": "]",
"social_media_tags": "[Max Depth Exceeded]"
},
"page_summary": {
"0": "[",
"1": "M",
"2": "a",
"3": "x",
"4": " ",
"5": "D",
"6": "e",
"7": "p",
"8": "t",
"9": "h",
"10": " ",
"11": "E",
"12": "x",
"13": "c",
"14": "e",
"15": "e",
"16": "d",
"17": "e",
"18": "d",
"19": "]",
"referring_main_domains_nofollow": "[Max Depth Exceeded]",
"referring_links_tld": "[Max Depth Exceeded]",
"referring_links_types": "[Max Depth Exceeded]",
"referring_links_attributes": "[Max Depth Exceeded]",
"referring_links_platform_types": "[Max Depth Exceeded]",
"referring_links_semantic_locations": "[Max Depth Exceeded]",
"referring_links_countries": "[Max Depth Exceeded]"
}
}
]
}
]
}
]
}