v0.2.0-beta

OpenAPI 3.1.0

Sugerencias de palabras clave

Felo API Support

MIT

Servidor

https://openapi.felo.ai

Bibliotecas cliente

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operaciones

post/v1/beta/dataforseo/dataforseo_labs/google/keyword_suggestions/live

Sugerencias de palabras clave

Variantes de cola larga que contienen una keyword: la vista por coincidencia de frase, mientras que post_dataforseo_labs_google_keyword_ideas_live es la semántica. Devuelve seed_keyword, seed_keyword_data, total_count, offset_token e items. Pagina 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.

Referencia de precios

Medición: Coste de la respuesta notificado.
Estimación de referencia por solicitud: USD 0.132.
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.

Cuerpo

application/json

Tipo: array (object | null)[]
- exact_match
  Tipo: boolean | null
  
  búsqueda de la frase exacta
  campo opcional
  si se establece en true, las palabras clave devueltas incluirán la frase de palabra clave exacta que especificaste, posiblemente con otras palabras antes o después de esa frase
  valor predeterminado: false
- filters
  Tipo: 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ógico and, or entre 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 % con like y not_like, así como ilike y not_ilike, para coincidir con cualquier cadena de cero o más caracteres
  ejemplo:
  ["keyword_info.search_volume",">",0]
  [["keyword_info.search_volume","in",[0,1000]], "and", ["keyword_info.competition_level","=","LOW"]][["keyword_info.search_volume",">",100], "and", [["keyword_info.cpc","<",0.5], "or", ["keyword_info.high_top_of_page_bid","<=",0.5]]]
  para obtener más información sobre los filtros, consulta Dataforseo Labs - Filters o esta guía del Centro de ayuda
  
  Objeto vacío
- ignore_synonyms
  Tipo: boolean | null
  
  ignorar palabras clave muy similares
  campo opcional
  si se establece en true, solo se devolverán las palabras clave principales; todas las palabras clave muy similares se excluirán;
  valor predeterminado: false
- include_clickstream_data
  Tipo: boolean | null
  
  incluir o excluir datos de métricas basadas en clickstream en el resultado
  campo opcional
  si el parámetro se define como true, recibirás los campos clickstream_keyword_info, keyword_info_normalized_with_clickstream y keyword_info_normalized_with_bing en la respuesta
  valor predeterminado: false
  con este parámetro activado, se te cobrará el doble del precio base por la solicitud
  
  obtén más información sobre cómo se calculan las métricas basadas en clickstream en este artículo del Centro de ayuda
- include_seed_keyword
  Tipo: boolean | null
  
  incluir datos de la palabra clave semilla
  campo opcional
  si se define como true, los datos de la palabra clave semilla especificada en el campo keyword se proporcionarán en el array seed_keyword_data de la respuesta
  valor predeterminado: false
- include_serp_info
  Tipo: boolean | null
  
  incluir datos de SERP para cada palabra clave
  campo opcional
  si se define como true, devolveremos un array serp_info que 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
- keyword
  Tipo: string
  
  palabra clave
  campo obligatorio
  codificación UTF-8
  las palabras clave se convertirán a minúsculas;
  
  más información sobre las reglas y limitaciones de los campos keyword y keywords en las API de DataForSEO en este artículo del Centro de ayuda
- language_code
  Tipo: string | null
  
  código de idioma
  campo opcional
  si usas este campo, no necesitas especificar language_name
  puedes obtener la lista de idiomas disponibles y su language_code haciendo una solicitud independiente a
  https://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 campo available_languages.keywords del endpoint Locations and Languages para determinar el idioma predeterminado
- language_name
  Tipo: string | null
  
  nombre completo del idioma
  campo opcional
  si usas este campo, no necesitas especificar language_code
  puedes obtener la lista de idiomas disponibles y su language_name haciendo una solicitud independiente a
  https://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 campo available_languages.keywords del endpoint Locations and Languages para determinar el idioma predeterminado
- limit
  Tipo: integer | null
  
  el número máximo de palabras clave devueltas
  campo opcional
  valor predeterminado: 100
  valor máximo: 1000
