Tutorial · search-console · Published 2026-08-16 · 3 min read
URL Inspection APIs and programmatic coverage checks
Use the Search Console Content API and Indexing API to automate URL inspection coverage checks, fetch live index state and re-request indexing at scale.
The inspector as an API
In the Search Console dashboard, URL Inspection is a manual, one-off check: paste a URL, read the index state, re-request indexing. It is powerful but driven one URL at a time. The same coverage result is available programmatically through the Search Console Content API, which means teams can run the inspection across hundreds of URLs on a schedule instead of typing each one. Where the dashboard is the interactive tool, the API is the same capability as a build step.
Indexability via the Content API
The Content API exposes URL inspection data for properties you own and have given the service account permission to. In Google's split, Search Console was divided into a read-only API surface and a write surface: your programmatic inspection reads belong to the read side, and the write/update capability belongs to the Indexing API. The practical result:
- You can fetch the computed indexability (and related coverage details) for a URL through the Content API, mirroring the dashboard's "URL is on Google" state.
- It reflects the state Google computed, which is the truthful gauge of coverage, not what your site claims. Cross-checking it against your own crawl (see log file analysis) exposes mismatches.
Re-requesting indexing at scale
For asking Google to re-crawl an updated URL, the dashboard's Request Indexing button is manual. The Indexing API is the programmatic route, but it is limited: Google only supports it for JobPosting and BroadcastEvent structured data, with a strict quota (roughly 200 URLs per day). For ordinary pages, automated recrawl must use the standard channels: sitemap updates and request indexing per URL, which is exactly why many teams schedule the Content API to *find* stale URLs and then rely on sitemap signalling to draw the crawler.
So the realistic automation pattern is:
- Find via the Content API which URLs are not indexable, or are stale.
- Fix the underlying cause (canonical, noindex, block) surfaced by the inspection, or leave the re-crawl to a refreshed sitemap.
- Verify that a refreshed or resubmitted sitemap (see the sitemap index) and submit flow are in place rather than hammering the Indexing API on pages Google does not accept.
Permissions and quota in practice
The Content API needs a Google Cloud project and a service account added as a Search Console owner or full user. Its access mirrors data export slightly differently because it reaches the live index state rather than the aggregate reporting tables, so scope the credentials to the inspect-only role and keep it reading, not writing.
When to automate
Manual inspection on the dashboard (the URL Inspection flow) remains the fastest way to answer "is this one specific URL indexed and why". Automate with the API when the question is a population, such as "of my 5,000 product URLs, which are not indexable", that would take days by hand. Build the automation around the read surface for findings, drive re-crawl through sitemap signalling for ordinary pages, and reserve the quota-limited Indexing API for the job posting and broadcast event types it was built for. Done that way, the API turns the one-at-a-time inspector into a scheduled coverage audit without tripping Google's write-side constraints.