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

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.

portfolio_idinteger

O identificador exclusivo do portfolio. Quando fornecido, ele tem precedência sobre target.

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 posições mais altas na pesquisa orgânica a serem consideradas 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. Isso 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.