analytics:read

analytics:read The analytics:read scope provides read-only access to warehoused Search Console and GA4 for the API key’s site. Existing keys created before this scope shipped must add it explicitly. MCP OAuth grants include it on the MCP (Read) presets. URL Inspection (live Google) runs only on GET /public/analytics/pages/performance. All other routes are warehouse reads. Pulse is REST-only.

Endpoints

Method	Path	Description
`GET`	`/public/analytics/search/snapshot`	Warehoused Search Console snapshot
`GET`	`/public/analytics/search/queries`	Warehoused queries
`GET`	`/public/analytics/search/pages`	Warehoused landing pages
`GET`	`/public/analytics/search/opportunities`	Impression volume and CTR-gap queries
`GET`	`/public/analytics/search/gaps`	Queries with demand and no dedicated landing page
`GET`	`/public/analytics/search/changes`	Period-over-period click and impression movers
`GET`	`/public/analytics/search/decay`	Pages whose clicks fell across three 30-day windows
`GET`	`/public/analytics/search/questions`	Interrogative, near-me, and gen-AI exhaust query strings
`GET`	`/public/analytics/seo/keyword-gap`	Keywords the competitor last compared in Clarity ranks for where the dealer is missing or behind
`GET`	`/public/analytics/search/alerts`	Click drops, gains, impression drops, and decaying pages
`GET`	`/public/analytics/search/create-brief`	Create-brief from opportunities, gaps, decay, and related signals
`GET`	`/public/analytics/search/pulse`	Four-scalar search pulse (REST-only; group `include_pulse`)
`GET`	`/public/analytics/pages/performance`	One URL: warehouse query×page plus live URL Inspection
`GET`	`/public/analytics/traffic/snapshot`	Warehoused GA4 snapshot
`GET`	`/public/analytics/traffic/pages`	Warehoused GA4 top pages
`GET`	`/public/analytics/demand/vehicles`	Inventory + search + GA4 demand by model

See the Search and GA4 analytics guide for the notice → diagnose → create loop, 50k truncation, and freshness.

Getting Started

Concepts

Guides

Scopes

Endpoints

​Endpoints

Endpoints