Histórico do volume total de pesquisa

API + MCP

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

Parâmetros de consulta

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

top_positionsstring

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

Valores permitidos:top_10top_100

Padrão:top_10

history_groupingstring

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

Valores permitidos:dailyweeklymonthly

Padrão:monthly

date_tostring

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

date_fromstringObrigatório

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

countrystring

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

Valores permitidos:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

protocolstring

O protocolo do seu alvo.

Valores permitidos:bothhttphttps

Padrão:both

targetstringObrigatório

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

modestring

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

Valores permitidos:exactprefixdomainsubdomains

Padrão:subdomains

outputstring

O formato de saída.

Valores permitidos:jsoncsvxmlphp

Respostas

metricsarray<object>

datestring

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.