Docs
Pesquisar na documentação...⌘K

Palavras-chave orgânicas

API + MCP
GET/v3/site-explorer/organic-keywords

Parâmetros de consulta

timeoutinteger

Um tempo limite manual em segundos.

limitinteger

O número de resultados a retornar.

Padrão:1000
order_bystring

Uma lista de colunas separadas por vírgula para ordenar os resultados, com direção opcional. Consulte o schema de resposta para ver identificadores de coluna válidos.

Example:field_a,field_b:asc,field_c:desc
wherestring

A expressão de filtro. Os seguintes identificadores de coluna são reconhecidos (isso difere dos identificadores reconhecidos pelo parâmetro select).

selectstringObrigatório

Uma lista de colunas separadas por vírgulas a serem retornadas. Consulte o Schema de resposta para ver identificadores de coluna válidos.

protocolstring

O protocolo do seu alvo.

Valores permitidos:bothhttphttps
Padrão:both
targetstring (url)Obrigatório

O alvo da busca: um domínio ou uma URL.

modestring

O escopo da pesquisa com base no alvo que você informou.

Valores permitidos:exactprefixdomainsubdomains
Padrão:subdomains
countrystring

Um código de país com duas letras (ISO 3166-1 alpha-2).

Valores permitidos:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
date_comparedstring (date)

Uma data para comparar as métricas, no formato YYYY-MM-DD.

datestring (date)Obrigatório

A data de referência das métricas, no formato AAAA-MM-DD.

volume_modestring

O modo de cálculo do volume de pesquisa: mensal ou média. Ele afeta o volume, o tráfego e o valor do tráfego.

Valores permitidos:monthlyaverage
Padrão:monthly
outputstring

O formato de saída.

Valores permitidos:jsoncsvxmlphp

Respostas

keywordsarray<object>
all_positionsarray<object>

(5 unidades) A lista de todas as posições de uma palavra-chave.

all_positions_prevarray<object>

(5 unidades) A lista de todas as posições de uma palavra-chave na data de comparação.

best_positioninteger or null

A melhor posição em que o seu alvo aparece nos resultados de pesquisa orgânica para uma palavra-chave.

best_position_diffinteger or null

A mudança na posição entre as datas selecionadas.

best_position_has_thumbnailboolean or null

A melhor posição tem uma miniatura.

best_position_has_thumbnail_prevboolean or null

A melhor posição tem uma miniatura na data de comparação.

best_position_has_videoboolean or null

A primeira posição tem um vídeo.

best_position_has_video_prevboolean or null

A primeira posição tem um vídeo na data de comparação.

best_position_kindstring or null

O tipo da primeira posição: orgânica, paga ou um dos Recursos da SERP.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_kind_mergedstring

O tipo da primeira posição, otimizado para ordenação.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_kind_prevstring or null

O tipo da primeira posição na data de comparação.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_previnteger or null

A primeira posição na data de comparação.

best_position_setstring

O grupo de classificação da primeira posição.

Allowed values:top_3top_4_10top_11_50top_51_more
best_position_set_prevstring or null

O grupo de classificação da primeira posição na data de comparação.

Allowed values:top_3top_4_10top_11_50top_51_more
best_position_urlstring (url) or null

O URL melhor classificado nos resultados de pesquisa orgânica.

best_position_url_prevstring (url) or null

O URL classificado na data de comparação.

cpcinteger or null

O Custo por Clique mostra o preço médio que os anunciantes pagam por cada clique em um anúncio nos resultados de pesquisa paga de uma palavra-chave, em centavos de dólar americano (USD).

cpc_mergedinteger or null

O campo CPC otimizado para ordenação.

cpc_previnteger or null

A métrica de CPC na data de comparação.

entitiesarray<object>

Organizações, produtos, pessoas, trabalhos, eventos e locais encontrados em uma palavra-chave.

is_best_position_set_top_11_50boolean

O grupo de classificação da melhor posição é 11-50.

is_best_position_set_top_11_50_prevboolean or null

O grupo de classificação da melhor posição era 11-50 na data de comparação.

is_best_position_set_top_3boolean

O grupo de classificação da melhor posição é Top 3.

is_best_position_set_top_3_prevboolean or null

O grupo de classificação da melhor posição era Top 3 na data de comparação.

is_best_position_set_top_4_10boolean

O grupo de classificação da melhor posição é 4-10.

is_best_position_set_top_4_10_prevboolean or null

O grupo de classificação da melhor posição era 4-10 na data de comparação.

is_brandedboolean

Intenção do usuário: marca. O usuário está buscando um nome de marca ou empresa específica.

is_commercialboolean

