Pages
API + MCPRequests to this endpoint are free and do not consume any API units.
Query parameters
Supported fields:
- url
- clicks
- impressions
- ctr
- position
Filter is a JSON string that represents a boolean expression, it should follow the following structure:
<bool_filter> ::= { "and" : <bool_filter>+ }
| { "or" : <bool_filter>+ }
| { "not" : <bool_filter> }
| <expr>
<expr> ::= {
"field" : <dimension|metric>,
? "is": <condition>,
}
<condition> ::= [ "eq", <value> ]
| [ "neq", <value> ]
| [ "gt", <value> ]
| [ "gte", <value> ]
| [ "lt", <value> ]
| [ "lte", <value> ]
| [ "substring", <value> ]
| [ "isubstring", <value> ]
| [ "phrase_match", <value> ]
| [ "iphrase_match", <value> ]
| [ "prefix", <value> ]
| [ "suffix", <value> ]
The number of results to return.
Filter by device type (DESKTOP, MOBILE, TABLET). If not specified, all devices are included.
A two-letter country code (ISO 3166-1 alpha-2).
The type of search results to return (web, image, video, news).
The end date of the historical period in YYYY-MM-DD format.
The start date of the historical period in YYYY-MM-DD format.
Portfolio ID. When provided, aggregates data across all GSC-connected projects in the portfolio.
Project ID. Required when portfolio_id is not provided.
The output format.
Responses
Average position (decimal, e.g. 4.7)
Estimated traffic value in USD