- location_code
  Tipo: integer | null
  
  código de ubicación
  campo opcional
  si usas este campo, no necesitas especificar location_name
  puedes obtener la lista de ubicaciones disponibles y su location_code haciendo una solicitud independiente a
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  ignora este campo para obtener los resultados de todas las ubicaciones disponibles
  ejemplo:
  2840
- location_name
  Tipo: string | null
  
  nombre completo de la ubicación
  campo opcional
  si usas este campo, no necesitas especificar location_code
  puedes obtener la lista de ubicaciones disponibles y su location_name haciendo una solicitud independiente a
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  ignora este campo para obtener los resultados de todas las ubicaciones disponibles
  ejemplo:
  United Kingdom
- offset
  Tipo: integer | null
  
  desplazamiento en el array de resultados de palabras clave devueltas
  campo opcional
  valor predeterminado: 0
  si especificas el valor 10, 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, usa offset_token en su lugar.
- offset_token
  Tipo: string | null
  
  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 de offset_token del array de respuesta, obtendrás los resultados posteriores de la tarea inicial;
  los valores de offset_token son únicos para cada tarea posterior
  Nota: si se especifica el offset_token en la solicitud, todos los demás parámetros excepto limit no se tendrán en cuenta al procesar la tarea.
  obtén más información sobre este parámetro en nuestro Centro de ayuda
- order_by
  Tipo: array string[] | null
  
  reglas de ordenación de los resultados
  campo opcional
  puedes usar los mismos valores que en el array filters para ordenar los resultados
  tipos de ordenación posibles:
  asc - los resultados se ordenarán en orden ascendente
  desc - los resultados se ordenarán en orden descendente
  se usa una coma como separador
  ejemplo:
  ["keyword_info.competition,desc"]
  regla predeterminada:
  ["keyword_info.search_volume,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:
  ["keyword_info.search_volume,desc","keyword_info.cpc,desc"]
- tag
  Tipo: 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 de tag especificado en el objeto data de la respuesta

Respuestas

200
Tipo: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordSuggestionsLiveResponseInfo
cost
Tipo: number | null Formato: double

costo total de las tareas, USD

status_code
Tipo: integer | null

código de estado general puedes encontrar la lista completa de los códigos de respuesta aquí

status_message
Tipo: string | null

mensaje informativo general puedes encontrar la lista completa de los mensajes informativos generales aquí

tasks
Tipo: array (object | null)[] | null

array de tareas

Tipo: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordSuggestionsLiveTaskInfo
cost
Tipo: number | null Formato: double

costo total de las tareas, USD

data
Tipo: object | null

contiene los mismos parámetros que especificaste en la solicitud POST

propertyName
Tipo: object | null
id
Tipo: string | null

identificador de la tarea identificador único de la tarea en nuestro sistema en formato UUID

path
Tipo: array (string | null)[] | null

ruta de la URL

result
Tipo: array (object | null)[] | null

array de resultados

items
Tipo: array (object | null)[] | null

contiene palabras clave y datos relacionados

avg_backlinks_info
Tipo: object | null · Response36Afe1097B20_AvgBacklinksInfo

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

backlinks
Tipo: number | null

número medio de backlinks

dofollow
Tipo: number | null

número medio de enlaces dofollow

last_updated_time
Tipo: string | null

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

main_domain_rank
Tipo: number | null

posición media del dominio principal
obtén más información sobre la métrica y su fórmula de cálculo en este artículo del centro de ayuda

rank
Tipo: number | null

rank medio
obtén más información sobre la métrica y su fórmula de cálculo en este artículo del Centro de ayuda

referring_domains
Tipo: number | null

número medio de dominios de referencia

referring_main_domains
Tipo: number | null

número medio de dominios principales de referencia

referring_pages
Tipo: number | null

número medio de páginas de referencia

se_type
Tipo: string | null

tipo de motor de búsqueda

clickstream_keyword_info
Tipo: object | null · Response36Afe1097B20_ClickstreamKeywordInfo

datos de clickstream de la palabra clave devuelta
para obtener resultados de este campo, el parámetro include_clickstream_data debe establecerse en true

age_distribution
Tipo: object | null

distribución de métricas basadas en clickstream por edad
obtén más información sobre cómo se calcula la métrica en este artículo del centro de ayuda

propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

gender_distribution
Tipo: object | null

distribución de métricas estimadas basadas en clickstream por género
obtén más información sobre cómo se calcula la métrica en este artículo del centro de ayuda

propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

last_updated_time
Tipo: string | null

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

monthly_searches
Tipo: array (object | null)[] | null

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

month
Tipo: integer | null

mes

search_volume
Tipo: integer | null

tasa media mensual de volumen de búsqueda

year
Tipo: integer | null

año

search_volume
Tipo: integer | null Formato: int64

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

keyword
Tipo: string | null

idea de palabra clave devuelta

keyword_info
Tipo: object | null · Response36Afe1097B20_KeywordInfo

datos de palabra clave de la idea de palabra clave devuelta

categories
Tipo: array integer[] | null

categorías de productos y servicios
puedes descargar la lista completa de categorías posibles

competition
Tipo: 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)

