DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Competidores de SERP
Los dominios que se posicionan junto a ti para un conjunto de keywords, con cuántas comparten. Devuelve se_type, seed_keywords, total_count, items_count e items. Envuelto en el sobre de DataForSEO: los datos en tasks[0].result, el resultado en tasks[0].status_code; una solicitud rechazada sigue devolviendo HTTP 200. ⚠️ Son competidores de búsqueda, definidos por posiciones compartidas. El equivalente en el grafo de enlaces es post_dataforseo_backlinks_competitors_live, y las dos listas suelen discrepar, lo cual es informativo en sí mismo.
Referencia de precios
- Medición: Costo de respuesta reportado.
- Estimación de referencia por solicitud: USD 0.0192.
- Multiplicador de referencia del cliente: 1.0. No lo apliques de nuevo 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)[]
- filtersTipo: array (object | null)[] | null
array de parámetros de filtrado de resultados
campo opcional
puedes añadir varios filtros a la vez (máximo 8 filtros)
debes definir un operador lógicoand,orentre las condiciones
se admiten los siguientes operadores:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,match,not_match,ilike,not_ilike,like,not_like
puedes usar el operador%conlikeynot_like, así comoilikeynot_ilike, para coincidir con cualquier cadena de cero o más caracteres
ejemplo:["median_position","in",[1,10]][["median_position","in",[1,10]],"and",["domain","not_like","%wikipedia.org%"]][["domain","not_like","%wikipedia.org%"],
"and",
[["relevant_serp_items",">",0],"or",["median_position","in",[1,10]]]]
para obtener más información sobre los filtros, consulta Dataforseo Labs - Filters o esta guía del Centro de ayudaObjeto vacío - includeTipo: boolean | null
_subdomains indica si los subdominios se incluirán en la búsqueda
campo opcional
si se establece enfalse, los subdominios se ignorarán
valor predeterminado:true - itemTipo: array string[] | null
_types tipo de resultados de búsqueda
indica el tipo de resultados de búsqueda incluidos en la respuesta
campo opcionalvalores posibles:
["organic", "paid", "featured_snippet", "local_pack"]
valor predeterminado:["organic", "paid"] - keywordsTipo: array string[]
array de palabras clave
campo obligatorio
los resultados se basarán en las palabras clave que especifiques en este array
codificación UTF-8;
las palabras clave se convertirán a minúsculas;
puedes especificar un máximo de 200 palabras clavemás información sobre las reglas y limitaciones de los campos
keywordykeywordsen las API de DataForSEO en este artículo del Centro de ayuda - languageTipo: string | null
_code identificador único de idioma
campo obligatorio si no especificaslanguage_name
Nota: es obligatorio especificarlanguage_nameolanguage_code
puedes obtener la lista de idiomas disponibles y sus parámetroslanguage_codehaciendo una solicitud independiente ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ejemplo:en - languageTipo: string
_name nombre completo del idioma
campo obligatorio si no especificaslanguage_code
Nota: es obligatorio especificarlanguage_nameolanguage_code
puedes obtener la lista de idiomas disponibles y sus parámetroslanguage_namehaciendo una solicitud independiente ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ejemplo:English - limitTipo: integer | null
número máximo de dominios devueltos
campo opcional
valor predeterminado:100
valor máximo:1000 - locationTipo: integer
_code identificador único de ubicación
campo obligatorio si no especificaslocation_name
Nota: es obligatorio especificarlocation_nameolocation_code
puedes obtener la lista de ubicaciones disponibles y sus parámetroslocation_codehaciendo una solicitud independiente ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ejemplo:2840 - locationTipo: string
_name nombre completo de la ubicación
campo obligatorio si no especificaslocation_code
Nota: es obligatorio especificarlocation_nameolocation_code
puedes obtener la lista de ubicaciones disponibles y sus parámetroslocation_namehaciendo una solicitud independiente ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ejemplo:United Kingdom - offsetTipo: integer | null
desplazamiento en el array de resultados de dominios devueltos
campo opcional
valor predeterminado:0
si especificas el valor10, los diez primeros dominios del array de resultados se omitirán y los datos se proporcionarán para los dominios 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
la coma se usa como separador
ejemplo:["avg_position,asc"]
regla predeterminada:["rating,desc"]
ten en cuenta que puedes definir como máximo tres reglas de ordenación en una sola solicitud
debes usar una coma para separar varias reglas de ordenación
ejemplo:["avg_position,asc","etv,desc"] - 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
- Tipo: object | null · Response36Afe1097B20_DataforseoLabsGoogleSerpCompetitorsLiveResponseInfo200
- 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_DataforseoLabsGoogleSerpCompetitorsLiveTaskInfo
- 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 competidores de SERP detectados y datos relacionados
- avgTipo: number | null Formato: float
_position la posición media del dominio para las palabras clave especificadas
la media aritmética de los valores del arraykeywords_positions - domainTipo: string | null
nombre de dominio del competidor de SERP detectado
- etvTipo: number | null
volumen de tráfico estimado
representa el tráfico mensual estimado que las palabras clave especificadas generan para el sitio web
se calcula como la suma de los productos de los valores de volumen de búsqueda de las palabras clave especificadas y las tasas de CTR (click-through-rate) en determinadas posiciones de la SERP
obtén más información sobre cómo se calcula la métrica en este artículo del centro de ayuda - keywordsTipo: integer | null Formato: int64
_count el número de palabras clave especificadas para las que el dominio tiene posiciones en las SERP
- keywordsTipo: object | null
_positions posiciones de palabras clave
posiciones en la SERP que el dominio relacionado ocupa en la SERP para las palabras clave especificadas- propertyTipo: array (integer | null)[] | null
Name
- medianTipo: number | null
_position la posición mediana del dominio para las palabras clave especificadas
la mediana de los valores del arraykeywords_positions - ratingTipo: number | null
el margen entre las posiciones de palabras clave máximas posibles y las reales
representa la tasa de visibilidad relativa del dominio en la SERP para las palabras clave especificadas
se calcula como sum(100-keywords_positions) - relevantTipo: integer | null
_serp _items el número de elementos SERP relevantes para el dominio
representa el número de resultados de búsqueda en la SERP relevantes para el dominio para las palabras clave especificadas - seTipo: string | null
_type tipo de motor de búsqueda
- visibilityTipo: number | null
tasa de visibilidad en la SERP
representa la tasa de visibilidad del sitio web según las posiciones en la SERP de las palabras clave especificadas
Las palabras clave con posiciones en el rango de 1 a 10 reciben el índice de visibilidad de 1 a 0,1, respectivamente
Las palabras clave con posiciones en el rango de 11 a 20 tienen el índice de visibilidad fijo de 0,05
las palabras clave con posiciones de 20 a 100 tienen el índice de visibilidad igual a 0
- itemsTipo: integer | null Formato: int64
_count el número de resultados devueltos en el array
items - languageTipo: string | null
_code código de idioma en un array del POST
si no hay datos, el valor es_nulln - locationTipo: integer | null
_code código de ubicación en un array del POST
si no hay datos, el valor es_nulln - seTipo: string | null
_type tipo de motor de búsqueda
- seedTipo: array (string | null)[] | null
_keywords palabras clave especificadas en la solicitud
la palabra clave se devuelve con %## decodificado (el carácter de suma '+' se decodificará como un carácter de espacio) - totalTipo: integer | null Formato: int64
_count la cantidad total de resultados de nuestra base de datos relevantes para tu 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/dataforseo_labs/google/serp_competitors/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keywords": [
"phone"
],
"language_name": "English",
"location_code": 2840,
"item_types": [
"organic"
],
"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": [
{
"se_type": null,
"seed_keywords": [
null
],
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"domain": null,
"avg_position": null,
"median_position": null,
"rating": null,
"etv": null,
"keywords_count": null,
"visibility": null,
"relevant_serp_items": null,
"keywords_positions": null
}
]
}
]
}
]
}