Google Indexation API

Ce que the Google Indexation API en réalité fait — officially pris en charge seulement pour JobPosting and BroadcastEvent (livestream) pages, pas general content. The myths, ce que Google really dit, and ce que to utiliser à la place pour faster indexation.

Première publication : 22 juin 2026 · Dernière mise à jour : 3 août 2026 · Advanced
Langues

The Google Indexation API is a programmatic façon to notify Google que une URL was ajouté, mis à jour, or supprimé — but Google officially supports it seulement pour pages with JobPosting or BroadcastEvent (livestream) données structurées, pas general content. The biggest myth is que it indexes quelconque page fast; it doesn't, and a successful submission seulement confirms Google reçu votre requête, pas que anything was indexé. Google has warned repeatedly que misuse peut obtenir votre accès revoked. Pour normal pages, utiliser sitemaps, lien internes, quality, and the occasional Search Console 'Requête indexation' à la place.

TL;DR — The Indexation API is a Google Cloud–authenticated REST API (v3) que accepts URL_UPDATED and URL_DELETED notifications. Google officially supports it seulement pour JobPosting and BroadcastEvent-in-VideoObject (livestream) pages — pas general content. A 200 from the status endpoint confirms receipt, pas indexation. Google’s stance has hardened over années: 2022 (“doesn’t faire sense”) → Sept 2024 (a spam warning ajouté to the docs) → May 2025 (Mueller: “spammers misuse the Indexing API… use it properly, or not use it”). Misuse, notamment multiple accounts to inflate quota, peut obtenir accès revoked. Pour general pages, votre levers are sitemaps, lien internes, quality, and occasional GSC “Request indexing” — and remember Google fait pas prise en charge IndexNow.

Evidence for this claim Google documents the Indexing API for pages containing JobPosting or BroadcastEvent embedded in VideoObject, not general-purpose web indexing. Scope: Current documented eligibility. Confidence: high · Verified: Google Search Central: Indexing API overview Evidence for this claim An Indexing API notification tells Google that an eligible URL changed or was deleted; it does not guarantee crawling or indexing. Scope: Current API semantics and indexing caveat. Confidence: high · Verified: Google Search Central: Using the Indexing API

Ce que the Indexation API en réalité is

The Indexation API is a programmatic push channel: a REST API (v3), authenticated via a Google Cloud service account, que vous appel to tell Google une URL was ajouté/mis à jour (URL_UPDATED) or devrait be supprimé (URL_DELETED). It sits alongside sitemaps and Search Console as a façon pour Google to découvrir and refresh URLs — but it’s the narrowest of the bunch by content type.

In my How Search Fonctionne deck, I liste the Indexation API as une URL-discovery source with the tag “limited use cases” — qui is the whole story in two words. It’s réel, it fonctionne, and it’s seulement sanctioned pour a sliver of the web.

Ce que Google officially supports it pour

Ce is the load-bearing fact, so I’ll state it the façon Google fait. The Indexation API “peut seulement be utilisé to explorer pages with soit JobPosting or BroadcastEvent embedded in a VideoObject.” That’s it — two structured-data types:

Evidence for this claim Google currently limits the Indexing API to pages with JobPosting or BroadcastEvent embedded in a VideoObject. Scope: official Google documentation, Search Console and production URL verification Confidence: high · Verified: Indexing API Quickstart
  • JobPosting — job-listing pages. Ils expire, and stale jobs are a bad utilisateur experience, so timely ajouter/supprimer matters.
  • BroadcastEvent in a VideoObject — livestream event pages. They’re seulement relevant during (and simplement autour) the broadcast.

Pourquoi seulement ces two? Les deux are inherently time-sensitive and short-lived. The rationale Google donne is que fast notification of changements matters far plus pour ces que pour evergreen pages, qui the normal explorer handles fine.

Comment cela fonctionne

Prerequisites

Setup is non-trivial — ce isn’t a one-click fonctionnalité:

  • A Google Cloud project with the Indexation API enabled. As Google puts it, vous “need to tell Google about your client and activate access to the API.”
  • A service account with a JSON clé fichier, stored securely.
  • Search Console verification of le site, alors ajouter votre service account as a delegated site owner.
  • OAuth: “Every appel to the Indexation API doit be authenticated with an OAuth token que vous obtenir in exchange pour votre private clé,” en utilisant the scope https://www.googleapis.com/auth/indexing.

The two méthodes (plus a status vérifier)

  • URL_UPDATED“To notify Google of a nouveau URL to explorer or que content at a previously-submitted URL has been mis à jour.” POST l’URL with "type": "URL_UPDATED". A successful appel obtient an HTTP 200 — Google’s propre wording is que ce “means that Google may try to recrawl this URL soon,” pas que it va, or que the explorer va result in indexation.
  • URL_DELETED — avant vous requête removal, Google exige que “l’URL doit retourner a 404 or 410 code d’état or lune page doit contain” a noindex meta tag — it’s an soit/or, pas “delete the page and also add noindex.” Une fois that’s vrai, POST l’URL with "type": "URL_DELETED" so Google drops it.
  • Status (GET) — renvoie metadata (latest_update, latest_remove, notify_time). The critical caveat, verbatim: the GET requête “seulement renvoie si vous successfully submitted une requête.” It fait pas tell vous si Google en réalité indexé or supprimé anything.
  • Batching — to cut bas on HTTP connections, vous pouvez “combine up to 100 calls to the Indexation API into a unique HTTP requête.” Quota is encore counted per URL: 10 requêtes in un batch encore uses 10 requêtes of quota.