competition_level
Tipo: string | null

nivel de competencia
representa el nivel relativo de competencia asociado con la palabra clave indicada solo en el SERP de pago;
valores posibles: LOW, MEDIUM, HIGH
si se desconoce el nivel de competencia, el valor es null;
obtén más información sobre la métrica en este artículo del centro de ayuda

cpc
Tipo: number | null

coste por clic
representa el coste medio por clic (USD) pagado históricamente por la palabra clave

high_top_of_page_bid
Tipo: number | null

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

last_updated_time
Tipo: string | null

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

low_top_of_page_bid
Tipo: number | null

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

monthly_searches
Tipo: array (object | null)[] | null

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

month
Tipo: integer | null

mes

search_volume
Tipo: integer | null

tasa media mensual de volumen de búsqueda

year
Tipo: integer | null

año

se_type
Tipo: string | null

tipo de motor de búsqueda

search_volume
Tipo: integer | null Formato: int64

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

search_volume_trend
Tipo: object | null · Response36Afe1097B20_SearchVolumeTrend

cambios en la tendencia del volumen de búsqueda
representa el cambio porcentual del volumen de búsqueda respecto al periodo anterior

monthly
Tipo: integer | null

variación porcentual del volumen de búsqueda respecto al mes anterior

quarterly
Tipo: integer | null

variación porcentual del volumen de búsqueda respecto al trimestre anterior

yearly
Tipo: integer | null

variación porcentual del volumen de búsqueda respecto al año anterior

keyword_info_normalized_with_bing
Tipo: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

contiene el volumen de búsqueda de la palabra clave normalizado con el volumen de búsqueda de Bing

is_normalized
Tipo: boolean | null

la información de palabras clave está normalizada si es verdadero, los valores se normalizan con datos de Bing

last_updated_time
Tipo: string | null

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

monthly_searches
Tipo: array (object | null)[] | null

tasas mensuales de volumen de búsqueda array de objetos con tasas de volumen de búsqueda en un mes concreto del año

month
Tipo: integer | null

mes

search_volume
Tipo: integer | null

tasa media mensual de volumen de búsqueda

year
Tipo: integer | null

año

search_volume
Tipo: integer | null

tasa actual de volumen de búsqueda de una palabra clave

keyword_info_normalized_with_clickstream
Tipo: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

contiene el volumen de búsqueda de la palabra clave normalizado con datos de clickstream

is_normalized
Tipo: boolean | null

la información de palabras clave está normalizada si es verdadero, los valores se normalizan con datos de Bing

last_updated_time
Tipo: string | null

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

monthly_searches
Tipo: array (object | null)[] | null

tasas mensuales de volumen de búsqueda array de objetos con tasas de volumen de búsqueda en un mes concreto del año

month
Tipo: integer | null

mes

search_volume
Tipo: integer | null

tasa media mensual de volumen de búsqueda

year
Tipo: integer | null

año

search_volume
Tipo: integer | null

tasa actual de volumen de búsqueda de una palabra clave

keyword_properties
Tipo: object | null · Response36Afe1097B20_KeywordProperties

información adicional sobre la palabra clave

core_keyword
Tipo: string | null

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 es null, nuestra base de datos no contiene palabras clave que el algoritmo correspondiente pueda identificar como sinónimas de keyword

detected_language
Tipo: string | null

