# Google Search Console API (slim)

> REST API from Google for Search Console data on sites the user manages. It returns clicks, impressions and average position by query, page, country and device, inspects a URL's index status and manages sitemaps. Access is by OAuth 2.0.

- Full: https://www.anchorterminal.com/tools/google-search-console.md (~9,050 tokens) · this version ~1,680 tokens · JSON https://www.anchorterminal.com/tools/google-search-console.json · canonical https://www.anchorterminal.com/tools/google-search-console
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · Updated: 2026-10-09

**C · 59/100 · rank #508 of 842 · #2 in SEO & search visibility · not agent-ready · confidence medium**


Assessment: The API is free, with published quotas of 1,200 Search Analytics queries a minute per site and typed filters that accept regular expressions. It covers only properties the signed-in user manages, returns at most 50,000 rows a day per search type, and has no status page, SLA or dedicated changelog. A person must complete OAuth consent first.

## Facts

- Kind: HTTP API · vendor: Google · category: SEO & search visibility · legal entity: Google LLC · provenance 74/100
- Endpoint: `https://searchconsole.googleapis.com` (HTTP)
- Auth: OAuth · pricing: Free · x402: no · licence: Proprietary service under the Google APIs Terms of Service. The client libraries are Apache-2.0
- Probe metrics: not measured yet (probes haven't run)
- Price: Free of charge for all use, subject to usage limits
- Interface: REST, 11 methods in discovery revision 20261007. `searchanalytics.query`, four `sites` methods, four `sitemaps` methods, `urlInspection.index.inspect` and a mobile-friendly test method whose reference page returns 404
- Data: Clicks, impressions, click-through rate and average position, grouped by date, hour, query, page, country, device or search appearance, for web, image, video, news, Discover and Google News
- Coverage: Only properties the signed-in user has owner, full or read permission on in Search Console
- Quota: Search Analytics 1,200 a minute per site and per user, 40,000 a minute and 30,000,000 a day per project, plus an unnumbered load quota. URL inspection 2,000 a day and 600 a minute per site. Other methods 20 a second and 200 a minute per user
- Row limits: `rowLimit` 1 to 25,000, default 1,000, paged by `startRow`. At most 50,000 rows a day per search type
- Freshness: Final data is typically available after two to three days. `dataState` set to `all` adds fresh data and `hourly_all` an hourly breakdown
- Scopes: `https://www.googleapis.com/auth/webmasters` (read and write) and `https://www.googleapis.com/auth/webmasters.readonly`
- Batching: Up to 1,000 calls in one batch HTTP request
- Client libraries: Google API client libraries for Go, Java, Node.js, Objective-C, PHP and Python, Apache-2.0. `@googleapis/searchconsole` 11.0.1 (23 September 2026, Node 22 or later) and google-api-python-client 2.201.0 (30 September 2026)
- MCP server: None found from Google for Search Console
- Status: No status page for Search Console or the API. The Search Status Dashboard covers Crawling, Indexing, Ranking and Serving

- Scores: Reliability 37, Performance pending, Schema & documentation 75, Agent ergonomics 82, Security & auth 56, Payments & pricing 40, Task success pending, Maintenance & community 71, Transparency & trust 58 · total over the 7 assessed categories
- Why: Reliability, Graded on the REST API with the hosted lines. · Schema & documentation, Google publishes a discovery document, not OpenAPI, at revision 20261007 with 11 methods and 30 schemas (25). · Agent ergonomics, `rowLimit` from 1 to 25,000 with a default of 1,000, the `fields` parameter for partial responses and gzip (22 of 25). · Security & auth, OAuth 2.0 with two scopes and short-lived access tokens (30), less 10 because the discovery document lists `access_token`, `oauth_token` and… · Payments & pricing, No x402, MPP or L402 (0). · Maintenance & community, There are no API release notes, so recency is read from the client and the docs. · Transparency & trust, Closed service under the Google APIs Terms of Service, last modified 9 November 2021, with Apache-2.0 client libraries (15 of 30).
- Sources: 32, open questions: 10, both in the full twin
- Capabilities: seo.rankings, seo.keywords, seo.traffic
- JSON: https://www.anchorterminal.com/api/v1/tools/google-search-console.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/google-search-console.svg` or a link to https://www.anchorterminal.com/tools/google-search-console from a page on google.com or one of its subdomains, or the README of github.com/googleapis/google-api-nodejs-client, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.

## Before you call it

1. URL-encode the property in the path. A URL-prefix property needs its trailing slash, and a Domain property is written `sc-domain:example.com`
2. Query one day at a time and page with `startRow` in steps of 25,000 until a response has no rows
3. Leave `page` and `query` out of `dimensions` when totals must be accurate. Grouping by either drops some data
4. Ask for `webmasters.readonly` unless the task adds or deletes properties or sitemaps
5. After a quota exceeded error wait 15 minutes. If it repeats, the daily load quota is spent, so shorten date ranges and drop page or query grouping

## Connect

```bash
npm install @googleapis/searchconsole
```

```bash
curl -X POST "https://searchconsole.googleapis.com/webmasters/v3/sites/https%3A%2F%2Fwww.example.com%2F/searchAnalytics/query" \
  -H "Authorization: Bearer $GOOGLE_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"startDate": "2026-09-01", "endDate": "2026-09-01", "dimensions": ["country", "device"]}'
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/google-search-console

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| DataForSEO | B | 64.9 | seo.keywords, seo.rankings, seo.traffic | https://www.anchorterminal.com/tools/dataforseo.min.md |
| Manifold | C | 56.2 | seo.keywords, seo.rankings, seo.traffic | https://www.anchorterminal.com/tools/manifold-mcp.min.md |
| Semrush API + MCP | D | 53.1 | seo.keywords, seo.rankings, seo.traffic | https://www.anchorterminal.com/tools/semrush.min.md |
| SE Ranking API + MCP | D | 50.9 | seo.keywords, seo.rankings, seo.traffic | https://www.anchorterminal.com/tools/se-ranking.min.md |
| Ahrefs | D | 49.8 | seo.keywords, seo.rankings, seo.traffic | https://www.anchorterminal.com/tools/ahrefs.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)