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

Volume por país

API + MCP
GET/v3/keywords-explorer/volume-by-country

Parâmetros de consulta

selectstring

Uma lista separada por vírgulas de campos a serem retornados.

order_bystring

Um campo para ordenar os resultados, com direção opcional. Formato: field_name:asc ou field_name:desc (padrão desc).

Campos disponíveis:
  • cpc
  • difficulty (10 unidades)
  • growth_rate_12m
  • traffic_potential (10 unidades)
  • volume (10 unidades)
limitinteger

O número de resultados a retornar.

offsetinteger

O número de resultados a serem ignorados.

Padrão:0
keyword_list_idinteger

O ID de uma lista de palavras-chave existente.

keywordstring

Uma lista de palavras-chave separadas por vírgulas para as quais serão exibidas métricas.

countriesstring

Uma lista separada por vírgulas de códigos de país de duas letras (ISO 3166-1 alpha-2).

Valores permitidos:adaeafagaialamaoarasatauawazba…
volume_monthly_date_fromstring (date)

A data de início no formato AAAA-MM-DD para recuperar volumes de pesquisa mensais históricos no campo volume_monthly_history. Obrigatória somente se volume_monthly_history for solicitado.

volume_monthly_date_tostring (date)

A data de término no formato YYYY-MM-DD para recuperar os volumes de pesquisa mensais históricos no campo volume_monthly_history. Obrigatório apenas se volume_monthly_history for solicitado.

outputstring

O formato de saída.

Valores permitidos:jsonphp

Respostas

countriesarray<object>
countrystring

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

cpcinteger or null

Custo por clique de top_keyword, em centavos de dólar americano.

difficultyinteger or null

(10 unidades) Dificuldade da palavra-chave de top_keyword.

growth_rate_12mnumber (float) or null

Crescimento do volume de pesquisa em 12 meses. Disponível para palavras-chave semente individuais.

has_serpboolean or null

Se os dados de SERP estão disponíveis para top_keyword.

top_keywordstring or null

A palavra-chave semente com o maior volume de pesquisa neste país.

top_pagestring or null

A principal página orgânica para top_keyword.

top_page_titlestring or null

Título de top_page.

traffic_potentialinteger or null

(10 unidades) Potencial de tráfego de top_keyword.

volumeinteger

(10 unidades) Uma estimativa do número médio mensal de buscas por uma palavra-chave em um determinado país.

volume_monthly_historyarray<object>

(50 unidades) Volumes de pesquisa mensais somados entre as palavras-chave semente neste país.

datestring (date)
volumeinteger