Intenção do usuário: comercial. O usuário está comparando produtos ou serviços antes de tomar uma decisão de compra.

is_informationalboolean

Intenção do usuário: informacional. O usuário está buscando informações ou uma resposta para uma pergunta específica.

is_localboolean

Intenção do usuário: local. O usuário está buscando informações relevantes para um local específico ou serviços próximos.

is_navigationalboolean

Intenção do usuário: navegacional. O usuário está buscando um site ou página da web específica.

is_transactionalboolean

Intenção do usuário: transacional. O usuário está pronto para concluir uma ação, geralmente uma compra.

keywordstring or null

A palavra-chave para a qual seu alvo se classifica.

keyword_countrystring

O país de uma palavra-chave para a qual seu alvo se classifica.

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
keyword_difficultyinteger or null

(10 unidades) Uma estimativa da dificuldade de ranqueamento entre os 10 melhores resultados de busca orgânica para uma palavra-chave em uma escala de 100 pontos.

keyword_difficulty_mergedinteger or null

(10 unidades) O campo Dificuldade da palavra-chave otimizado para ordenação.

keyword_difficulty_previnteger or null

(10 unidades) A Dificuldade da palavra-chave na data de comparação.

keyword_languagearray<string>

O idioma da consulta de pesquisa

keyword_mergedstring

O campo de palavra-chave otimizado para ordenação.

keyword_prevstring or null

A palavra-chave para a qual seu alvo se classifica na data de comparação.

languagestring

O idioma da SERP.

language_prevstring or null

O idioma da SERP na data de comparação.

last_updatestring (date-time)

A data da última análise dos resultados de pesquisa para uma palavra-chave.

last_update_prevstring (date-time) or null

A data em que verificamos os resultados do mecanismo de pesquisa até a data de comparação.

serp_featuresarray<string>

Os recursos de SERP que aparecem nos resultados de pesquisa para uma palavra-chave.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_features_countinteger

O número de recursos da SERP que aparecem nos resultados de pesquisa para uma palavra-chave.

serp_features_count_previnteger or null

O número de Recursos da SERP na data de comparação.

serp_features_mergedarray<string>

O campo Recursos da SERP otimizado para ordenação.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_features_prevarray<string>

Os Recursos da SERP que aparecem nos resultados de pesquisa para uma palavra-chave na data de comparação.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_target_main_positions_countinteger

O número de URLs-alvo classificadas para uma palavra-chave, excluindo posições em Sitelinks, Principais notícias, Pacotes de imagens e publicações no X (Twitter).

serp_target_main_positions_count_previnteger or null

O número de URLs-alvo classificadas para uma palavra-chave, excluindo posições em Sitelinks, Principais notícias, Pacotes de imagens e publicações no X (Twitter) na data de comparação.

serp_target_positions_countinteger

O número de URLs-alvo classificadas para uma palavra-chave.

serp_target_positions_count_previnteger or null

O número de URLs-alvo classificadas para uma palavra-chave na data de comparação.

statusstring

O status de uma página: a nova página que começou a ranquear recentemente ("left"), a página perdida que desapareceu dos resultados de pesquisa ("right") ou sem alterações ("both").

Allowed values:leftrightboth
sum_paid_trafficinteger or null

(10 units) Uma estimativa do número de visitas mensais que seu alvo obtém de pesquisas pagas para uma palavra-chave.

sum_paid_traffic_mergedinteger

(10 units) O campo de tráfego pago otimizado para ordenação.

sum_paid_traffic_previnteger or null

(10 units) O tráfego pago na data de comparação.

sum_trafficinteger or null

(10 units) Uma estimativa do número de visitantes mensais que seu alvo obtém de busca orgânica para uma palavra-chave.

sum_traffic_mergedinteger

(10 units) O campo de tráfego otimizado para ordenação.

sum_traffic_previnteger or null

(10 units) O tráfego na data de comparação.

volumeinteger or null

(10 unidades) Uma estimativa do número de buscas de uma palavra-chave no último mês.

volume_desktop_pctnumber (float) or null

A porcentagem do volume de pesquisa total que vem de dispositivos desktop.

volume_mergedinteger or null

(10 unidades) O campo de volume de pesquisa otimizado para ordenação.

volume_mobile_pctnumber (float) or null

A porcentagem do volume de pesquisa total que vem de dispositivos móveis.

volume_previnteger or null

(10 unidades) O volume de pesquisa na data de comparação.

wordsinteger or null

O número de palavras em uma palavra-chave.

words_mergedinteger

O número de palavras em uma palavra-chave otimizado para ordenação.

words_previnteger or null

O número de palavras em uma palavra-chave na data de comparação.