Google Indexation API

«> TL;DR — The Google Indexing API is a way for site owners to tell Google

“this page changed, please re-crawl it” through code instead of clicking buttons. But here’s the catch most guides skip: Google only officially supports it for job-posting pages and livestream pages. It is not a shortcut to get your blog posts or product pages indexed faster — Google has said so over and over.

» (Traduction) (Résumé en français de la section trois, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

Ce que the Indexation API is

Quand vous publish or modifier une page, vous normally wait pour Google à come back et re-explorer il on son propre schedule. Le Indexation API est a façon à push a notification à Google à la place — “hey, ce URL est new/updated” or “ce URL est gone, drop il.” Vous faire il avec code (a petit program appel Google’s serveurs), pas par clicking autour dans a dashboard.

Que sounds powerful, et il est — pour le exact choses c’est construit pour.

The un chose to comprendre

Google seulement officially supports the Indexation API pour two kinds of pages:

1. Job postings — pages avec JobPosting données structurées (job listings, qui expire et besoin à come bas quickly).
2. Livestreams — pages avec BroadcastEvent données structurées (actif video events, qui seulement matter during le broadcast).

c’est il. Les deux sont time-sensitive contenu que goes stale rapide, qui est pourquoi Google construit a rapide lane pour les.

Si vous don’t have job listings or livestreams, the Indexation API n’est pas votre outil — aucun matter ce que a “get indexed in hours” plugin or SaaS indique vous.

The myth to ignore

Le unique biggest myth online est: “Utiliser le Indexation API à obtenir quelconque page indexé rapide.” Il ne fait pas fonctionner que façon, et Google a repeatedly appelé en utilisant il pour normal pages misuse. Personnes faire il anyway parce que outils sell il as a growth hack — mais Google peut (et dit il va) revoke votre accès pour abusing il.

il y a a deuxième trap, aussi: quand vous submit une URL et obtenir a “success” réponse, que seulement signifie Google reçu votre requête. Il fait pas signifier lune page obtenu indexé. Plenty de outils blur que line; Google’s propre docs sont clair à propos de il.

Que faire à la place pour faster indexation

Pour regular pages (blogs, produits, articles), le choses que en réalité aider sont boring mais réel:

• Submit an XML sitemap dans la recherche Google Console.
• Lien to votre nouveau pages from autre pages on votre site.
• Faire lune page genuinely worth indexation (quality, pas thin filler).
• Pour a one-off, utiliser “Request indexing” in Search Console’s Inspection d’URL outil — sparingly.

Vouloir le technique version — setup, le réel API méthodes, quotas, et le exact Google citations? Switch à le Avancé tab.

«> TL;DR — The Indexing API is a Google Cloud–authenticated REST API (v3) that

accepts URL_UPDATED and URL_DELETED notifications. Google officially supports it only for JobPosting and BroadcastEvent-in-VideoObject (livestream) pages — not general content. A 200 from the status endpoint confirms receipt, not indexing. Google’s stance has hardened over years: 2022 (“doesn’t make sense”) → Sept 2024 (a spam warning added to the docs) → May 2025 (Mueller: “spammers misuse the Indexing API… use it properly, or not use it”). Misuse, including multiple accounts to inflate quota, can get access revoked. For general pages, your levers are sitemaps, internal links, quality, and occasional GSC “Request indexing” — and remember Google does not support IndexNow.

» (Traduction) (Résumé en français de la section vingt et un, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

Ce que the Indexation API en réalité is

Le Indexation API est a programmatic push channel: a REST API (v3), authenticated via a Google Cloud service account, que vous appel à tell Google une URL était ajouté/mis à jour (URL_UPDATED) or devrait être supprimé (URL_DELETED). Il sits alongside sitemaps et Search Console as a façon pour Google à découvrir et refresh URLs — mais c’est le narrowest de le bunch par contenu type.

Dans mon Comment Recherche Fonctionne deck, Je liste le Indexation API as une URL-discovery source avec le balise “limited use cases” — qui est le entier story dans deux words. c’est réel, il fonctionne, et c’est seulement sanctioned pour a sliver de le web.

Ce que Google officially supports it pour

«This is the load-bearing fact, so I’ll state it the way Google does. The Indexing API “can only be used to crawl pages with either JobPosting or BroadcastEvent embedded in a VideoObject.” That’s it — two structured-data types:

» (Traduction) (Résumé en français de la section vingt-six, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

• JobPosting — job-listing pages. Ils expire, et stale jobs sont a mauvais utilisateur experience, donc timely ajouter/supprimer matters.
• BroadcastEvent dans a VideoObject — livestream event pages. ils sont seulement pertinent during (et simplement autour) le broadcast.

Pourquoi seulement ces deux? Les deux sont inherently time-sensitive et court-lived. Le rationale Google donne est que rapide notification de changements matters far plus pour ces que pour evergreen pages, qui le normal explorer handles fine.

Comment cela fonctionne

Prerequisites

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

• A Google Cloud project avec le Indexation API enabled. As Google puts il, vous “besoin à tell Google sur votre client et activate access à le API.”
• A service account avec a JSON clé fichier, stored securely.
• Search Console verification de le site, alors ajouter votre service account as a delegated site owner.
• OAuth: “Chaque appel à le Indexation API doit être authenticated avec an OAuth token que vous obtenir dans exchange pour votre privé clé,” en utilisant le scope https://www.googleapis.com/auth/indexing.

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

«- URL_UPDATED — “To notify Google of a new URL to crawl or that content at a previously-submitted URL has been updated.” POST the URL with "type": "URL_UPDATED". A successful call gets an HTTP 200 — Google’s own wording is that this “means that Google may try to recrawl this URL soon,” not that it will, or that the crawl will result in indexing. » (Traduction) (Résumé en français de la section trente-quatre, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.) «- URL_DELETED — before you request removal, Google requires that “the URL must return a 404 or 410 status code or the page must contain” a noindex meta tag — it’s an either/or, not “delete the page and also add noindex.” Once that’s true, POST the URL with "type": "URL_DELETED" so Google drops it. » (Traduction) (Résumé en français de la section trente-quatre, sous-partie deux : le texte source est conservé pour vérification lors de la relecture francophone.) «- Status (GET) — returns metadata (latest_update, latest_remove, notify_time). The critical caveat, verbatim: the GET request “only returns whether you successfully submitted a request.” It does not tell you whether Google actually indexed or removed anything. » (Traduction) (Résumé en français de la section trente-quatre, sous-partie trois : le texte source est conservé pour vérification lors de la relecture francophone.) «- Batching — to cut down on HTTP connections, you can “combine up to 100 calls to the Indexing API into a single HTTP request.” Quota is still counted per URL: 10 requests in one batch still uses 10 requests of quota. » (Traduction) (Résumé en français de la section trente-quatre, sous-partie quatre : le texte source est conservé pour vérification lors de la relecture francophone.)

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 et URL_DELETED calls combined. Ce est le number la plupart guides cite.
• 180 getMetadata (status) requêtes/minute per project.
• 380 requêtes/minute per project à travers tout endpoints combined.

«All three are described as “initial default quota for testing” — going beyond them “requires additional approval for usage and resource provisioning,” via a request form, and Google notes “the quota may increase or decrease based on the document quality.” The common “hack” of spinning up multiple service accounts or projects to inflate the daily quota is exactly what Google forbids (see below). » (Traduction) (Résumé en français de la section trente-huit, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

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

Court réponse: aucun, pas dans a pris en charge façon — et Google a été remarkably consistent et increasingly blunt à propos de il.

Le docs carry a spam warning. Autour September 2024, Google ajouté langue à le quickstart making le stance explicit: “Tout submissions via le Indexation API undergo rigorous spam detection,” et “quelconque attempts à abuse le Indexation API, notamment le utiliser de plusieurs accounts or autre signifie à exceed usage quotas, peut résultat dans accès étant revoked.”

Le reps ont said il pour années. Back dans Peut 2022, John Mueller framed il avec his construction-vehicles analogy: le API “est meant pour very spécifique kinds de contenu,” et en utilisant il elsewhere “ne fait pas vraiment faire sense.” Par Peut 2025 le tone était sharper — Mueller: “Nous voir a lot de spammers misuse le Indexation API comme ce, donc je voudrais recommend simplement sticking à le documented & pris en charge utiliser-cases,” et “je voudrais simplement utiliser il correctement, or pas utiliser il. Si nous wanted à suggest que personnes pourrait utiliser il regardless, nous’d document il as tel.”

Que arc — 2022 “doesn’t make sense” → 2024 spam warning dans le docs → 2025 “spammers misuse… use it properly or not use it” — est a multi-year modèle, pas a un-off. Coverage a aussi noted le API obtient effectively inundated par bloggers et SEOs treating normal sites as si ils qualified.

Le réel risque, stated precisely. Mueller arrête court de promising an algorithmic penalty. Le honest framing est: c’est unsupported et contre le guidelines, contenu pushed dans improperly peut pas stay indexé, et votre accès peut être revoked. ne pas overstate il as a guaranteed manual action — mais ne pas pretend c’est gratuit, soit.

The status-endpoint myth

«This one deserves its own line because so many tools get it wrong: a successful submission is receipt confirmation, not an indexing promise. The status GET “only returns whether you successfully submitted a request.” If a dashboard shows you a green “indexed” badge off the back of a 200, it’s inferring something the API never told it. » (Traduction) (Résumé en français de la section quarante-six, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

Indexation API vs Requête Indexation vs IndexNow

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

• Indexation API (Google): programmatic, mais contenu-restricted à JobPosting/BroadcastEvent. Le narrowest de le three.
• Requête Indexation (GSC Inspection d’URL): fonctionne pour quelconque page vous propre, mais c’est manual, un URL à a temps, et meant pour occasional utiliser — et c’est a requête, pas a guarantee.
• IndexNow: le ouvrir, cross-moteur push protocol (Bing, Yandex, Yep, Seznam, Naver) — et Google ne fait pas utiliser il. c’est le cross-moteur analog à le Indexation API, et le un Je en réalité champion: Je helped ship le IndexNow integration dans Ahrefs Site Audit. Mais il ne fait pas reach Google.

(Complet breakdown in the Frameworks tab.)

Que faire à la place pour general pages

Si vous êtes pas posting jobs or livestreams, le Indexation API n’est pas votre outil, et Google a said donc repeatedly. Votre réel Google levers sont le unglamorous ones:

• Sitemaps — pour coverage et discovery.
• Lien internes — orphan pages struggle; lié pages obtenir trouvé.
• Qualité du contenu — Google decides qu’est-ce que worth indexation; thin pages stall à “Discovered – currently not indexed” aucun matter comment difficile vous push les.
• GSC “Request indexing” — pour genuine un-offs, sparingly.

Pour cross-moteur pushing (Bing et friends, pas Google), IndexNow est le correct outil. Et si vous care à propos de pourquoi pages ne sont pas getting indexé dans le premier placer, c’est a explorer-frequency et qualité question, pas an API question.

AI summary

A condensed prendre on the Avancé version:

• Ce que c’est: a Google Cloud–authenticated REST API (v3) pour pushing URL_UPDATED / URL_DELETED notifications à Google.
• Le un fact que matters: officially pris en charge seulement pour JobPosting et BroadcastEvent (livestream) pages — pas general contenu. Les deux sont time-sensitive par design.
• Le #1 myth: “it indexes any page fast.” Il ne fait pas; Google calls broader utiliser misuse. A successful submission seulement confirms Google reçu la requête, pas que n’importe quoi était indexé.
• Google’s stance hardened over temps: 2022 “doesn’t make sense” → Sept 2024 spam warning ajouté à le docs → Peut 2025 Mueller “spammers misuse… utiliser il correctement, or pas utiliser il.”
• Risque: unsupported/contre guidelines; plusieurs accounts à beat le ~200/day quota peut obtenir accès revoked. Pas necessarily a manual penalty — mais contenu peut pas stick.
• Pas le même as IndexNow (cross-moteur, Bing/Yandex/etc. — Google ne fait pas utiliser il) or GSC Requête Indexation (quelconque page, manual, occasional).
• Pour normal pages: sitemaps + lien internes + qualité + occasional GSC Requête Indexation.

«## Official documentation » (Traduction) (Résumé en français de la section soixante-deux, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«Primary-source documentation from Google. » (Traduction) (Résumé en français de la section soixante-trois, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«Google — Indexing API » (Traduction) (Résumé en français de la section soixante-quatre, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.) «- Indexing API Quickstart — the overview, the JobPosting/BroadcastEvent restriction, and the spam-detection warning. » (Traduction) (Résumé en français de la section soixante-quatre, sous-partie deux : le texte source est conservé pour vérification lors de la relecture francophone.) «- How to Use the Indexing API — the URL_UPDATED / URL_DELETED methods and the status-endpoint caveat. » (Traduction) (Résumé en français de la section soixante-quatre, sous-partie trois : le texte source est conservé pour vérification lors de la relecture francophone.) «- Prerequisites — Cloud project, service account, OAuth scope, and Search Console delegated ownership. » (Traduction) (Résumé en français de la section soixante-quatre, sous-partie quatre : le texte source est conservé pour vérification lors de la relecture francophone.) «- Quota and pricing — the default quota (200) and the approval needed for more. » (Traduction) (Résumé en français de la section soixante-quatre, sous-partie cinq : le texte source est conservé pour vérification lors de la relecture francophone.)

«Google — context for general pages » (Traduction) (Résumé en français de la section soixante-cinq, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.) «- Ask Google to recrawl your URLs — sitemaps and the Search Console “Request indexing” path for normal content. » (Traduction) (Résumé en français de la section soixante-cinq, sous-partie deux : le texte source est conservé pour vérification lors de la relecture francophone.) «- In-Depth Guide to How Google Search Works — where URL discovery and the crawl → index → serve pipeline fit. » (Traduction) (Résumé en français de la section soixante-cinq, sous-partie trois : le texte source est conservé pour vérification lors de la relecture francophone.)

«## Quotes from the source » (Traduction) (Résumé en français de la section soixante-huit, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

On-le-record statements depuis Google. Chaque lien est a deep lien que jumps à le quoted passage on le page source.

Google docs — the restriction

«- “The Indexing API can only be used to crawl pages with either JobPosting or BroadcastEvent embedded in a VideoObject.” — Google Search Central, Indexing API Quickstart. Jump to quote » (Traduction) (Résumé en français de la section soixante-onze, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.) «- “The Indexing API allows site owners to directly notify Google when their job posting or livestreaming video pages are added or removed.” Jump to quote » (Traduction) (Résumé en français de la section soixante-onze, sous-partie deux : le texte source est conservé pour vérification lors de la relecture francophone.)

Google docs — le spam warning (ajouté à le documentation autour September 2024)

«- “All submissions through the Indexing API undergo rigorous spam detection.” Jump to quote » (Traduction) (Résumé en français de la section soixante-treize, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.) «- “Any attempts to abuse the Indexing API, including the use of multiple accounts or other means to exceed usage quotas, may result in access being revoked.” Jump to quote » (Traduction) (Résumé en français de la section soixante-treize, sous-partie deux : le texte source est conservé pour vérification lors de la relecture francophone.)

Google docs — le status-endpoint caveat (myth-buster)

«- “The GET request doesn’t tell you when Google indexes or removes a URL; it only returns whether you successfully submitted a request.” — Google Search Central, How to Use the Indexing API. Jump to quote » (Traduction) (Résumé en français de la section soixante-quinze, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

Google docs — quota

«- “The default value is set to 200.” (publish requests/day) — Google Search Central, quota & pricing. Jump to quote » (Traduction) (Résumé en français de la section soixante-dix-sept, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.) «- “The default value is set to 180.” (getMetadata status requests/minute) and “The default value is set to 380.” (all endpoints/minute) — the two other quota dimensions most guides skip. Jump to 180 · Jump to 380 » (Traduction) (Résumé en français de la section soixante-dix-sept, sous-partie deux : le texte source est conservé pour vérification lors de la relecture francophone.) «- “The quota may increase or decrease based on the document quality.” — Google Search Central, quota & pricing. Jump to quote » (Traduction) (Résumé en français de la section soixante-dix-sept, sous-partie trois : le texte source est conservé pour vérification lors de la relecture francophone.)

Google docs — batching et removal

«- “…you can combine up to 100 calls to the Indexing API into a single HTTP request.” — Google Search Central, How to Use the Indexing API. Jump to quote » (Traduction) (Résumé en français de la section soixante-dix-neuf, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.) «- “…the URL must return a 404 or 410 status code or the page must contain” a noindex meta tag — before requesting removal. — Google Search Central, How to Use the Indexing API. Jump to quote » (Traduction) (Résumé en français de la section soixante-dix-neuf, sous-partie deux : le texte source est conservé pour vérification lors de la relecture francophone.) «- “An HTTP 200 response means that Google may try to recrawl this URL soon.” — Google Search Central, How to Use the Indexing API (on URL_UPDATED). Jump to quote » (Traduction) (Résumé en français de la section soixante-dix-neuf, sous-partie trois : le texte source est conservé pour vérification lors de la relecture francophone.)

John Mueller, Recherche Google Advocate — Bluesky, ~May 2025

«- “We see a lot of spammers misuse the Indexing API like this, so I’d recommend just sticking to the documented & supported use-cases.” » (Traduction) (Résumé en français de la section quatre-vingt-un, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.) «- “I’d just use it properly, or not use it. If we wanted to suggest that people could use it regardless, we’d document it as such.” Read the coverage » (Traduction) (Résumé en français de la section quatre-vingt-un, sous-partie deux : le texte source est conservé pour vérification lors de la relecture francophone.)

John Mueller, Google — SEO office-hours, Peut 2022 (le “construction vehicles” framing)

«- “The indexing API is meant for very specific kinds of content. And using it for other kinds of content doesn’t really make sense.” » (Traduction) (Résumé en français de la section quatre-vingt-trois, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.) «- “It’s not that it’s illegal or that it will cause problems if you put construction vehicles on your medical website. But it doesn’t really make sense.” Read the coverage » (Traduction) (Résumé en français de la section quatre-vingt-trois, sous-partie deux : le texte source est conservé pour vérification lors de la relecture francophone.)

Indexation API — cheat sheet

Pris en charge utiliser cas (ce is the whole liste)

The two méthodes

Batching: combine up to 100 calls into un HTTP requête — quota encore counts per URL, pas per batch.

Fast facts

• Par défaut quota a three parties: 200 publish requêtes/day, 180 status (getMetadata) requêtes/minute, 380 requêtes/minute à travers tout endpoints. Quota au-delà que nécessite Google’s approval et peut shift avec document qualité.
• 200 ≠ indexé. A success réponse confirms submission reçu, rien plus.
• Plusieurs accounts à beat le quota = accès revoked (per le docs).
• Auth: Google Cloud project + service account + OAuth, scope https://www.googleapis.com/auth/indexing, service account ajouté as a GSC delegated owner.
• Pas IndexNow (cross-moteur, pas Google). Pas a replacement pour sitemaps or GSC Requête Indexation.

A minimal publish appel (pour pris en charge content seulement)

Ce est le shape de a unique URL_UPDATED notification. Seulement utiliser il pour pages avec JobPosting or BroadcastEvent données structurées — c’est ce que le API est sanctioned pour. Le auth étape (exchanging votre service-account clé pour an OAuth token) est omitted pour brevity; En pratique vous’d utiliser a Google API client library à obtenir le token.

La requête

POST https://indexing.googleapis.com/v3/urlNotifications:publish
Authorization: Bearer <OAUTH_TOKEN>
Content-Type: application/json

{
  "url": "https://example.com/jobs/senior-seo-analyst",
  "type": "URL_UPDATED"
}

To signal a removal (après lune page is gone or noindexed):

{
  "url": "https://example.com/jobs/senior-seo-analyst",
  "type": "URL_DELETED"
}

Checking status — remarque la réponse indique vous seulement que la requête was reçu, pas si anything was indexé:

GET https://indexing.googleapis.com/v3/urlNotifications/metadata?url=https%3A%2F%2Fexample.com%2Fjobs%2Fsenior-seo-analyst
Authorization: Bearer <OAUTH_TOKEN>

A 200 ici signifie “we got your submission” — it is pas a confirmation que Google indexé (or supprimé) l’URL.

Batching plusieurs URLs: vous pouvez combine up à 100 individual calls dans a unique multi-partie HTTP requête à https://indexing.googleapis.com/batch au lieu de firing 100 séparé requêtes — mais quota est encore counted per URL, donc a 100-appel batch encore utilise 100 requêtes de votre daily allowance. Google’s API client libraries (Java, Python, JavaScript, PHP, .NET) handle le batch formatting pour vous; hand-rolling il est rarely worth il.

Indexation API vs Requête Indexation vs IndexNow

Le décision framework: figure out ce que vous ont et qui moteur vous care à propos de, alors pick le channel.

How to choisir

1. Obtenu job postings or livestreams, et vouloir à automate? → Indexation API.
2. Vouloir à push general pages à Bing/Yandex/Yep? → IndexNow.
3. Vouloir Google à recrawl un normal page, une fois? → GSC “Request indexing.”
4. Vouloir general pages indexé à scale on Google? → il y a aucun push button. Sitemaps + lien internes + qualité. (Et patience — voir explorer frequency.)

Le mental model: le Indexation API sounds comme le la plupart powerful de le three parce que c’est an API, mais par contenu type c’est le narrowest. Power et scope ne sont pas le même chose.

Outils

• Google Cloud Console — créer le project, enable le Indexation API, et generate le service-account JSON clé vous’ll authenticate avec.
• Recherche Google Console — Inspection d’URL — pour normal pages, ce est votre réel outil: vérifier comment une URL était exploré/rendu/indexé, et utiliser “Requête indexation” pour occasional un-offs.
• Recherche Google Console — Sitemaps & Coverage — submit sitemaps et voir qu’est-ce que indexé, “Discovered – currently not indexed,” or excluded.
• Google API client libraries — le cleanest façon à handle le OAuth token-exchange pour Indexation API calls (plutôt que hand-rolling JWT signing).
• IndexNow integration (Ahrefs Site Audit, etc.) — pour le cross-moteur push channel (Bing et others, pas Google). Le correct outil quand vous vouloir le programmatic-push behavior personnes wish le Indexation API gave les pour general pages.

Ressources utiles

Mon connexe writing

• Ce que Est Googlebot & Comment Fait Il Fonctionner? — où le Indexation API sits parmi Google’s URL-discovery sources (liens, sitemaps, RSS, GSC, et le API).
• Comment corriger “Discovered – currently not indexed” — le réel “why won’t my pages index” page; le corriger est qualité et lien internes, pas a push API.
• Le Beginner’s Guide à SEO technique — où exploration et indexation fit dans le bigger picture.

Mon speaking

• Comment Recherche Fonctionne (SlideShare) — mon walkthrough de discovery, exploration, rendu, indexation, et classement; l’URL-discovery slide balises le Indexation API “limited use cases.” (Mon standing disclaimer s’applique: “This is my understanding of systems… not going to be 100% complete or accurate.”)

On IndexNow (le cross-moteur sibling — remarque Google fait pas utiliser il)

• IndexNow integration dans Ahrefs Site Audit — le push channel Je en réalité endorse, pour Bing/Yandex/Yep plutôt que Google.
• Comment submit pages à IndexNow dans Site Audit.

Depuis others

• Google Ajoute Spam Warning À Indexation API Documentation (Moteur de recherche Journal, Sept 2024) — documents quand le spam-detection langue went dans.
• Google À nouveau Dit Arrêter En utilisant Indexation API Pour Unsupported Contenu (Moteur de recherche Roundtable, Peut 2025) — Barry Schwartz covers Mueller’s Bluesky warning à arrêter misusing le API.
• Misuse de Indexation API Pourrait Lead à SEO Problèmes (StanVentures, Peut 2025) — reproduces Mueller’s Peut 2025 Bluesky citations verbatim et explique le access-revocation risque.
• Google Réponses Si En utilisant le Indexation API pour a Normal Site web Est Bon or Mauvais (iLoveSEO, Peut 2022) — transcript de Mueller’s “construction vehicles” office-hours framing.
• Google Dit Son Indexation API Est Inundated par Bloggers (Optimixed) — covers comment off-label utiliser par bloggers et SEOs a overwhelmed le API.
• r/TechSEO — le community pour explorer/indexer debugging.

Courant problèmes

Problèmes personnes en réalité exécuter dans avec le Indexation API, dans symptom → causer → corriger order.

«### “I got a 200 response but the page still isn’t indexed” » (Traduction) (Résumé en français de la section cent trente et un, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«- Symptom: The URL_UPDATED call (or the status GET) returns success, but the page never shows up in search, or Search Console still says “Discovered – currently not indexed.” » (Traduction) (Résumé en français de la section cent trente-deux, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.) «- Cause: A 200 only confirms Google received the notification. Per Google’s own docs, the status endpoint “only returns whether you successfully submitted a request” — it doesn’t tell you whether anything was crawled, indexed, or removed. » (Traduction) (Résumé en français de la section cent trente-deux, sous-partie deux : le texte source est conservé pour vérification lors de la relecture francophone.) «- Fix: Stop treating the API response as an indexing confirmation. Check actual indexing status in the URL Inspection tool in Search Console, or the Coverage report. If the page still isn’t indexed after a reasonable wait, the issue is discovery/quality (see “What to do instead” in the Advanced tab), not the API call. » (Traduction) (Résumé en français de la section cent trente-deux, sous-partie trois : le texte source est conservé pour vérification lors de la relecture francophone.)

«### “My Indexing API access got revoked” » (Traduction) (Résumé en français de la section cent trente-trois, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

«- Symptom: Calls that used to work start failing, or Google Cloud/Search Console shows the service account’s access has been pulled. » (Traduction) (Résumé en français de la section cent trente-quatre, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.) «- Cause: Google states plainly that “any attempts to abuse the Indexing API, including the use of multiple accounts or other means to exceed usage quotas, may result in access being revoked.” The most common trigger is submitting non-JobPosting/non-BroadcastEvent pages, or spinning up extra service accounts to get around the ~200/day default quota. » (Traduction) (Résumé en français de la section cent trente-quatre, sous-partie deux : le texte source est conservé pour vérification lors de la relecture francophone.) «- Fix: Audit what you’ve been submitting — if it’s general content (blog posts, product pages, anything without JobPosting or BroadcastEvent structured data), stop. The API is not documented to support it, and Mueller has said directly: “I’d just use it properly, or not use it.” There’s no documented appeal path beyond staying inside the supported use case going forward. » (Traduction) (Résumé en français de la section cent trente-quatre, sous-partie trois : le texte source est conservé pour vérification lors de la relecture francophone.)

«### “Submissions for normal pages don’t seem to do anything” » (Traduction) (Résumé en français de la section cent trente-cinq, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

• Symptom: Vous submit URL_UPDATED pour a regular article or produit page et rien changements — aucun faster explorer, aucun faster indexation.
• Causer: Le contenu type n’est pas un de le deux Google prend en charge. Le Indexation API “peut seulement être utilisé à explorer pages avec soit JobPosting or BroadcastEvent embedded dans a VideoObject.” Submissions à l’extérieur que scope ne sont pas a documented, pris en charge signal.
• Corriger: Ce n’est pas a bug à corriger — c’est le incorrect outil. Pour general pages, utiliser a sitemap, lien internes, et (pour occasional un-offs) “Request indexing” dans Search Console’s Inspection d’URL outil à la place.

«### “I’m hitting the quota limit” » (Traduction) (Résumé en français de la section cent trente-sept, sous-partie un : le texte source est conservé pour vérification lors de la relecture francophone.)

• Symptom: Submissions commencer failing or getting throttled — soit autour 200/day, or En brefer bursts même sous 200/day.
• Causer: Google en réalité enforces three séparé par défaut quotas: 200 publish (URL_UPDATED/URL_DELETED) requêtes per day, 180 status (getMetadata) requêtes per minute, et 380 requêtes per minute à travers tout endpoints combined. A burst de status vérifications peut throttle vous on le per-minute limites bien avant vous hit le daily 200. Going au-delà quelconque de ces “exige additional approval pour usage et resource provisioning,” et Google notes le granted quota “may increase or decrease based on the document quality.”
• Corriger: Si vous êtes legitimately publishing/updating que nombreux JobPosting or BroadcastEvent pages a day, requête a quota augmenter via Google Cloud — ne pas créer supplémentaire service accounts or projects à fonctionner autour il, since c’est explicitly named as le kind de abuse que obtient accès revoked.

Checklists

Avant vous touch the Indexation API

• Confirmer lune pages vous vouloir à submit en réalité carry JobPosting données structurées, or BroadcastEvent embedded dans a VideoObject — le seulement deux contenu types Google prend en charge.
• Si aucun s’applique, arrêter ici. Utiliser sitemaps, lien internes, contenu qualité, et occasional GSC “Request indexing” à la place — pas le API.
• Decide si votre submission volume va realistically fit à l’intérieur le par défaut ~200/day quota, or si vous’ll besoin à requête an augmenter.

Setting it up

• Créer (or choisir) a Google Cloud project et enable le Indexation API dans il.
• Créer a service account et download son JSON clé fichier; store il securely (jamais commit il à a public repo).
• Vérifier votre site dans Search Console si il n’est pas déjà.
• Ajouter le service account’s email as a delegated site owner dans Recherche Console.
• Confirmer vous pouvez exchange le service-account clé pour an OAuth token avec scope https://www.googleapis.com/auth/indexing (typically via a Google API client library plutôt que hand-rolled JWT signing).

Submitting a notification

• Pick le correct méthode: URL_UPDATED pour a nouveau or modifié pris en charge page, URL_DELETED après lune page est gone or noindexed.
• POST l’URL avec le correct type champ à https://indexing.googleapis.com/v3/urlNotifications:publish.
• Treat a 200 réponse as receipt confirmation seulement — pas proof le page était indexé or supprimé.
• Suivre up dans Search Console (Inspection d’URL or Coverage) si vous devez confirmer réel indexation status.

Staying à l’intérieur the guidelines

• Seulement submit JobPosting/BroadcastEvent pages via ce API — rien sinon.
• ne pas créer plusieurs service accounts or projects simplement à exceed le quota; requête a legitimate augmenter à la place.
• Si vous êtes pas certain si une page qualifies, treat que as “il ne fait pas” et utiliser sitemaps/lien internes/Requête indexation pour il à la place.

Quiz

Five questions to vérifier ce que en réalité stuck à propos de the Indexation API.

Journal des modifications