DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Ideias de palavras-chave
Expande keywords semente em ideias que compartilham seu espaço semântico. Retorna seed_keywords, total_count, items_count, offset, offset_token e items. Pagina com limit, offset e offset_token; use o token depois das primeiras páginas. Encapsulado no envelope do DataForSEO: dados em tasks[0].result, resultado em tasks[0].status_code — uma requisição rejeitada ainda retorna HTTP 200. Prefira este. Para variantes de uma frase em vez do espaço mais amplo, post_dataforseo_labs_google_keyword_suggestions_live.
Referência de preços
- Medição: Custo da resposta reportado.
- Estimativa de referência por requisição: USD 0.132.
- Multiplicador de referência do cliente: 1.0. Não o aplique novamente a um valor de cliente já liquidado.
Apenas metadados de referência, não uma cotação da conta, um preço garantido ou um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da Felo.
- Tipo: array (object | null)[]
- closelyTipo: boolean | null
_variants modo de pesquisa
campo opcional
se definido comotrue, os resultados serão baseados no algoritmo de pesquisa por correspondência de frase
se definido comofalse, os resultados serão baseados no algoritmo de pesquisa por correspondência ampla
valor padrão:false - filtersTipo: array (object | null)[] | null
array de parâmetros de filtragem de resultados
campo opcional
você pode adicionar vários filtros de uma vez (máximo de 8 filtros)
você deve definir um operador lógicoand,orentre as condições
os seguintes operadores são suportados:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,match,not_match,ilike,not_ilike,like,not_like
você pode usar o operador%comlikeenot_like, bem comoilikeenot_ilike, para corresponder a qualquer string de zero ou mais caracteres
observe que você não pode filtrar os resultados porrelevance
exemplo:["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 mais informações sobre filtros, consulte Dataforseo Labs - Filters ou este guia da Central de AjudaObjeto vazio - ignoreTipo: boolean | null
_synonyms ignora palavras-chave altamente semelhantes
campo opcional
se definido comotrue, apenas palavras-chave principais serão retornadas e todas as palavras-chave altamente semelhantes serão excluídas;
valor padrão:false - includeTipo: boolean | null
_clickstream _data inclui ou exclui dados de métricas baseadas em clickstream no resultado
campo opcional
se o parâmetro for definido comotrue, você receberá os camposclickstream_keyword_info,keyword_info_normalized_with_clickstreamekeyword_info_normalized_with_bingna resposta
valor padrão:false
com este parâmetro ativado, você será cobrado em dobro pelo preço da requisiçãosaiba mais sobre como as métricas baseadas em clickstream são calculadas neste artigo da Central de Ajuda
- includeTipo: boolean | null
_serp _info inclui dados de SERP para cada palavra-chave
campo opcional
se definido comotrue, retornaremos um arrayserp_infocontendo dados de SERP (número de resultados de pesquisa, URL relevante e recursos de SERP) para cada palavra-chave na resposta
valor padrão:false - keywordsTipo: array string[]
- languageTipo: string | null
_code código do idioma
campo opcional
se você usar este campo, não precisa especificarlanguage_name
você pode obter a lista de idiomas disponíveis e seuslanguage_codefazendo uma requisição separada parahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
exemplo:en
Observação: se omitido, os resultados usam por padrão o idioma com mais registros de palavras-chave na localização especificada;
consulte o campoavailable_languages.keywordsdo endpoint Locations and Languages para determinar o idioma padrão - languageTipo: string | null
_name nome completo do idioma
campo opcional
se você usar este campo, não precisa especificarlanguage_code
você pode obter a lista de idiomas disponíveis e seuslanguage_namefazendo uma requisição separada parahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
exemplo:English
Observação: se omitido, os resultados usam por padrão o idioma com mais registros de palavras-chave na localização especificada;
consulte o campoavailable_languages.keywordsdo endpoint Locations and Languages para determinar o idioma padrão - limitTipo: integer | null
o número máximo de palavras-chave no array de resultados
campo opcional
valor padrão:700
valor máximo:1000 - locationTipo: integer
_code identificador exclusivo do local
campo obrigatório se você não especificarlocation_name
Observação: é obrigatório especificarlocation_nameoulocation_code
você pode obter a lista de locais disponíveis e seuslocation_codefazendo uma requisição separada para ohttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
exemplo:2840 - locationTipo: string
_name nome completo do local
campo obrigatório se você não especificarlocation_code
Observação: é obrigatório especificarlocation_nameoulocation_code
você pode obter a lista de locais disponíveis e seuslocation_namefazendo uma requisição separada parahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
exemplo:United Kingdom - offsetTipo: integer | null
deslocamento no array de resultados de palavras-chave retornadas
campo opcional
valor padrão:0
se você especificar o valor10, as dez primeiras palavras-chave no array de resultados serão omitidas e os dados serão fornecidos para as palavras-chave seguintes
Observação: recomendamos usar este parâmetro apenas ao recuperar até 10.000 resultados
para recuperar mais de 10.000 resultados, use ooffset_token. - offsetTipo: string | null
_token token de deslocamento para requisições subsequentes
campo opcional
fornecido no campo idêntico da resposta a cada requisição;
use este parâmetro para evitar timeouts ao tentar obter mais de 10.000 resultados em uma única requisição;
ao especificar o valor exclusivo deoffset_tokendo array de resposta, você obterá os resultados subsequentes da tarefa inicial;
os valores deoffset_tokensão exclusivos para cada tarefa subsequente
Observação: se ooffset_tokenfor especificado na requisição, todos os outros parâmetros, excetolimit, não serão considerados ao processar a tarefa.
saiba mais sobre este parâmetro na nossa Central de Ajuda - orderTipo: array string[] | null
_by regras de ordenação dos resultados
campo opcional
você pode usar os mesmos valores do arrayfilterspara ordenar os resultados
tipos de ordenação possíveis:asc- os resultados serão ordenados em ordem crescentedesc- os resultados serão ordenados em ordem decrescente
você deve usar uma vírgula para definir um parâmetro de ordenaçãoregra padrão:
["relevance,desc"]
relevance é usado como regra de ordenação padrão para fornecer as ideias de palavras-chave mais próximas. Recomendamos usar esta regra para obter termos de pesquisa altamente relevantes. Observe querelevanceé apenas nosso identificador interno do sistema, então não pode ser usado como filtro, e você não encontrará este campo no arrayresult. A pontuação de relevance é baseada em um princípio semelhante ao usado no endpoint Keywords For Keywords.observe que você pode definir no máximo três regras de ordenação em uma única requisição
você deve usar uma vírgula para separar várias regras de ordenação
exemplo:["relevance,desc","keyword_info.search_volume,desc"] - tagTipo: string | null
identificador de tarefa definido pelo usuário
campo opcional
o limite de caracteres é 255
você pode usar este parâmetro para identificar a tarefa e associá-la ao resultado
você encontrará o valor detagespecificado no objetodatada resposta
- Tipo: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordIdeasLiveResponseInfo200
- Tipo: number | null Formato: doublecost
custo total das tarefas, USD
- Tipo: integer | nullstatus
_code código de status geral você pode encontrar a lista completa dos códigos de resposta aqui
- Tipo: string | nullstatus
_message mensagem informativa geral você pode encontrar a lista completa das mensagens informativas gerais aqui
- Tipo: array (object | null)[] | nulltasks
array de tarefas
- Tipo: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordIdeasLiveTaskInfo
- costTipo: number | null Formato: double
custo total das tarefas, USD
- dataTipo: object | null
contém os mesmos parâmetros que você especificou na requisição POST
- propertyTipo: object | null
Name
- idTipo: string | null
identificador da tarefa identificador exclusivo da tarefa em nosso sistema no formato UUID
- pathTipo: array (string | null)[] | null
caminho da URL
- resultTipo: array (object | null)[] | null
array de resultados
- itemsTipo: array (object | null)[] | null
contém ideias de palavras-chave e dados relacionados
- avgTipo: object | null · Response36Afe1097B20_AvgBacklinksInfo
_backlinks _info dados de backlinks da palavra-chave retornada
este objeto fornece o número médio de backlinks, páginas de referência e domínios, bem como os valores médios de classificação entre as 10 principais páginas que se classificam organicamente para a palavra-chave- backlinksTipo: number | null
número médio de backlinks
- dofollowTipo: number | null
número médio de links dofollow
- lastTipo: string | null
_updated _time data e hora de atualização dos dados da palavra-chave
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
exemplo:2019-11-15 12:57:46 +00:00 - mainTipo: number | null
_domain _rank - rankTipo: number | null
- referringTipo: number | null
_domains número médio de domínios de referência
- referringTipo: number | null
_main _domains número médio de domínios principais de referência
- referringTipo: number | null
_pages número médio de páginas de referência
- seTipo: string | null
_type tipo de mecanismo de busca
- clickstreamTipo: object | null · Response36Afe1097B20_ClickstreamKeywordInfo
_keyword _info dados de clickstream da palavra-chave retornada
para recuperar resultados deste campo, o parâmetroinclude_clickstream_datadeve ser definido comotrue- 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 data e hora de atualização dos dados da palavra-chave
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
exemplo:2019-11-15 12:57:46 +00:00 - monthlyTipo: array (object | null)[] | null
_searches pesquisas mensais
representa o número (aproximado) de pesquisas dessa ideia de palavra-chave (conforme disponível nos últimos doze meses), direcionadas aos locais geográficos especificados- monthTipo: integer | null
mês
- searchTipo: integer | null
_volume taxa média mensal de volume de pesquisa
- yearTipo: integer | null
ano
- searchTipo: integer | null Formato: int64
_volume taxa média de volume de pesquisa mensal
representa o número (aproximado) de pesquisas para a ideia de palavra-chave fornecida no google.com
- keywordTipo: string | null
ideia de palavra-chave retornada
- keywordTipo: object | null · Response36Afe1097B20_KeywordInfo
_info dados de palavra-chave da ideia de palavra-chave retornada
- categoriesTipo: array integer[] | null
- competitionTipo: number | null
concorrência
representa a quantidade relativa de concorrência associada à palavra-chave especificada. Esse valor é baseado em dados do Google Ads e pode estar entre 0 e 1 (inclusive) - competitionTipo: string | null
_level - cpcTipo: number | null
custo por clique
representa o custo médio por clique (USD) pago historicamente pela palavra-chave - highTipo: number | null
_top _of _page _bid lance máximo para o anúncio ser exibido no topo da primeira página
indica o valor superior a cerca de 80% dos lances mais baixos para os quais os anúncios foram exibidos (com base nas estatísticas do Google Ads para anunciantes)
o valor pode variar dependendo da localização especificada em uma requisição POST - lastTipo: string | null
_updated _time data e hora de atualização dos dados da palavra-chave
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
exemplo:2019-11-15 12:57:46 +00:00 - lowTipo: number | null
_top _of _page _bid lance mínimo para o anúncio ser exibido no topo da primeira página
indica o valor superior a cerca de 20% dos lances mais baixos para os quais os anúncios foram exibidos (com base nas estatísticas do Google Ads para anunciantes)
o valor pode variar dependendo da localização especificada em uma requisição POST - monthlyTipo: array (object | null)[] | null
_searches pesquisas mensais
representa o número (aproximado) de pesquisas dessa ideia de palavra-chave (conforme disponível nos últimos doze meses), direcionadas aos locais geográficos especificados- monthTipo: integer | null
mês
- searchTipo: integer | null
_volume taxa média mensal de volume de pesquisa
- yearTipo: integer | null
ano
- seTipo: string | null
_type tipo de mecanismo de busca
- searchTipo: integer | null Formato: int64
_volume taxa média de volume de pesquisa mensal
representa o número (aproximado) de pesquisas para a ideia de palavra-chave fornecida no google.com - searchTipo: object | null · Response36Afe1097B20_SearchVolumeTrend
_volume _trend variações da tendência do volume de pesquisa
representa a variação percentual do volume de pesquisa em relação ao período anterior- monthlyTipo: integer | null
variação percentual do volume de pesquisa em relação ao mês anterior
- quarterlyTipo: integer | null
variação percentual do volume de pesquisa em relação ao trimestre anterior
- yearlyTipo: integer | null
variação percentual do volume de pesquisa em relação ao ano anterior
- keywordTipo: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _bing contém o volume de pesquisa da palavra-chave normalizado pelo volume de pesquisa do Bing
- isTipo: boolean | null
_normalized as informações de palavra-chave são normalizadas se verdadeiro, os valores são normalizados com dados do Bing
- lastTipo: string | null
_updated _time data e hora em que o conjunto de dados foi atualizado no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” exemplo: 2019-11-15 12:57:46 +00:00
- monthlyTipo: array (object | null)[] | null
_searches taxas mensais de volume de pesquisa array de objetos com taxas de volume de pesquisa em um determinado mês de um ano
- monthTipo: integer | null
mês
- searchTipo: integer | null
_volume taxa média mensal de volume de pesquisa
- yearTipo: integer | null
ano
- searchTipo: integer | null
_volume taxa atual de volume de pesquisa de uma palavra-chave
- keywordTipo: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _clickstream contém o volume de pesquisa da palavra-chave normalizado pelos dados de clickstream
- isTipo: boolean | null
_normalized as informações de palavra-chave são normalizadas se verdadeiro, os valores são normalizados com dados do Bing
- lastTipo: string | null
_updated _time data e hora em que o conjunto de dados foi atualizado no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” exemplo: 2019-11-15 12:57:46 +00:00
- monthlyTipo: array (object | null)[] | null
_searches taxas mensais de volume de pesquisa array de objetos com taxas de volume de pesquisa em um determinado mês de um ano
- monthTipo: integer | null
mês
- searchTipo: integer | null
_volume taxa média mensal de volume de pesquisa
- yearTipo: integer | null
ano
- searchTipo: integer | null
_volume taxa atual de volume de pesquisa de uma palavra-chave
- keywordTipo: object | null · Response36Afe1097B20_KeywordProperties
_properties informações adicionais sobre a palavra-chave
- coreTipo: string | null
_keyword palavra-chave principal de um grupo
contém a palavra-chave principal de um grupo determinada pelo algoritmo de agrupamento de sinônimos
se o valor fornull, nosso banco de dados não contém palavras-chave que o algoritmo correspondente pudesse identificar como sinônimas dekeyword - detectedTipo: string | null
_language idioma detectado da palavra-chave
indica o idioma da palavra-chave conforme identificado pelo nosso sistema - isTipo: boolean | null
_another _language o idioma detectado da palavra-chave é diferente do idioma definido
setrue, o idioma definido na requisição não corresponde ao idioma determinado pelo nosso sistema para uma palavra-chave - keywordTipo: integer | null
_difficulty dificuldade de classificação nos 10 primeiros resultados orgânicos para uma palavra-chave
indica a chance de entrar nos 10 primeiros resultados orgânicos para uma palavra-chave em uma escala logarítmica de 0 a 100;
calculada analisando, entre outros parâmetros, os perfis de links das 10 primeiras páginas da SERP;
saiba mais sobre a métrica neste guia da central de ajuda - seTipo: string | null
_type tipo de mecanismo de busca
- synonymTipo: string | null
_clustering _algorithm o algoritmo usado para identificar sinônimos
valores possíveis:keyword_metrics- indica o algoritmo baseado em parâmetros dekeyword_infotext_processing- indica o algoritmo baseado em texto
se o valor fornull, nosso banco de dados não contém palavras-chave que o algoritmo correspondente pudesse identificar como sinônimas dekeyword - wordsTipo: integer | null Formato: int64
_count número de palavras na palavra-chave
indica quantas palavras a palavra-chave contém
- languageTipo: string | null
_code código de idioma em um array POST
- locationTipo: integer | null
_code código de localização em um array POST
- seTipo: string | null
_type tipo de mecanismo de busca
- searchTipo: object | null · Response36Afe1097B20_SearchIntentInfo
_intent _info - foreignTipo: array (string | null)[] | null
_intent intenções de pesquisa complementares
valores possíveis:informational,navigational,commercial,transactional - lastTipo: string | null
_updated _time data e hora de atualização dos dados da palavra-chave
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
exemplo:2019-11-15 12:57:46 +00:00 - mainTipo: string | null
_intent intenção de pesquisa principal
valores possíveis:informational,navigational,commercial,transactional - seTipo: string | null
_type tipo de mecanismo de busca
- serpTipo: object | null · Response36Afe1097B20_SerpInfo
_info dados de SERP
o valor seránullse você não definir o campoinclude_serp_infocomotrueno array POST ou se não houver dados de SERP para esta palavra-chave em nosso banco de dados- checkTipo: string | null
_url URL direta para os resultados do mecanismo de busca
você pode usá-la para garantir que fornecemos resultados precisos - lastTipo: string | null
_updated _time data e hora de atualização dos dados da palavra-chave
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
exemplo:2019-11-15 12:57:46 +00:00 - previousTipo: string | null
_updated _time data e hora anterior à mais recente em que os dados da SERP foram atualizados
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
exemplo:2019-10-15 12:57:46 +00:00 - seTipo: integer | null Formato: int64
_results _count número de resultados de pesquisa para a palavra-chave retornada
- seTipo: string | null
_type tipo de mecanismo de busca
- serpTipo: array (string | null)[] | null
_item _types tipos de resultados de pesquisa na SERP
contém os tipos de resultados de pesquisa (items) encontrados na SERP
tipos de itens possíveis: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;
observação: os resultados reais serão retornados apenas para os elementosorganic,paid,featured_snippetelocal_pack
- itemsTipo: integer | null Formato: int64
_count número de resultados retornados no array
items - languageTipo: string | null
_code código de idioma em um array POST
- locationTipo: integer | null
_code código de localização em um array POST
- offsetTipo: integer | null
valor de deslocamento atual
- offsetTipo: string | null
_token token de deslocamento para requisições subsequentes
você pode usar a string fornecida neste campo para obter os resultados subsequentes da tarefa inicial;
observação: os valores deoffset_tokensão exclusivos para cada tarefa subsequente - seTipo: string | null
_type tipo de mecanismo de busca
- seedTipo: array (string | null)[] | null
_keywords palavras-chave em um array do POST
as palavras-chave são retornadas com %## decodificado (o caractere de adição '+' será decodificado como um caractere de espaço) - totalTipo: integer | null Formato: int64
_count número total de resultados relevantes para sua solicitação em nosso banco de dados
- resultTipo: integer | null Formato: int64
_count número de elementos no array de resultados
- statusTipo: integer | null
_code código de status da tarefa gerado pelo DataForSEO; pode estar no seguinte intervalo: 10000-60000 você pode encontrar a lista completa dos códigos de resposta aqui
- statusTipo: string | null
_message mensagem informativa da tarefa você pode encontrar a lista completa das mensagens informativas gerais aqui
- timeTipo: string | null
tempo de execução, segundos
- Tipo: integer | null Formato: int64tasks
_count o número de tarefas no array de tarefas
- Tipo: integer | null Formato: int64tasks
_error o número de tarefas no array de tarefas retornadas com erro
- Tipo: string | nulltime
tempo total de execução, em segundos
- Tipo: string | nullversion
a versão atual da API
application/json - 400
Não foi possível processar a requisição. Verifique os parâmetros da requisição.
- 401
É necessária uma chave de API da Felo válida.
- 402
A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.
- 403
A conta não tem permissão para realizar esta operação.
- 429
Um limite de requisições ou de gastos foi atingido.
- 502
O serviço não pôde concluir a requisição.
- 503
A API ou o serviço de cobrança está temporariamente indisponível.
- 504
O serviço atingiu o tempo limite ao processar a requisição.
- default
Resposta de erro; respostas repassadas do upstream podem usar formatos do provedor
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/keyword_ideas/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keywords": [
"phone",
"watch"
],
"location_code": 2840,
"language_code": "en",
"include_serp_info": true,
"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,
"seed_keywords": [
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]"
}
]
}
]
}
]
}