DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Enlaces entrantes
Los enlaces entrantes individuales de un target, una fila por enlace. Devuelve total_count, items_count, items y un search_after_token para paginar: úsalo en lugar de offset después de las primeras páginas. mode y custom_mode controlan la agrupación, y backlinks_status_type selecciona live, lost o all. Para recuentos en lugar de filas, usa post_dataforseo_backlinks_summary_live; para los dominios que enlazan agrupados, post_dataforseo_backlinks_referring_domains_live.
Referencia de precios
- Medición: Coste de la respuesta notificado.
- Estimación de referencia por solicitud: USD 0.06.
- 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 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 - customTipo: object | null
_mode tipo de agrupación detallada de los resultados
campo opcional
usa este objeto para obtener un número concreto de backlinks porfield
si usascustom_mode,modese ignorará
ejemplo:"custom_mode": {"field": "domain", "value": 100}- propertyTipo: object | null
Name
- 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:=,<>,in,not_in,like,not_like,ilike,not_ilike,regex,not_regex,match,not_match
puedes usar el operador%conlikeynot_likepara coincidir con cualquier cadena de cero o más caracteres
ejemplo:["rank",">","80"][["page_from_rank",">","55"],
"and",
["dofollow","=",true]][["first_seen",">","2017-10-23 11:31:45 +00:00"],
"and",
[["anchor","like","%seo%"],"or",["text_pre","like","%seo%"]]]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 - limitTipo: integer | null
el número máximo de backlinks devueltos
campo opcionalvalor predeterminado:
100
valor máximo:1000 - modeTipo: string | null
tipo de agrupación de los resultados
campo opcional
tipos de agrupación posibles:as_is- devuelve todos los backlinksone_per_domain- devuelve un backlink por dominioone_per_anchor- devuelve un backlink por anclavalor predeterminado:
as_is - 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;
Nota: el valor máximo es20,000, usa elsearch_after_tokensi quieres desplazar más resultados - 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
- searchTipo: string | null
_after _token token para solicitudes posteriores
campo opcional
se proporciona en el campo idéntico de la respuesta a cada solicitud;
usa este parámetro para evitar tiempos de espera al intentar obtener más de20,000resultados en una sola solicitud;
al especificar el valor único desearch_after_tokendel array de respuesta, recibirás los resultados posteriores de la tarea inicial;
los valores desearch_after_tokenson únicos para cada tarea posterior ;
Nota: si se especifica elsearch_after_tokenen la solicitud, todos los demás parámetros deben ser idénticos a los de la solicitud anterior - 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 backlinks
campo obligatorio
un dominio o subdominio debe especificarse sinhttps://ywww.
una página debe especificarse con URL absoluta (incluidohttp://ohttps://)
- Tipo: object | null · Response36Afe1097B20_BacklinksBacklinksLiveResponseInfo200
- 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_BacklinksBacklinksLiveTaskInfo
- 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
- customTipo: object | null
_mode modo personalizado especificado en un array POST
- propertyTipo: object | null
Name
- itemsTipo: array (object | null)[] | null
contiene backlinks relevantes y datos de dominios de referencia
- 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 - 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 - imageTipo: string | null
_url URL de la imagen
la URL que conduce a la imagen en el recurso original o en el almacenamiento de DataForSEO (si la fuente original no está disponible) - 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,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
rank de backlink
rank que el backlink dado 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 - rankedTipo: object | null · Response36Afe1097B20_RankedKeywordsInfo
_keywords _info - pageTipo: integer | null Formato: int64
_from _keywords _count _top _10 Signed 64-bit integers (long type).
- pageTipo: integer | null Formato: int64
_from _keywords _count _top _100 Signed 64-bit integers (long type).
- pageTipo: integer | null Formato: int64
_from _keywords _count _top _3 Signed 64-bit integers (long type).
- semanticTipo: string | null
_location - textTipo: string | null
_post fragmento después del texto de ancla
- textTipo: string | null
_pre fragmento 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
- itemsTipo: integer | null Formato: int64
_count el número de resultados devueltos en el array
items - modeTipo: string | null
modo especificado en un array POST
- searchTipo: string | null
_after _token token para solicitudes posteriores
al especificar elsearch_after_tokenúnico al definir una nueva tarea, recibirás los resultados posteriores de la tarea inicial;
los valores desearch_after_tokenson únicos para cada tarea posterior - targetTipo: string | null
dominio de destino en un array POST
- 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/backlinks/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "forbes.com",
"mode": "as_is",
"filters": [
"dofollow",
"=",
true
],
"limit": 5
}
]'
{
"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,
"mode": null,
"custom_mode": null,
"total_count": null,
"items_count": null,
"items": [
{
"type": null,
"domain_from": null,
"url_from": null,
"url_from_https": null,
"domain_to": null,
"url_to": null,
"url_to_https": null,
"tld_from": null,
"is_new": null,
"is_lost": null,
"backlink_spam_score": null,
"rank": null,
"page_from_rank": null,
"domain_from_rank": null,
"domain_from_platform_type": [
"[Max Depth Exceeded]"
],
"domain_from_is_ip": null,
"domain_from_ip": null,
"domain_from_country": null,
"page_from_external_links": null,
"page_from_internal_links": null,
"page_from_size": null,
"page_from_encoding": null,
"page_from_language": null,
"page_from_title": null,
"page_from_status_code": null,
"first_seen": null,
"prev_seen": null,
"last_seen": null,
"item_type": null,
"attributes": [
"[Max Depth Exceeded]"
],
"dofollow": null,
"original": null,
"alt": null,
"image_url": null,
"anchor": null,
"text_pre": null,
"text_post": null,
"semantic_location": null,
"links_count": null,
"group_count": null,
"is_broken": null,
"url_to_status_code": null,
"url_to_spam_score": null,
"url_to_redirect_target": null,
"ranked_keywords_info": "[Max Depth Exceeded]",
"is_indirect_link": null,
"indirect_link_path": [
"[Max Depth Exceeded]"
]
}
],
"search_after_token": null
}
]
}
]
}