Google Search Console API

API Free Caution SEO Has MCP ↗
Pricing

No fee listed

Quota-based. The docs list no charge.

Free tier

Quota-based (see docs)

Auth

OAuth 2.0

OAuth 2.0 with scope webmasters.readonly (read-only) or webmasters.

Data it gives

Clicks and impressions
CTR and average position
Queries and pages
Country and device splits
URL inspection results

Pricing checked on 23 Oct 2026 · Pricing page · Docs · Sign up

Description

The Search Console API gives programmatic access to the same search performance data you see in the Search Console web report. You can group by query, page, country, device, date or hour, filter the rows, and page through up to 25,000 rows per request.

It suits reporting automations, content decay checks, and agents that decide what to refresh based on real impressions and clicks. It also covers URL inspection and sitemap management.

It only returns data for sites you have verified in Search Console. It is not a competitor research tool and it does not show other sites’ rankings. Setup needs a Google Cloud project and OAuth consent.

Key endpoints

  • POST /sites/{siteUrl}/searchAnalytics/query: clicks, impressions, CTR, position by dimension

Example request

curl -X POST "https://www.googleapis.com/webmasters/v3/sites/https%3A%2F%2Fwww.example.com%2F/searchAnalytics/query" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"startDate":"2026-09-01","endDate":"2026-09-30","dimensions":["query"],"rowLimit":100}'

Tech details

API style
REST
Base URL
https://www.googleapis.com/webmasters/v3
Rate limits
Search Analytics: 1,200 queries/min per site and per user; 40,000 queries/min and 30,000,000 queries/day per project. Separate load quota applies.
Official SDKs
Python, Node.js

Use Cases

Clicks and impressions

CTR and average position

Queries and pages

Country and device splits

URL inspection results

Editor’s note What our review found

Editorial research, reviewed 23 Oct 2026. We read Google's quota and API reference pages. We did not run live calls. This listing is not an endorsement.

Cost: Google's pages list quota limits and no charge for the API. Check Google's terms for the current position. You need a Google Cloud project and a verified Search Console property.

Credentials and data: OAuth 2.0 access. Use the read-only scope where you can. Store client secrets and refresh tokens in an environment variable or secret manager, never in code or a plain-text file. The API returns your own site's search data, and your OAuth consent grants the app access to your Search Console account.

Good to know: quotas are per site, per user and per project, and there is also a "load" quota that grows with heavy queries (page or query grouping, long date ranges). The API does not guarantee every row is returned, only the top ones.

Related Skills, MCPs, CLIs & APIs

Frequently Asked Questions

Does Google Search Console API have a free tier?
Free tier: Quota-based (see docs).
How do I authenticate with Google Search Console API?
Google Search Console API uses OAuth 2.0. OAuth 2.0 with scope webmasters.readonly (read-only) or webmasters.
What data does Google Search Console API give?
Google Search Console API provides: Clicks and impressions, CTR and average position, Queries and pages, Country and device splits, URL inspection results.
How much does Google Search Console API cost?
Pricing model: Free. Quota-based. The docs list no charge.