Page history

API + MCP

GET/v3/gsc/page-history

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

Query parameters

pagesstring

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

devicestring

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

Allowed values:desktopmobiletablet

countrystring

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

Allowed values:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

history_groupingstring

The time interval used to group historical data.

Allowed values:dailyweeklymonthly

Default:monthly

date_tostring

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

date_fromstringRequired

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

portfolio_idinteger

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

project_idinteger

Project ID. Required when portfolio_id is not provided.

outputstring

The output format.

Allowed values:jsoncsvxmlphp

Responses

metricsarray

pagestring

datestring

clicksinteger

impressionsinteger

ctrnumber

positionnumber