Paid pages
API + MCPQuery parameters
A manual timeout duration in seconds.
The number of results to return.
A comma-separated list of columns to order results by, with optional direction. See response schema for valid column identifiers.
The filter expression. The following column identifiers are recognized (this differs from the identifiers recognized by the select parameter).
A comma-separated list of columns to return. See response schema for valid column identifiers.
The protocol of your target.
The target of the search: a domain or a URL.
The scope of the search based on the target you entered.
A two-letter country code (ISO 3166-1 alpha-2).
A date to compare metrics with in YYYY-MM-DD format.
A date to report metrics on in YYYY-MM-DD format.
The search volume calculation mode: monthly or average. It affects volume, traffic, and traffic value.
The output format.
Responses
The number of unique ads with a page.
The change in ads between your selected dates.
The number of ads on the comparison date.
The total number of keywords that your target ranks for in paid search results.
The change in keywords between your selected dates.
The change in keywords between your selected dates, in percents.
The total number of keywords optimized for sorting.
The keyword your target ranks for on the comparison date.
The ranking page URL in encoded format.
The ranking page URL on the comparison date in encoded format.
(5 units) The number of unique domains linking to a page.
The status of a page: the new page that just started to rank in paid results ("left"), the lost page that disappeared from paid results ("right"), or no change ("both").
(10 units) An estimation of the monthly paid search traffic that a page gets from all the keywords that it ranks for.
(10 units) The paid traffic field optimized for sorting.
(10 units) The paid traffic on the comparison date.
The keyword that brings the most paid traffic to a page.
The ranking position that a page holds for its top keyword.
The change in the top position between your selected dates.
The kind of the top position: organic, paid or a SERP feature.
The kind of the top position on the comparison date.
The top position on the comparison date.
The title displayed for the page in its top keyword's SERP.
The title displayed for the page in its top keyword's SERP on the comparison date.
The country in which a page ranks for its top keyword.
The country in which a page ranks for its top keyword on the comparison date.
The keyword that brings the most paid traffic to a page on the comparison date.
(10 units) An estimation of the average monthly number of searches for the top keyword over the latest month or over the latest known 12 months of data depending on the "volume_mode" parameter.
(10 units) The search volume on the comparison date.
The change in traffic between your selected dates.
The change in traffic between your selected dates, in percents.
URL Rating (UR) shows the strength of your target page’s backlink profile on a 100-point logarithmic scale.
The ranking page URL.
The ranking page URL on the comparison date.
(10 units) The estimated cost of a page's monthly paid search traffic, in USD cents.
The change in traffic value between your selected dates.
The change in traffic value between your selected dates, in percents.
(10 units) The traffic value field optimized for sorting.
(10 units) The traffic value on the comparison date.