Pages

API + MCP

GET/v3/gsc/pages

Requests to this endpoint are free and do not consume any API units.

Query parameters

project_idinteger

Project ID. Required when portfolio_id is not provided.

portfolio_idinteger

Portfolio ID. When provided, aggregates data across all GSC-connected projects in the portfolio.

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.

search_typestring

The type of search results to return (web, image, video, news).

Allowed values:webimagevideonews

Default:web

countrystring

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

Allowed values:adaeafagaialamaoarasatauawazba…

devicestring

Filter by device type (DESKTOP, MOBILE, TABLET). If not specified, all devices are included.

Allowed values:desktopmobiletablet

limitinteger

The number of results to return.

Default:1000

wherestring

Supported fields:

outputstring

The output format.

Allowed values:jsoncsvxmlphp

Responses

pagesarray<object>

clicksinteger or null

ctrnumber (float) or null

impressionsinteger or null

keywords_countinteger

pagestring (url)

positionnumber (float) or null

Average position (decimal, e.g. 4.7)

top_keywordstring or null

traffic_valuenumber (float) or null

Estimated traffic value in USD

{ "pages": [ { "clicks": 0, "ctr": 0.0, "impressions": 0, "keywords_count": 0, "page": "string", "position": 0.0, "top_keyword": "string", "traffic_value": 0.0 } ] }