DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Palabras clave para sitio
Las palabras clave por las que se posiciona un sitio target. Devuelve se_type, target, total_count, offset_token e items. Paginado con limit, offset y offset_token; usa el token después de las primeras páginas. 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. Es la misma pregunta, paginada y a un séptimo del precio.
Referencia de precios
- Medición: Costo de respuesta reportado.
- Estimación de referencia por solicitud: USD 0.132.
- 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
ten en cuenta que no puedes filtrar los resultados porrelevance
ejemplo:["keyword_info.search_volume",">",0]
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
_clickstream _data incluir o excluir datos de métricas basadas en clickstream en el resultado
campo opcional
si el parámetro se establece entrue, recibirás los camposclickstream_keyword_info,keyword_info_normalized_with_clickstreamykeyword_info_normalized_with_bingen la respuesta
valor predeterminado:false
con este parámetro habilitado, se te cobrará el doble del precio por la solicitudmás información sobre cómo se calculan las métricas basadas en clickstream en este artículo del Centro de ayuda
- includeTipo: boolean | null
_serp _info incluir datos de SERP para cada palabra clave
campo opcional
si se define comotrue, devolveremos un arrayserp_infoque contiene datos de SERP (número de resultados de búsqueda, URL relevante y funciones de SERP) para cada palabra clave de la respuesta
valor predeterminado:false - 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 - languageTipo: string | null
_code código de idioma
campo opcional
si usas este campo, no necesitas especificarlanguage_name
puedes obtener la lista de idiomas disponibles y sulanguage_codehaciendo una solicitud independiente ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ejemplo:en
Nota: si se omite, los resultados usan de forma predeterminada el idioma con más registros de palabras clave en la ubicación especificada;
consulta el campoavailable_languages.keywordsdel endpoint Locations and Languages para determinar el idioma predeterminado - languageTipo: string | null
_name nombre completo del idioma
campo opcional
si usas este campo, no necesitas especificarlanguage_code
puedes obtener la lista de idiomas disponibles y sulanguage_namehaciendo una solicitud independiente ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ejemplo:English
Nota: si se omite, los resultados usan de forma predeterminada el idioma con más registros de palabras clave en la ubicación especificada;
consulta el campoavailable_languages.keywordsdel endpoint Locations and Languages para determinar el idioma predeterminado - limitTipo: integer | null
el número máximo de palabras clave en el array de resultados
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 sulocation_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 sulocation_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 palabras clave devueltas
campo opcional
valor predeterminado:0
si especificas el valor10, las diez primeras palabras clave del array de resultados se omitirán y los datos se proporcionarán para las palabras clave siguientes
Nota: recomendamos usar este parámetro solo al recuperar hasta 10.000 resultados
para recuperar más de 10.000 resultados, usaoffset_tokenen su lugar. - offsetTipo: string | null
_token token de desplazamiento 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 de 10.000 resultados en una sola solicitud;
al especificar el valor único deoffset_tokendel array de respuesta, obtendrás los resultados posteriores de la tarea inicial;
los valores deoffset_tokenson únicos para cada tarea posterior
Nota: si se especifica eloffset_tokenen la solicitud, todos los demás parámetros exceptolimitno se tendrán en cuenta al procesar la tarea.
obtén más información sobre este parámetro en nuestro Centro de ayuda - 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
debes usar una coma para definir un parámetro de ordenaciónregla predeterminada:
["relevance,desc"]
relevance se usa como regla de ordenación predeterminada para ofrecerte las ideas de palabras clave más cercanas. Recomendamos usar esta regla para obtener términos de búsqueda altamente relevantes. Ten en cuenta querelevancees solo nuestro identificador interno del sistema, por lo que no se puede usar como filtro y no encontrarás este campo en el arrayresult. La puntuación de relevance se basa en un principio similar al usado en el endpoint Keywords For Keywords.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:["relevance,desc","keyword_info.search_volume,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 - targetTipo: string
nombre de dominio o URL de la página
campo obligatorio
el nombre de dominio del sitio web de destino, el subdominio o la URL de la página web de destino;
el nombre de dominio debe especificarse sinhttps://niwww.;
el subdominio debe especificarse sinhttps://;
la URL de la página web debe especificarse conhttps://owww.
Nota: si especificas la URL de la página web sinhttps://niwww., el resultado se devolverá para el dominio completo en lugar de la página específica
- Tipo: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordsForSiteLiveResponseInfo200
- 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_DataforseoLabsGoogleKeywordsForSiteLiveTaskInfo
- 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 ideas de palabras clave y datos relacionados
- avgTipo: object | null · Response36Afe1097B20_AvgBacklinksInfo
_backlinks _info datos de backlinks de la palabra clave devuelta
este objeto proporciona el número medio de backlinks, páginas de referencia y dominios, así como los valores medios de clasificación entre las 10 páginas principales que se posicionan de forma orgánica para la palabra clave- backlinksTipo: number | null
número medio de backlinks
- dofollowTipo: number | null
número medio de enlaces dofollow
- lastTipo: string | null
_updated _time fecha y hora en que se actualizaron los datos de la palabra clave
en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ejemplo:2019-11-15 12:57:46 +00:00 - mainTipo: number | null
_domain _rank - rankTipo: number | null
- referringTipo: number | null
_domains número medio de dominios de referencia
- referringTipo: number | null
_main _domains número medio de dominios principales de referencia
- referringTipo: number | null
_pages número medio de páginas de referencia
- seTipo: string | null
_type tipo de motor de búsqueda
- clickstreamTipo: object | null · Response36Afe1097B20_ClickstreamKeywordInfo
_keyword _info datos de clickstream de la palabra clave devuelta
para obtener resultados de este campo, el parámetroinclude_clickstream_datadebe establecerse entrue- ageTipo: object | null
_distribution - propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- genderTipo: object | null
_distribution - propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- lastTipo: string | null
_updated _time fecha y hora en que se actualizaron los datos de la palabra clave
en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ejemplo:2019-11-15 12:57:46 +00:00 - monthlyTipo: array (object | null)[] | null
_searches búsquedas mensuales
representa el número (aproximado) de búsquedas de esta idea de palabra clave (según lo disponible en los últimos doce meses), dirigidas a las ubicaciones geográficas especificadas- monthTipo: integer | null
mes
- searchTipo: integer | null
_volume tasa media mensual de volumen de búsqueda
- yearTipo: integer | null
año
- searchTipo: integer | null Formato: int64
_volume tasa media de volumen de búsqueda mensual
representa el número (aproximado) de búsquedas de la idea de palabra clave dada en google.com
- keywordTipo: string | null
idea de palabra clave devuelta
- keywordTipo: object | null · Response36Afe1097B20_KeywordInfo
_info datos de palabra clave de la idea de palabra clave devuelta
- categoriesTipo: array integer[] | null
- competitionTipo: number | null
competencia
representa la cantidad relativa de competencia asociada con la palabra clave indicada. Este valor se basa en datos de Google Ads y puede estar entre 0 y 1 (inclusive) - competitionTipo: string | null
_level - cpcTipo: number | null
coste por clic
representa el coste medio por clic (USD) pagado históricamente por la palabra clave - highTipo: number | null
_top _of _page _bid puja máxima para que el anuncio se muestre en la parte superior de la primera página
indica el valor superior a aproximadamente el 80 % de las pujas más bajas por las que se mostraron anuncios (según las estadísticas de Google Ads para anunciantes)
el valor puede variar según la ubicación indicada en una solicitud POST - lastTipo: string | null
_updated _time fecha y hora en que se actualizaron los datos de la palabra clave
en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ejemplo:2019-11-15 12:57:46 +00:00 - lowTipo: number | null
_top _of _page _bid puja mínima para que el anuncio se muestre en la parte superior de la primera página
indica el valor superior a aproximadamente el 20 % de las pujas más bajas por las que se mostraron anuncios (según las estadísticas de Google Ads para anunciantes)
el valor puede variar según la ubicación indicada en una solicitud POST - monthlyTipo: array (object | null)[] | null
_searches búsquedas mensuales
representa el número (aproximado) de búsquedas de esta idea de palabra clave (según lo disponible en los últimos doce meses), dirigidas a las ubicaciones geográficas especificadas- monthTipo: integer | null
mes
- searchTipo: integer | null
_volume tasa media mensual de volumen de búsqueda
- yearTipo: integer | null
año
- seTipo: string | null
_type tipo de motor de búsqueda
- searchTipo: integer | null Formato: int64
_volume tasa media de volumen de búsqueda mensual
representa el número (aproximado) de búsquedas de la idea de palabra clave dada en google.com - searchTipo: object | null · Response36Afe1097B20_SearchVolumeTrend
_volume _trend cambios en la tendencia del volumen de búsqueda
representa el cambio porcentual del volumen de búsqueda respecto al periodo anterior- monthlyTipo: integer | null
variación porcentual del volumen de búsqueda respecto al mes anterior
- quarterlyTipo: integer | null
variación porcentual del volumen de búsqueda respecto al trimestre anterior
- yearlyTipo: integer | null
variación porcentual del volumen de búsqueda respecto al año anterior
- keywordTipo: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _bing contiene el volumen de búsqueda de la palabra clave normalizado con el volumen de búsqueda de Bing
- isTipo: boolean | null
_normalized la información de palabras clave está normalizada si es verdadero, los valores se normalizan con datos de Bing
- lastTipo: string | null
_updated _time fecha y hora en que se actualizó el conjunto de datos en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” ejemplo: 2019-11-15 12:57:46 +00:00
- monthlyTipo: array (object | null)[] | null
_searches tasas mensuales de volumen de búsqueda array de objetos con tasas de volumen de búsqueda en un mes concreto del año
- monthTipo: integer | null
mes
- searchTipo: integer | null
_volume tasa media mensual de volumen de búsqueda
- yearTipo: integer | null
año
- searchTipo: integer | null
_volume tasa actual de volumen de búsqueda de una palabra clave
- keywordTipo: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _clickstream contiene el volumen de búsqueda de la palabra clave normalizado con datos de clickstream
- isTipo: boolean | null
_normalized la información de palabras clave está normalizada si es verdadero, los valores se normalizan con datos de Bing
- lastTipo: string | null
_updated _time fecha y hora en que se actualizó el conjunto de datos en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” ejemplo: 2019-11-15 12:57:46 +00:00
- monthlyTipo: array (object | null)[] | null
_searches tasas mensuales de volumen de búsqueda array de objetos con tasas de volumen de búsqueda en un mes concreto del año
- monthTipo: integer | null
mes
- searchTipo: integer | null
_volume tasa media mensual de volumen de búsqueda
- yearTipo: integer | null
año
- searchTipo: integer | null
_volume tasa actual de volumen de búsqueda de una palabra clave
- keywordTipo: object | null · Response36Afe1097B20_KeywordProperties
_properties información adicional sobre la palabra clave
- coreTipo: string | null
_keyword palabra clave principal de un grupo
contiene la palabra clave principal de un grupo determinada por el algoritmo de agrupación de sinónimos
si el valor esnull, nuestra base de datos no contiene palabras clave que el algoritmo correspondiente pueda identificar como sinónimas dekeyword - detectedTipo: string | null
_language idioma detectado de la palabra clave
indica el idioma de la palabra clave según lo identifica nuestro sistema - isTipo: boolean | null
_another _language el idioma detectado de la palabra clave es distinto del idioma establecido
si estrue, el idioma establecido en la solicitud no coincide con el idioma determinado por nuestro sistema para una palabra clave - keywordTipo: integer | null
_difficulty dificultad de posicionarse entre los 10 primeros resultados orgánicos para una palabra clave
indica la probabilidad de entrar en los 10 primeros resultados orgánicos para una palabra clave en una escala logarítmica de 0 a 100;
se calcula analizando, entre otros parámetros, los perfiles de enlaces de las 10 primeras páginas del SERP;
obtén más información sobre la métrica en esta guía del centro de ayuda - seTipo: string | null
_type tipo de motor de búsqueda
- synonymTipo: string | null
_clustering _algorithm el algoritmo usado para identificar sinónimos
valores posibles:keyword_metrics- indica el algoritmo basado en parámetros dekeyword_infotext_processing- indica el algoritmo basado en texto
si el valor esnull, nuestra base de datos no contiene palabras clave que el algoritmo correspondiente pueda identificar como sinónimas dekeyword - wordsTipo: integer | null Formato: int64
_count número de palabras de la palabra clave
indica cuántas palabras forman la palabra clave
- languageTipo: string | null
_code código de idioma en un array POST
- locationTipo: integer | null
_code código de ubicación en un array POST
- seTipo: string | null
_type tipo de motor de búsqueda
- searchTipo: object | null · Response36Afe1097B20_SearchIntentInfo
_intent _info - foreignTipo: array (string | null)[] | null
_intent intenciones de búsqueda complementarias
valores posibles:informational,navigational,commercial,transactional - lastTipo: string | null
_updated _time fecha y hora en que se actualizaron los datos de la palabra clave
en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ejemplo:2019-11-15 12:57:46 +00:00 - mainTipo: string | null
_intent intención de búsqueda principal
valores posibles:informational,navigational,commercial,transactional - seTipo: string | null
_type tipo de motor de búsqueda
- serpTipo: object | null · Response36Afe1097B20_SerpInfo
_info datos del SERP
el valor seránullsi no estableces el campoinclude_serp_infoentrueen el array POST o si no hay datos de SERP para esta palabra clave en nuestra base de datos- checkTipo: string | null
_url URL directa a los resultados del motor de búsqueda
puedes usarla para asegurarte de que proporcionamos resultados precisos - lastTipo: string | null
_updated _time fecha y hora en que se actualizaron los datos de la palabra clave
en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ejemplo:2019-11-15 12:57:46 +00:00 - previousTipo: string | null
_updated _time fecha y hora anterior a la más reciente en que se actualizaron los datos del SERP
en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ejemplo:2019-10-15 12:57:46 +00:00 - seTipo: integer | null Formato: int64
_results _count número de resultados de búsqueda para la palabra clave devuelta
- seTipo: string | null
_type tipo de motor de búsqueda
- serpTipo: array (string | null)[] | null
_item _types tipos de resultados de búsqueda en el SERP
contiene los tipos de resultados de búsqueda (items) encontrados en el SERP
tipos de elementos posibles:answer_box,app,carousel,multi_carousel,featured_snippet,google_flights,google_reviews,third_party_reviews,google_posts,images,jobs,knowledge_graph,local_pack,hotels_pack,map,organic,paid,people_also_ask,related_searches,people_also_search,shopping,top_stories,twitter,video,events,mention_carousel,recipes,top_sights,scholarly_articles,popular_products,podcasts,questions_and_answers,find_results_on,stocks_box,visual_stories,commercial_units,local_services,google_hotels,math_solver,currency_box,product_considerations,found_on_web,short_videos,refine_products,explore_brands,perspectives,discussions_and_forums,compare_sites,courses,ai_overview;
nota: los resultados reales solo se devolverán para los elementosorganic,paid,featured_snippetylocal_pack
- 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 POST
- locationTipo: integer | null
_code código de ubicación en un array POST
- offsetTipo: integer | null
valor de desplazamiento actual
- offsetTipo: string | null
_token token de desplazamiento para solicitudes posteriores
puedes usar la cadena proporcionada en este campo para obtener los resultados posteriores de la tarea inicial;
nota: los valores deoffset_tokenson únicos para cada tarea posterior - seTipo: string | null
_type tipo de motor de búsqueda
- targetTipo: string | null
dominio de destino en un array POST
- totalTipo: integer | null Formato: int64
_count número 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/keywords_for_site/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "apple.com",
"language_code": "en",
"location_code": 2840,
"include_serp_info": true,
"include_subdomains": true,
"filters": [
"serp_info.se_results_count",
">",
0
],
"limit": 3
}
]'
{
"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,
"target": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"offset": null,
"offset_token": null,
"items": [
{
"se_type": null,
"keyword": null,
"location_code": null,
"language_code": null,
"keyword_info": "[Max Depth Exceeded]",
"keyword_info_normalized_with_bing": "[Max Depth Exceeded]",
"keyword_info_normalized_with_clickstream": "[Max Depth Exceeded]",
"clickstream_keyword_info": "[Max Depth Exceeded]",
"keyword_properties": "[Max Depth Exceeded]",
"serp_info": "[Max Depth Exceeded]",
"avg_backlinks_info": "[Max Depth Exceeded]",
"search_intent_info": "[Max Depth Exceeded]"
}
]
}
]
}
]
}