Page history

API + MCP

GET/v3/gsc/page-history

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.

history_groupingstring

The time interval used to group historical data.

Allowed values:dailyweeklymonthly

Default:monthly

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

pagesstring

A comma-separated list of page URLs to get history data for.

outputstring

The output format.

Allowed values:jsoncsvxmlphp

metricsarray<object>

clicksinteger

ctrnumber (float)

datestring (date-time)

impressionsinteger

pagestring (url)

positionnumber (float)

Average position (decimal, e.g. 4.7)