> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.hrizn.io/llms.txt
> Use this file to discover all available pages before exploring further.

# analytics:read

> Read warehoused Google Search Console and GA4 analytics for a site

<code>analytics:read</code>

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/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](/guides/analytics) for the notice → diagnose → create loop, 50k truncation, and freshness.