What is gsc-indexer? (and what "submit for indexing" really means)
Abhay khant
Jan 1, 1970 • 3 min read
Why this tool exists
You published or updated a page on your site, but Google hasn't picked it up yet. In Google Search Console (GSC) you can click Request indexing. but only one URL at a time, by hand.
gsc-indexer does that same "ask Google to look at this URL" step from the
command line, for one URL or ten thousand, using the GSC URL Inspection
API.
What it actually does
For every URL you give it, the tool calls the URL Inspection API. That API asks Google to crawl / re-fetch the URL. Think of it as tapping Google on the shoulder: "hey, this page changed, come take a look."
It does not force Google to index the page. Google still decides. But requesting a re-crawl is the legitimate, supported way to speed up discovery of new or updated content.
URL Inspection API vs the Indexing API v3
There are two Google APIs that sound similar. We use the URL Inspection API, and on purpose:
| API | Works for | Requires |
|---|---|---|
| URL Inspection API (this tool) | any URL on a property you can access | service account with property access |
| Indexing API v3 | only JobPosting / BroadcastEvent structured data | service account as Owner |
The Indexing API v3 rejects general blog pages and demands Owner-level access,
so it does not apply to normal websites. That is why gsc-indexer uses URL
Inspection.
"Indexed" vs "re-indexed"
- New page, not yet in Google → the tool requests indexing (asks Google to discover it).
- Existing page you changed → the tool re-indexes (asks Google to refresh what it has).
Same command, same API. the difference is just the page's current state.
Honest limitations
- Google decides whether and when to index. Typical delay is hours to days, not seconds.
- GSC rate-limits sustained inspect volume; very large runs need a polite delay (see the throttling guide).
- You must have at least full-user access to the GSC property the URL belongs to.
Next steps
- New here? Start with creating and verifying a GSC property.
- Then set up the service account. the step that unblocks everyone.
- Ready to run? Install and do your first inspection.
Sources
- Google Search Console
- URL Inspection API documentation
- Google Search APIs overview
- Service account OAuth (Google Identity)
- About service accounts (Google Cloud IAM)
- Verify site ownership
- Property types: URL-prefix vs Domain
- URL Inspection tool help
- Indexing API (JobPosting/BroadcastEvent only)
- Request indexing / inspect a URL