Docs
Search docs...⌘K

Keywords history

GET/v3/site-explorer/keywords-history

Query parameters

selectstring

A comma-separated list of columns to return. See response schema for valid column identifiers.

Default:date,top3,top4_10,top11_plus
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

keywordsarray
datestring
top11_20integer

The total number of keywords that your target ranks for in the top 11-20 organic search results.

top11_plusinteger

The total number of keywords that your target ranks for in the top 11+ organic search results.

top21_50integer

The total number of keywords that your target ranks for in the top 21-50 organic search results.

top3integer

The total number of keywords that your target ranks for in the top 3 organic search results.

top4_10integer

The total number of keywords that your target ranks for in the top 4-10 organic search results.

top51_plusinteger

The total number of keywords that your target ranks for in the top 51+ organic search results.