v1

latestOpenAPI 3.1.02026-07-265897154.5 KB
GSC

Get GSC query distribution by position

Live GSC query distribution by ranking bucket (1-3, 4-10, 11-20, 20+) with clicks + impressions per bucket. Returns 409 gsc_not_connected if no site is linked.

get/api/mcp/projects/{projectId}/gsc/position-buckets

Path parameters

projectIdstring uuid required

The project id.

Query parameters

periodstring

GSC preset window (e.g. 7d, 28d, 90d). Ignored when startDate + endDate are both supplied.

startDatestring date

Explicit window start (YYYY-MM-DD). Must be paired with endDate.

endDatestring date

Explicit window end (YYYY-MM-DD). Must be paired with startDate.

Response

Position buckets.

siteUrlstring required
totalQueriesinteger required
successboolean required

Always true — injected on every success response by this endpoint family's response wrapper.