Total search volume history

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

Query parameters

volume_modestring

The search volume calculation mode: monthly or average. It affects volume, traffic, and traffic value.

Allowed values:monthlyaverage

Default:monthly

top_positionsstring

The number of top organic search positions to consider when calculating total search volume.

Allowed values:top_10top_100

Default:top_10

history_groupingstring

The time interval used to group historical data.

Allowed values:dailyweeklymonthly

Default:monthly

date_tostring

The end date of the historical period in YYYY-MM-DD format.

date_fromstringRequired

The start date of the historical period in YYYY-MM-DD format.

countrystring

A two-letter country code (ISO 3166-1 alpha-2).

Allowed values:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

protocolstring

The protocol of your target.

Allowed values:bothhttphttps

Default:both

targetstringRequired

The target of the search: a domain or a URL.

modestring

The scope of the search based on the target you entered.

Allowed values:exactprefixdomainsubdomains

Default:subdomains

outputstring

The output format.

Allowed values:jsoncsvxmlphp

Responses

metricsarray

datestring

total_search_volumeinteger

(10 units) The total search volume of keywords for which your target ranks within the specified top_positions in the search results.