DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Dominios de referencia
Los dominios que enlazan a un target, una fila por dominio con domain, rank, backlinks, first_seen, lost_date, backlinks_spam_score, broken_backlinks y broken_pages. Los dominios de referencia importan más que el recuento bruto de enlaces, ya que mil enlaces desde un solo dominio son una sola relación. Para los enlaces individuales, usa post_dataforseo_backlinks_backlinks_live; para agrupar aún más, en operadores de red, usa post_dataforseo_backlinks_referring_networks_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 de tutarget;
valores posibles:all- se devolverán y contarán todos los backlinks;live- se devolverán y contarán los backlinks encontrados durante la última comprobación;lost- se devolverán y contarán los backlinks perdidos;valor predeterminado:
live - excludeTipo: boolean | null
_internal _backlinks indica si se excluyen los backlinks de los subdominios del
target
campo opcional
si se define comofalse, los backlinks de los subdominios deltargetse omitirán y no recibirás el mismo dominio en la respuesta;
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,match,not_match
puedes usar el operador%conlikeynot_likepara coincidir con cualquier cadena de cero o más caracteres
ejemplo:["referring_pages",">","1"][["referring_pages",">","2"],
"and",
["backlinks",">","10"]][["first_seen",">","2017-10-23 11:31:45 +00:00"],
"and",
[["domain","like","%dataforseo.com%"],"or",["referring_domains",">","10"]]]Objeto vacío - includeTipo: boolean | null
_indirect _links indica si se incluirán en los resultados los enlaces indirectos al
target
campo opcional
si se define comotrue, los resultados incluirán datos sobre los enlaces indirectos que apuntan a una página que redirige al 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 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
número máximo de dominios devueltos
campo opcional
valor predeterminado:100
valor máximo:1000 - offsetTipo: integer | null
desplazamiento en el array de resultados de dominios devueltos
campo opcional
valor predeterminado:0
si especificas el valor10, se omitirán los diez primeros dominios del array de resultados 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:["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:["backlinks,desc","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, subdominio o página web para obtener dominios de referencia
campo obligatorio
un dominio o subdominio debe especificarse sinhttps://ywww.
una página debe especificarse con URL absoluta (incluidohttp://ohttps://)
- Tipo: object | null · Response36Afe1097B20_BacklinksReferringDomainsLiveResponseInfo200
- 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_BacklinksReferringDomainsLiveTaskInfo
- 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
- backlinksTipo: integer | null Formato: int64
indica el número de backlinks que apuntan al
target - backlinksTipo: integer | null Formato: int64
_spam _score - brokenTipo: integer | null Formato: int64
_backlinks número de backlinks rotos
número de backlinks rotos que apuntan al dominio - 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 - domainTipo: string | null
dominio de referencia
- 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 backlink de este dominio
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 backlink
en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ejemplo:2017-01-24 13:20:59 +00:00 - rankTipo: integer | null
rank de dominio
volumen de rank que un sitio de referencia transmite altargetrankse 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 - referringTipo: integer | null Formato: int64
_domains indica el número de dominios de referencia
ten en cuenta que calculamos los dominios principales (dominios raíz, comoexample.com) y sus subdominios (p. ej.,blog.example.com) por separado para esta métrica - referringTipo: integer | null Formato: int64
_domains _nofollow número de dominios que apuntan al menos un enlace nofollow al
target - 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 atributos de enlace de los enlaces de referencia
indica los atributos de enlace de los enlaces de referencia y el recuento de enlaces por atributo- propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- referringTipo: object | null
_links _countries códigos de país ISO de los enlaces de referencia
indica los códigos de país ISO de los dominios donde se encuentran los enlaces de referencia y el recuento de enlaces por país- propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- referringTipo: object | null
_links _platform _types tipos de plataformas de referencia
indica los tipos de plataformas de referencia y el recuento de enlaces por plataformavalores posibles:
cms,blogs,ecommerce,message-boards,wikis,news,organization- 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 dominios de nivel superior de los enlaces de referencia
contiene los dominios de nivel superior y el recuento de enlaces de referencia de cada uno- propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- referringTipo: object | null
_links _types tipos de enlaces de referencia
indica los tipos de los enlaces de referencia y el recuento de enlaces por tipo
valores posibles:anchor,image,link,meta,canonical,alternate,redirect- 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
el número de dominios primarios (raíz) que hacen referencia a tu target - referringTipo: integer | null Formato: int64
_main _domains _nofollow número de dominios principales que apuntan al menos un enlace nofollow al
target - referringTipo: integer | null Formato: int64
_pages indica el número de páginas que apuntan al
targetespecificado - referringTipo: integer | null Formato: int64
_pages _nofollow número de páginas de referencia que apuntan al menos un enlace nofollow al
target - referringTipo: integer | null Formato: int64
_subnets número de subredes de referencia
- 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
número total de dominios principales que hacen referencia a tu target;
example.com y blog.example.com se cuentan como un solo dominio de referencia
- 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/referring_domains/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "backlinko.com",
"limit": 5,
"order_by": [
"rank,desc"
],
"exclude_internal_backlinks": true,
"backlinks_filters": [
"dofollow",
"=",
true
],
"filters": [
"backlinks",
">",
100
]
}
]'
{
"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,
"domain": null,
"rank": null,
"backlinks": null,
"first_seen": null,
"lost_date": null,
"backlinks_spam_score": null,
"broken_backlinks": null,
"broken_pages": null,
"referring_domains": null,
"referring_domains_nofollow": null,
"referring_main_domains": null,
"referring_main_domains_nofollow": null,
"referring_ips": null,
"referring_subnets": null,
"referring_pages": null,
"referring_pages_nofollow": null,
"referring_links_tld": null,
"referring_links_types": null,
"referring_links_attributes": null,
"referring_links_platform_types": null,
"referring_links_semantic_locations": null,
"referring_links_countries": null
}
]
}
]
}
]
}