Docs
Search docs...⌘K

Metrics history

API + MCP
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
modestring

The scope of the target.

Allowed values:exactprefixdomainsubdomains
Default:subdomains
targetstring (url)Required

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

protocolstring

The protocol of your target.

Allowed values:bothhttphttps
Default:both
countrystring

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

Allowed values:adaeafagaialamaoarasatauawazba…
date_fromstring (date)Required

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

date_tostring (date)

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

history_groupingstring

The time interval used to group historical data.

Allowed values:dailyweeklymonthly
Default:monthly
volume_modestring

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

Allowed values:monthlyaverage
Default:monthly
traffic_modestring

The organic traffic calculation mode: static or adaptive. It affects organic traffic and traffic value.

Allowed values:staticadaptive
Default:static
outputstring

The output format.

Allowed values:jsoncsvxmlphp

Responses

metricsarray<object>
datestring (date)
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.