Histórico do volume total de pesquisa

API + MCP

GET/v3/site-explorer/total-search-volume-history

Parâmetros de consulta

modestring

O escopo do alvo.

Valores permitidos:exactprefixdomainsubdomains

Padrão:subdomains

targetstring (url)Obrigatório

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

protocolstring

O protocolo do seu alvo.

Valores permitidos:bothhttphttps

Padrão:both

countrystring

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

Valores permitidos:adaeafagaialamaoarasatauawazba…

date_fromstring (date)Obrigatório

A data de início do período histórico, no formato YYYY-MM-DD.

date_tostring (date)

A data de término do período histórico, no formato YYYY-MM-DD.

history_groupingstring

O intervalo de tempo usado para agrupar os dados históricos.

Valores permitidos:dailyweeklymonthly

Padrão:monthly

top_positionsstring

O número de primeiras posições na pesquisa orgânica a considerar ao calcular o volume de pesquisa total.

Valores permitidos:top_10top_100

Padrão:top_10

volume_modestring

O modo de cálculo do volume de pesquisa: mensal ou médio. 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

metricsarray<object>

datestring (date)

total_search_volumeinteger

(10 unidades) O volume de pesquisa total das palavras-chave para as quais o seu alvo se posiciona dentro das top_positions especificadas nos resultados de pesquisa.