idioma detectado de la palabra clave
indica el idioma de la palabra clave según lo identifica nuestro sistema

is_another_language
Tipo: boolean | null

el idioma detectado de la palabra clave es distinto del idioma establecido
si es true, el idioma establecido en la solicitud no coincide con el idioma determinado por nuestro sistema para una palabra clave

keyword_difficulty
Tipo: integer | null

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

se_type
Tipo: string | null

tipo de motor de búsqueda

synonym_clustering_algorithm
Tipo: string | null

el algoritmo usado para identificar sinónimos
valores posibles:
keyword_metrics - indica el algoritmo basado en parámetros de keyword_info
text_processing - indica el algoritmo basado en texto
si el valor es null, nuestra base de datos no contiene palabras clave que el algoritmo correspondiente pueda identificar como sinónimas de keyword

words_count
Tipo: integer | null Formato: int64

número de palabras de la palabra clave
indica cuántas palabras forman la palabra clave

language_code
Tipo: string | null

código de idioma en un array POST

location_code
Tipo: integer | null

código de ubicación en un array POST

se_type
Tipo: string | null

tipo de motor de búsqueda

search_intent_info
Tipo: object | null · Response36Afe1097B20_SearchIntentInfo

información de intención de búsqueda de la palabra clave devuelta
obtén más información sobre la intención de búsqueda en este artículo del centro de ayuda

foreign_intent
Tipo: array (string | null)[] | null

intenciones de búsqueda complementarias
valores posibles: informational, navigational, commercial, transactional

last_updated_time
Tipo: string | null

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

main_intent
Tipo: string | null

intención de búsqueda principal
valores posibles: informational, navigational, commercial, transactional

se_type
Tipo: string | null

tipo de motor de búsqueda

serp_info
Tipo: object | null · Response36Afe1097B20_SerpInfo

datos del SERP
el valor será null si no estableces el campo include_serp_info en true en el array POST o si no hay datos de SERP para esta palabra clave en nuestra base de datos

check_url
Tipo: string | null

URL directa a los resultados del motor de búsqueda
puedes usarla para asegurarte de que proporcionamos resultados precisos

last_updated_time
Tipo: string | null

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

previous_updated_time
Tipo: string | null

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

se_results_count
Tipo: integer | null Formato: int64

número de resultados de búsqueda para la palabra clave devuelta

se_type
Tipo: string | null

tipo de motor de búsqueda

serp_item_types
Tipo: array (string | null)[] | null

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 elementos organic, paid, featured_snippet y local_pack

items_count
Tipo: integer | null Formato: int64

el número de resultados devueltos en el array items

language_code
Tipo: string | null

código de idioma en un array del POST
si no hay datos, el valor es_nulln

location_code
Tipo: integer | null

código de ubicación en un array del POST
si no hay datos, el valor es_nulln

offset
Tipo: integer | null

valor de desplazamiento actual

offset_token
Tipo: string | null

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 de offset_token son únicos para cada tarea posterior

se_type
Tipo: string | null

tipo de motor de búsqueda

seed_keyword
Tipo: string | null

palabra clave en un array POST

seed_keyword_data
Tipo: object | null · Response36Afe1097B20_KeywordDataInfo

datos de palabras clave para la palabra clave semilla
los campos de este objeto son idénticos a los del array items

avg_backlinks_info
Tipo: object | null · Response36Afe1097B20_AvgBacklinksInfo

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

backlinks
Tipo: number | null

número medio de backlinks

dofollow
Tipo: number | null

número medio de enlaces dofollow

last_updated_time
Tipo: string | null

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

main_domain_rank
Tipo: number | null

posición media del dominio principal
obtén más información sobre la métrica y su fórmula de cálculo en este artículo del centro de ayuda

rank
Tipo: number | null

rank medio
obtén más información sobre la métrica y su fórmula de cálculo en este artículo del Centro de ayuda

referring_domains
Tipo: number | null

número medio de dominios de referencia

referring_main_domains
Tipo: number | null

número medio de dominios principales de referencia

referring_pages
Tipo: number | null

número medio de páginas de referencia

se_type
Tipo: string | null

tipo de motor de búsqueda

clickstream_keyword_info
Tipo: object | null · Response36Afe1097B20_ClickstreamKeywordInfo

