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

Visão geral

API + MCP
GET/v3/keywords-explorer/overview

O filtro regex tem funcionalidade limitada quando usado nesta solicitação, e a sintaxe difere de outras solicitações. Ele espera um símbolo de asterisco (*) como curinga.

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 coluna para ordenar os resultados. Consulte o Schema de resposta para ver os identificadores de coluna válidos, exceto volume_monthly, que não é compatível com order_by neste endpoint.

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.

volume_monthly_date_tostring (date)

A data final no formato AAAA-MM-DD para recuperar volumes históricos mensais de Volume de pesquisa no campo volume_monthly_history. Obrigatória apenas se volume_monthly_history for solicitado.

volume_monthly_date_fromstring (date)

A data inicial no formato AAAA-MM-DD para recuperar volumes históricos mensais de Volume de pesquisa no campo volume_monthly_history. Obrigatória apenas se volume_monthly_history for solicitado.

target_modestring

O escopo do URL de destino que você especificou.

Valores permitidos:exactprefixdomainsubdomains
targetstring (url)

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

target_positionstring

Filtra palavras-chave com base na posição de ranking do target especificado.

Valores permitidos:in_top10in_top100
countrystringObrigatório

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

Valores permitidos:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
keywordsstring

Uma lista de palavras-chave separada por vírgulas para exibir métricas.

keyword_list_idinteger

O ID de uma lista de palavras-chave existente para exibir métricas.

outputstring

O formato de saída.

Valores permitidos:jsoncsvxmlphp

Respostas

keywordsarray<object>
clicksinteger or null

O número médio mensal de Cliques nos resultados de pesquisa realizados pelas pessoas enquanto pesquisam a palavra-chave de destino.

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).

cpsnumber (float) or null

Cliques por pesquisa (ou CPS) é a proporção de Cliques em relação ao Volume de pesquisa de palavras-chave. Mostra quantos resultados de pesquisa diferentes são clicados, em média, quando as pessoas pesquisam a palavra-chave de destino em um determinado país.

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.

first_seenstring (date-time) or null

A data em que verificamos pela primeira vez os resultados do mecanismo de pesquisa para uma palavra-chave.

global_volumeinteger or null

(10 unidades) Quantas vezes por mês, em média, as pessoas procuram pela palavra-chave alvo em todos os países no nosso banco de dados.

intentsobject or null

(10 unidades) Indica o objetivo por trás da consulta de pesquisa do usuário. Campos do objeto: informational, navigational, commercial, transactional, branded ou local. Todos os campos são do tipo bool, com valores possíveis true ou false.

keywordstring
parent_topicstring or null

O Tópico principal determina se você consegue ranquear para sua palavra-chave alvo enquanto, em vez disso, visa um tópico mais geral na sua página. Para identificar o Tópico principal, usamos a página ranqueada em primeiro lugar para sua palavra-chave e encontramos a palavra-chave responsável por enviar mais tráfego para essa página.

parent_volumeinteger or null

(10 unidades) O volume de pesquisa do tópico principal.

searches_pct_clicks_organic_and_paidnumber (float) or null

A porcentagem média mensal de pessoas que clicaram tanto em resultados orgânicos quanto em resultados pagos ao pesquisar pela palavra-chave alvo.

searches_pct_clicks_organic_onlynumber (float) or null

A porcentagem média mensal de pessoas que clicaram apenas em resultados orgânicos ao pesquisar pela palavra-chave alvo.

searches_pct_clicks_paid_onlynumber (float) or null

A porcentagem média mensal de pessoas que clicaram apenas em resultados pagos ao pesquisar pela palavra-chave alvo.

serp_featuresarray<string>

Os resultados enriquecidos em uma página de resultados do mecanismo de busca (SERP) que não são os resultados orgânicos tradicionais.

Allowed values:ai_overview_sitelinksnippetai_overviewlocal_packsitelinknewsimagevideodiscussiontweetpaid_toppaid_bottompaid_sitelinkshoppingknowledge_cardknowledge_panelquestionimage_thvideo_thorganic_shopping
serp_last_updatestring (date-time) or null

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

traffic_potentialinteger or null

(10 unidades) A soma do Tráfego orgânico que a página em 1º lugar para a sua palavra-chave alvo recebe de todas as palavras-chave para as quais ela ranqueia.

volumeinteger or null

(10 unidades) Uma estimativa do número médio de pesquisas mensais de uma palavra-chave ao longo dos últimos 12 meses de dados conhecidos.

volume_desktop_pctnumber (float) or null

A porcentagem de buscas por uma palavra-chave realizadas em computadores.

volume_mobile_pctnumber (float) or null

A porcentagem de buscas por uma palavra-chave realizadas em dispositivos móveis.

volume_monthlyinteger or null

(10 unidades) Uma estimativa do número de buscas por uma palavra-chave no último mês. Este campo pode não ser incluído no parâmetro order_by

volume_monthly_historyarray<object>

(2 unidades por mês histórico, com um mínimo de 50 unidades) Estimativas históricas mensais do Volume de pesquisa de uma palavra-chave para o período definido pelos parâmetros volume_monthly_date_from e volume_monthly_date_to.