Performance by position

API + MCP

GET/v3/gsc/performance-by-position

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

wherestring

Supported fields:

outputstring

The output format.

Allowed values:jsoncsvxmlphp

Responses

metricsarray<object>

clicksinteger

clicks_percentnumber (float)

impressionsinteger

impressions_percentnumber (float)

keyword_countinteger

keyword_count_percentnumber (float)

position_rangestring

{ "metrics": [ { "clicks": 0, "clicks_percent": 0.0, "impressions": 0, "impressions_percent": 0.0, "keyword_count": 0, "keyword_count_percent": 0.0, "position_range": "string" } ] }