datos de clickstream de la palabra clave devuelta
para obtener resultados de este campo, el parámetro include_clickstream_data debe establecerse en true

age_distribution
Tipo: object | null

distribución de métricas basadas en clickstream por edad
obtén más información sobre cómo se calcula la métrica en este artículo del centro de ayuda

propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

gender_distribution
Tipo: object | null

distribución de métricas estimadas basadas en clickstream por género
obtén más información sobre cómo se calcula la métrica en este artículo del centro de ayuda

propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

last_updated_time
Tipo: string | null

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

monthly_searches
Tipo: array (object | null)[] | null

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

month
Tipo: integer | null

mes

search_volume
Tipo: integer | null

tasa media mensual de volumen de búsqueda

year
Tipo: integer | null

año

search_volume
Tipo: integer | null Formato: int64

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

keyword
Tipo: string | null

idea de palabra clave devuelta

keyword_info
Tipo: object | null · Response36Afe1097B20_KeywordInfo

datos de palabra clave de la idea de palabra clave devuelta

categories
Tipo: array integer[] | null

categorías de productos y servicios
puedes descargar la lista completa de categorías posibles

competition
Tipo: 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)

competition_level
Tipo: string | null

nivel de competencia
representa el nivel relativo de competencia asociado con la palabra clave indicada solo en el SERP de pago;
valores posibles: LOW, MEDIUM, HIGH
si se desconoce el nivel de competencia, el valor es null;
obtén más información sobre la métrica en este artículo del centro de ayuda

cpc
Tipo: number | null

coste por clic
representa el coste medio por clic (USD) pagado históricamente por la palabra clave

high_top_of_page_bid
Tipo: number | null

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

last_updated_time
Tipo: string | null

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

low_top_of_page_bid
Tipo: number | null

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

monthly_searches
Tipo: array (object | null)[] | null

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

month
Tipo: integer | null

mes

search_volume
Tipo: integer | null

tasa media mensual de volumen de búsqueda

year
Tipo: integer | null

año

se_type
Tipo: string | null

tipo de motor de búsqueda

search_volume
Tipo: integer | null Formato: int64

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

search_volume_trend
Tipo: object | null · Response36Afe1097B20_SearchVolumeTrend

cambios en la tendencia del volumen de búsqueda
representa el cambio porcentual del volumen de búsqueda respecto al periodo anterior

monthly
Tipo: integer | null

variación porcentual del volumen de búsqueda respecto al mes anterior

quarterly
Tipo: integer | null

variación porcentual del volumen de búsqueda respecto al trimestre anterior

yearly
Tipo: integer | null

variación porcentual del volumen de búsqueda respecto al año anterior

keyword_info_normalized_with_bing
Tipo: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

contiene el volumen de búsqueda de la palabra clave normalizado con el volumen de búsqueda de Bing

is_normalized
Tipo: boolean | null

la información de palabras clave está normalizada si es verdadero, los valores se normalizan con datos de Bing

last_updated_time
Tipo: string | null

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

monthly_searches
Tipo: array (object | null)[] | null

tasas mensuales de volumen de búsqueda array de objetos con tasas de volumen de búsqueda en un mes concreto del año

month
Tipo: integer | null

mes

search_volume
Tipo: integer | null

tasa media mensual de volumen de búsqueda

year
Tipo: integer | null

año

search_volume
Tipo: integer | null

tasa actual de volumen de búsqueda de una palabra clave

keyword_info_normalized_with_clickstream
Tipo: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

contiene el volumen de búsqueda de la palabra clave normalizado con datos de clickstream

is_normalized
Tipo: boolean | null

la información de palabras clave está normalizada si es verdadero, los valores se normalizan con datos de Bing

last_updated_time
Tipo: string | null

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

monthly_searches
Tipo: array (object | null)[] | null

tasas mensuales de volumen de búsqueda array de objetos con tasas de volumen de búsqueda en un mes concreto del año

month
Tipo: integer | null

mes

search_volume
Tipo: integer | null

tasa media mensual de volumen de búsqueda

year
Tipo: integer | null

año

search_volume
Tipo: integer | null

tasa actual de volumen de búsqueda de una palabra clave

