Bulk URL inspection with the GSC API

Google's URL Inspection API tells you the index status of any URL on your verified property. The API quota is 2,000 URLs/day per property. Bulk URL Inspection queues URLs against that quota over time and gives you a unified view.

When to use it

• After a site migration: confirm every important URL has been reindexed at the new path.
• After bulk content updates: confirm Google has re-crawled the updates.
• Diagnosing index coverage issues: see exactly why specific URLs aren't indexed.
• Before a programmatic-SEO launch: spot-check indexability of templated pages.

Queue URLs

1. Console → Bulk inspection → New batch.
2. Paste up to 10,000 URLs (one per line) OR upload a CSV with a `url` column.
3. Pick the GSC property (auto-suggested based on URL prefix matching).
4. Click Submit. URLs queue immediately; processing rate is throttled to your quota.

Processing rate

We respect Google's 2,000/day per-property quota. A 10,000-URL batch takes ~5 days to fully process. The batch detail view shows: queued / inspecting / done counts, ETA, current quota window.

Result fields

Retry semantics

If Google returns a transient error (rate limit, server error), we retry with exponential backoff up to 3 times. Permanent errors (URL not in property) are recorded as failed and not retried.

Export results

Batch detail view → Export CSV. Includes every inspected URL and every field above. Useful for grouping by verdict and filing engineering tickets.

API equivalent

bash
curl -X POST https://api.semoptimiser.com/v1/console/inspect/batch \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "property": "sc-domain:example.com",
    "urls": ["https://example.com/page1", "https://example.com/page2"]
  }'

Returns a batch_id. Poll GET /v1/console/inspect/batch/{batch_id} for status.