Quotas

Google’s par défaut quota has three separate dimensions, pas simplement un number:

  • 200 publish requêtes/day per project — covers les deux URL_UPDATED and URL_DELETED calls combined. Ce is the number la plupart guides cite.
  • 180 getMetadata (status) requêtes/minute per project.
  • 380 requêtes/minute per project à travers tout endpoints combined.

Tout three are décrit as “initial default quota for testing” — going au-delà les “requires additional approval for usage and resource provisioning,” via a requête formulaire, and Google notes “the quota may augmenter or decrease fondé on the document quality.” The common “hack” of spinning up multiple service accounts or projects to inflate the daily quota is exactly ce que Google forbids (voir ci-dessous).

Peut vous utiliser it pour normal pages? Ce que Google en réalité dit

Short réponse: aucun, pas in a pris en charge façon — and Google has been remarkably consistent and increasingly blunt à propos de it.

The docs carry a spam warning. Autour September 2024, Google ajouté language to the quickstart making the stance explicit: “Tout submissions via the Indexation API undergo rigorous spam detection,” and “quelconque attempts to abuse the Indexation API, notamment the utiliser of multiple accounts or autre signifie to exceed usage quotas, may result in accès being revoked.”

Evidence for this claim Indexing API submissions undergo spam detection, and quota circumvention or abuse can lead to revoked access. Scope: official Google documentation, Search Console and production URL verification Confidence: high · Verified: Indexing API Quickstart

The reps have said it pour années. Back in May 2022, John Mueller framed it with his construction-vehicles analogy: the API “is meant pour very spécifique kinds of content,” and using it elsewhere “doesn’t really faire sense.” By May 2025 the tone was sharper — Mueller: “We voir a lot of spammers misuse the Indexation API comme ce, so I’d recommend simplement sticking to the documented & pris en charge use-cases,” and “I’d simplement utiliser it correctement, or pas utiliser it. Si we wanted to suggest que personnes pourrait utiliser it regardless, we’d document it as tel.”

Que arc — 2022 “doesn’t make sense” → 2024 spam warning in the docs → 2025 “spammers misuse… use it properly or not use it” — is a multi-year pattern, pas a one-off. Coverage has aussi noted the API obtient effectively inundated by bloggers and SEOs treating normal sites as si ils qualified.

The réel risk, stated precisely. Mueller arrête short of promising an algorithmic penalty. The honest framing is: it’s unsupported and contre the guidelines, content pushed in improperly may pas stay indexé, and votre accès peut be revoked. Don’t overstate it as a guaranteed manual action — but don’t pretend it’s free, soit.

The status-endpoint myth

Ce un deserves its propre line parce que so nombreux outils obtenir it incorrect: a successful submission is receipt confirmation, pas an indexation promise. The status GET “only returns whether you successfully submitted a request.” Si a dashboard montre vous a green “indexed” badge off the back of a 200, it’s inferring something the API jamais told it.

Indexation API vs Requête Indexation vs IndexNow

Three choses obtenir conflated constantly. They’re différent mechanisms:

  • Indexation API (Google): programmatic, but content-restricted to JobPosting/BroadcastEvent. The narrowest of the three.
  • Requête Indexation (GSC Inspection d’URL): fonctionne pour quelconque page vous propre, but it’s manual, un URL at a temps, and meant pour occasional utiliser — and it’s a requête, pas a guarantee.
  • IndexNow: the ouvrir, cross-engine push protocol (Bing, Yandex, Yep, Seznam, Naver) — and Google ne fait pas utiliser it. It’s the cross-engine analog to the Indexation API, and the un I en réalité champion: I helped ship the IndexNow integration in Ahrefs Site Audit. But it doesn’t reach Google.

(Complet breakdown in the Frameworks tab.)

Que faire à la place pour general pages

Si you’re pas posting jobs or livestreams, the Indexation API n’est pas votre outil, and Google has said so repeatedly. Votre réel Google levers are the unglamorous ones:

  • Sitemaps — pour coverage and discovery.
  • Lien internes — orphan pages struggle; lié pages obtenir trouvé.
  • Content quality — Google decides what’s worth indexation; thin pages stall at “Discovered – currently not indexed” aucun matter how hard vous push les.
  • GSC “Request indexing” — pour genuine one-offs, sparingly.

Pour cross-engine pushing (Bing and friends, pas Google), IndexNow is the correct outil. And si vous care à propos de pourquoi pages aren’t getting indexé in the premier placer, that’s a crawl-frequency and quality question, pas an API question.

Add an expert note

Pin an expert quote

New person? Create their unclaimed profile at /admin/experts/ → Pin a quote first.