keyword_properties
Tipo: object | null · Response36Afe1097B20_KeywordProperties

información adicional sobre la palabra clave

core_keyword
Tipo: string | null

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 es null, nuestra base de datos no contiene palabras clave que el algoritmo correspondiente pueda identificar como sinónimas de keyword

detected_language
Tipo: string | null

idioma detectado de la palabra clave
indica el idioma de la palabra clave según lo identifica nuestro sistema

is_another_language
Tipo: boolean | null

el idioma detectado de la palabra clave es distinto del idioma establecido
si es true, el idioma establecido en la solicitud no coincide con el idioma determinado por nuestro sistema para una palabra clave

keyword_difficulty
Tipo: integer | null

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

se_type
Tipo: string | null

tipo de motor de búsqueda

synonym_clustering_algorithm
Tipo: string | null

el algoritmo usado para identificar sinónimos
valores posibles:
keyword_metrics - indica el algoritmo basado en parámetros de keyword_info
text_processing - indica el algoritmo basado en texto
si el valor es null, nuestra base de datos no contiene palabras clave que el algoritmo correspondiente pueda identificar como sinónimas de keyword

words_count
Tipo: integer | null Formato: int64

número de palabras de la palabra clave
indica cuántas palabras forman la palabra clave

language_code
Tipo: string | null

código de idioma en un array POST

location_code
Tipo: integer | null

código de ubicación en un array POST

se_type
Tipo: string | null

tipo de motor de búsqueda

search_intent_info
Tipo: object | null · Response36Afe1097B20_SearchIntentInfo

información de intención de búsqueda de la palabra clave devuelta
obtén más información sobre la intención de búsqueda en este artículo del centro de ayuda

foreign_intent
Tipo: array (string | null)[] | null

intenciones de búsqueda complementarias
valores posibles: informational, navigational, commercial, transactional

last_updated_time
Tipo: string | null

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

main_intent
Tipo: string | null

intención de búsqueda principal
valores posibles: informational, navigational, commercial, transactional

se_type
Tipo: string | null

tipo de motor de búsqueda

serp_info
Tipo: object | null · Response36Afe1097B20_SerpInfo

datos del SERP
el valor será null si no estableces el campo include_serp_info en true en el array POST o si no hay datos de SERP para esta palabra clave en nuestra base de datos

check_url
Tipo: string | null

URL directa a los resultados del motor de búsqueda
puedes usarla para asegurarte de que proporcionamos resultados precisos

last_updated_time
Tipo: string | null

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

previous_updated_time
Tipo: string | null

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

se_results_count
Tipo: integer | null Formato: int64

número de resultados de búsqueda para la palabra clave devuelta

se_type
Tipo: string | null

tipo de motor de búsqueda

serp_item_types
Tipo: array (string | null)[] | null

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 elementos organic, paid, featured_snippet y local_pack

total_count
Tipo: integer | null Formato: int64

cantidad total de resultados de nuestra base de datos relevantes para tu solicitud

result_count
Tipo: integer | null Formato: int64

número de elementos en el array de resultados

status_code
Tipo: integer | null

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í

status_message
Tipo: string | null

mensaje informativo de la tarea puedes encontrar la lista completa de los mensajes informativos generales aquí

time
Tipo: string | null

tiempo de ejecución, segundos

tasks_count
Tipo: integer | null Formato: int64

el número de tareas en el array de tareas

tasks_error
Tipo: integer | null Formato: int64

el número de tareas en el array de tareas devueltas con un error

time
Tipo: string | null

tiempo total de ejecución, en segundos

version
Tipo: string | null

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

post/v1/beta/dataforseo/dataforseo_labs/google/keyword_suggestions/live

curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/keyword_suggestions/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "phone",
    "location_code": 2840,
    "language_code": "en",
    "include_serp_info": true,
    "include_seed_keyword": true,
    "limit": 1
  }
]'

Mostrar esquema

{
  "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_keyword": null,
          "seed_keyword_data": {
            "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]"
          },
          "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]"
            }
          ]
        }
      ]
    }
  ]
}

Operación correcta

Sugerencias de palabras clave

AutenticaciónRequired

DataForSEO

Sugerencias de palabras clave

Referencia de precios