# Google Search Console

Connect a Search Console site and read its Google Search clicks, impressions and positions, its sitemaps and URL inspections through the Zernio API.

Connect a Search Console site to a profile and read its Google Search data with your Zernio API key. A connected account uses `platform: "googlesearchconsole"` and represents one site. It reads data only and never posts.

## Quick reference

| Property | Value |
|----------|-------|
| Platform value | `googlesearchconsole` |
| What it reads | Search analytics (clicks, impressions, CTR, position), sitemaps and URL inspection |
| Auth | OAuth 2.0 with a Google account |
| Scope | `https://www.googleapis.com/auth/webmasters.readonly` |
| Sites per account | One Domain property (`sc-domain:acme.com`) or URL-prefix property (`https://acme.com/`). Connect another site to a different profile |
| History | 16 months |
| Caching | 10 minutes for search analytics and sitemaps, 1 hour for URL inspection |
| Social posting | No |
| List the accounts | `GET /v1/accounts?category=analytics` |

## Before you start

The person connecting needs a Google account that can read a verified site in Search Console, as an owner, full user or restricted user. Unverified sites are not offered.

## Connect

Call `GET /v1/connect/googlesearchconsole` with the profile and send the user to the returned `authUrl`. If their Google account reads several sites, they pick one on a Zernio page. See [Connect](/platforms/google-search-console/connect).

In the dashboard, the site's numbers show under Analytics > Website. "View report" on the connection row opens them.

## Common errors

| Error | Cause | Fix |
|-------|-------|-----|
| `googlesearchconsole_scope_missing` on the redirect | The user unticked the Search Console permission on Google's consent screen | Connect again and keep the permission ticked. |
| `googlesearchconsole_no_sites` on the redirect | The Google account has no verified Search Console site | Add and verify the site in Search Console, then connect again. |
| `429` with `rate_limited` | Google's quota for the site is used up | Wait for the quota to refill. |

## In this section

<PlatformPages platform="google-search-console" />

## Related

- [Get Google Search Console connect URL](/connect/get-google-search-console-connect-url)
- [Query search analytics](/analytics/query-google-search-console-search-analytics)
- [List sitemaps](/analytics/list-google-search-console-sitemaps)
- [Inspect a URL](/analytics/inspect-google-search-console-url)
- [Connecting accounts](/guides/connecting-accounts)