Developer tools Google
Google Search Console API
Read search performance and indexing information for website properties your Google account is allowed to access.
Source review: 2026-10-18 · Imported: 1 November 2026
A practical starting point
What could you build?
A site owner’s assistant can compare query impressions and identify pages whose search traffic changed.
Before you connect
Request only the OAuth scopes you need. Access to the API does not grant access to somebody else’s website property.
Capabilities & requirements
Dated specifications from the licensed source dataset. “Not published” indicates missing information, rather than confirmed absence.
| Capability | Details and source |
|---|---|
| Status | Not published The API docs (v3 / webmasters) carry no stage label. Source (external) · Not published by vendor: checked 2026-10-18 on https://developers.google.com/webmaster-tools/about |
| API key required | OAuth 2.0 token Scopes webmasters.readonly or webmasters; our request without a token returned HTTP 401. Source (external) · Verified 2026-10-18 by test request to https://www.googleapis.com/webmasters/v3/sites/sc-domain%3Aexample.com/searchAnalytics/query |
| Free tier | Free of charge Google says all use is free, subject to usage limits. Source (external) · Verified 2026-10-18 on https://developers.google.com/webmaster-tools/pricing |
| Rate limit | 1,200/min per site and per user Search Analytics; 40,000/min and 30M/day per project, plus load quotas. URL Inspection: 2,000/day per site. Source (external) · Verified 2026-10-18 on https://developers.google.com/webmaster-tools/limits |
| Official MCP server | Community servers only No Google MCP server; AminForou/mcp-gsc is an MIT-licensed community option. Source (external) · Verified 2026-10-18 on https://github.com/AminForou/mcp-gsc |
| Official SDK | Google API client libraries Google recommends its client libraries, which also handle OAuth. Source (external) · Verified 2026-10-18 on https://developers.google.com/webmaster-tools/about |
| Data license / terms | Google APIs Terms of Service Plus the API Services User Data Policy for apps that handle other people’s data. Source (external) · Verified 2026-10-18 on https://developers.google.com/terms |
| Commercial use allowed | Allowed under Google APIs ToS The terms carry no non-commercial restriction; the data is about sites you manage. Source (external) · Verified 2026-10-18 on https://developers.google.com/terms |
| CORS / browser use | Origin echoed back A preflight to www.googleapis.com/webmasters/v3 returned Access-Control-Allow-Origin for our origin. Source (external) · Verified 2026-10-18 by test request to https://www.googleapis.com/webmasters/v3/sites |
| Freshness / coverage | Finalized by default; “all” adds fresh dataState all includes fresh, partial data; hourly_all gives hourly rows. Source (external) · Verified 2026-10-18 on https://developers.google.com/webmaster-tools/v1/searchanalytics/query |
Operational reference
Additional facts and qualifications retained from AgentAPIList’s CC BY 4.0 dataset, with provider references.
Price
Free: Google says all use of the Search Console API is free of charge, subject to usage limits.
Provider reference (external)API key / auth
OAuth 2.0 access token with scope webmasters.readonly (read-only) or webmasters (read/write), for a Google account with owner, full or read access to the property. Our request without a token on 2026-10-18 returned HTTP 401 UNAUTHENTICATED.
Provider reference (external)Rate limit
Search Analytics: 1,200 queries a minute per site and per user, 40,000 a minute and 30,000,000 a day per project, plus short- and long-term load quotas. URL Inspection: 2,000 a day and 600 a minute per site. Other resources: 20 a second and 200 a minute per user.
Provider reference (external)Row limit
rowLimit is 1–25,000 (default 1,000); page with startRow. Google says the API returns top rows, not necessarily every row. Dates are in Pacific Time.
Provider reference (external)Terms
Google APIs Terms of Service (last modified Nov 9, 2021) apply, including the API Services User Data Policy if your app handles other people’s data.
Provider reference (external)MCP server (community)
No official Google MCP server for Search Console. A widely used open-source one is AminForou/mcp-gsc (MIT license, about 1,965 GitHub stars on 2026-10-18).
Provider reference (external)Setup references
HTTP request example
Adapted from the attributed source dataset. Review before running; these examples were not executed by Tech in General.
# Not run: needs an OAuth token for a property you manage
curl -X POST \
"https://www.googleapis.com/webmasters/v3/sites/sc-domain%3Aexample.com/searchAnalytics/query" \
-H "Authorization: Bearer $GSC_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"startDate":"2026-10-01","endDate":"2026-10-15","dimensions":["query"],"rowLimit":10}'Agent connection example
Adapted from the attributed source dataset. Review before running; these examples were not executed by Tech in General.
// Claude Desktop / Cursor: community MCP server AminForou/mcp-gsc (MIT), per its README
// Create an OAuth desktop client in Google Cloud first and download client_secrets.json.
{
"mcpServers": {
"gscServer": {
"command": "/FULL/PATH/TO/uvx",
"args": ["mcp-search-console"],
"env": { "GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json" }
}
}
}
// For reporting only, give the Google account behind it read access to the property, not owner.A tool schema needs an HTTP implementation; it does not by itself install an MCP server. Keep credentials out of browser code.
Other connections to explore
- Bing Webmaster Tools API (external)
- AgentAPIList MCP (external)
- Exa hosted MCP (external)
- App Store Connect API (external)
Source & reuse
Download the complete licensed source snapshot (JSON), including the original source’s caveats, alternative notes and examples.