Metrics history

GET/v3/site-explorer/metrics-history

Query parameters

selectstring

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

Default:date,org_cost,org_traffic,paid_cost,paid_traffic

volume_modestring

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

Allowed values:monthlyaverage

Default:monthly

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

org_costinteger

(10 units) The estimated cost of your target's monthly organic search traffic, in USD cents.

org_trafficinteger

(10 units) The estimated number of monthly visitors that your target gets from organic search.

paid_costinteger

(10 units) The estimated cost of your target's monthly paid search traffic, in USD cents.

paid_trafficinteger

(10 units) The estimated number of monthly visitors that your target gets from paid search.