Google Indexing API spiegata: la soluzione GSC da provare per prima
Di Toy Wen Da, Co-founder · Aggiornato · 7 min di lettura
Tradotto dall'originale in inglese. Leggilo in inglese
La Google Indexing API ti permette di comunicare direttamente a Google quando una pagina è nuova, aggiornata o eliminata. Google aggiunge poi l'URL a una coda di scansione prioritaria, invece di aspettare di scoprire il cambiamento da solo. L'API accelera la scansione, ma non garantisce nulla sull'indicizzazione. Se una pagina mostra "Rilevata, attualmente non indicizzata" (Discovered, currently not indexed), prova prima lo strumento gratuito Controllo URL (URL Inspection) di Search Console.
Cosa fa e cosa non fa l'API
Invii a Google un URL insieme a un tipo di notifica, URL_UPDATED oppure URL_DELETED. Google mette l'URL in coda per la scansione con una priorità più alta rispetto alla sua normale pianificazione basata sulla sitemap, e il crawler deve comunque visitare la pagina e decidere se merita un posto nell'indice.
Diverse cose sono fuori dalla portata dell'API:
- Non può indicizzare direttamente un URL e non può scavalcare i segnali di qualità di Google, quindi una pagina scarna o duplicata non entrerà più in fretta.
- Non ha alcun effetto sul posizionamento, perché riguarda solo la scansione.
- Non sostituisce la tua sitemap, che deve continuare a contenere la maggior parte dei tuoi URL.
- Non è supportata ufficialmente per ogni tipo di contenuto. In pratica accetta anche altri URL, ma Google non ha promesso che continuerà a funzionare così.
L'equivoco più comune è pensare che un invio andato a buon fine significhi che la pagina verrà indicizzata. L'API fa sì che Google noti la pagina prima, ma nulla in essa fa sì che Google la voglia.
Prima vedi il problema: simula Googlebot
Prima di toccare Search Console o qualsiasi API, controlla cosa vede Googlebot quando visita la pagina. Molti problemi di "indicizzazione" sono in realtà problemi di rendering o di blocco: un tag noindex rimasto attivo per errore, una regola del robots.txt o contenuti JavaScript che non si caricano mai per un crawler.
Fai passare la pagina dal Googlebot Simulator gratuito. Mostra l'HTML renderizzato, i codici di stato e le eventuali direttive di blocco così come le incontra il crawler di Google. Se emerge un tag noindex o una risorsa bloccata, correggerlo ti servirà più di qualsiasi chiamata API.
Risolvi prima in Google Search Console
Per quasi ogni problema del tipo "la mia pagina non si indicizza", gli strumenti di Search Console sono il punto di partenza giusto. La sequenza qui sotto copre l'intero processo.
Passaggio 1: controlla l'URL
Apri Google Search Console, seleziona la tua proprietà e incolla l'URL interessato nello strumento Controllo URL (URL Inspection) in cima alla pagina. Ti dice se l'URL è su Google, se esiste una versione sottoposta a scansione e quale URL canonico ha scelto Google.
Passaggio 2: leggi con attenzione lo stato
Lo stato di copertura che Search Console riporta ti indica cosa fare dopo.
| Stato in Search Console | Cosa significa | Cosa fare |
|---|---|---|
| Inviata e indicizzata (Submitted and indexed) | La pagina è presente nell'indice di Google | Nessuna azione necessaria |
| Scansionata, attualmente non indicizzata (Crawled, currently not indexed) | Google l'ha visitata ma ha scelto di non indicizzarla | Migliora la qualità dei contenuti, verifica la presenza di duplicati |
| Rilevata, attualmente non indicizzata (Discovered, currently not indexed) | Google conosce l'URL ma non l'ha ancora scansionato | Richiedi l'indicizzazione; sui siti grandi controlla il crawl budget |
| URL sconosciuto a Google (URL is unknown to Google) | Mai visto prima | Invialo tramite sitemap e richiedi l'indicizzazione |
| Bloccata dal file robots.txt (Blocked by robots.txt) | Il crawler non è autorizzato | Modifica il robots.txt |
| Pagina alternativa con tag canonico corretto (Alternate page with proper canonical tag) | Google ha indicizzato come canonico un altro URL | Verifica la presenza di contenuti duplicati o quasi duplicati |
Passaggio 3: richiedi l'indicizzazione
Se il controllo mostra che la pagina non è indicizzata, clicca su Richiedi indicizzazione (Request Indexing). Google mette l'URL in coda per una scansione prioritaria, in modo simile a quanto fa con l'API, e l'opzione è gratuita e si trova nella console che già usi.
Passaggio 4: ricontrolla più avanti e non esagerare con le richieste
Aspetta qualche giorno prima di fare una nuova richiesta per lo stesso URL. Richieste ripetute sulla stessa pagina non accelerano nulla e possono sembrare una manipolazione ai sistemi di Google.
Quando Google Search Console basta e quando no
Search Console basta in questi casi:
- Hai una o poche pagine bloccate in "Rilevata, attualmente non indicizzata".
- Hai appena pubblicato qualcosa e vuoi che venga controllato più in fretta.
- Il tuo sito ha qualche centinaio o qualche migliaio di URL, ben entro il normale crawl budget.
Ti serve qualcosa di più, cioè l'Indexing API o un servizio basato su di essa, in questi casi:
- Gestisci un sito di annunci di lavoro o di eventi con pagine idonee ai tipi di schema
JobPostingoBroadcastEventche l'API supporta ufficialmente. - Gestisci una sitemap molto grande, con decine di migliaia di URL, in cui le pagine nuove restano sepolte per settimane prima che la scansione pianificata di Google le raggiunga. Un caso documentato riguarda un sito e-commerce con 80.000 URL di prodotto in cui le nuove schede aspettavano circa due settimane per la prima scansione, e l'invio tramite API ha ridotto l'attesa a meno di sei ore.
- Stai migrando dominio e hai bisogno che Google abbandoni rapidamente il vecchio canonico. Un blogger passato da un sottodominio GitHub Pages a un dominio personalizzato ha scoperto che le richieste manuali in Search Console non hanno spostato la scelta del canonico di Google in 30 giorni, ed è in parte per questo che alcuni sviluppatori automatizzano con script gli invii in blocco.
- Devi eseguire il processo ogni giorno anziché una volta sola.
- Vuoi che le rimozioni vengano recepite rapidamente. Le notifiche
URL_DELETEDsono un modo pulito per dire a Google che un annuncio scaduto o un prodotto rimosso non esiste più.
Se nessuno di questi casi fa al tuo caso, resta sulla strada gratuita. Costruire l'autenticazione API per un singolo articolo del blog bloccato è molto lavoro di sviluppo per un problema che Search Console risolve in due clic.
Come funziona l'API in parole semplici
Se rientri davvero nell'approccio più impegnativo, la configurazione richiede cinque passaggi, e nessuno di essi richiede codice fino all'ultimo.
- Crea un progetto Google Cloud e abilita al suo interno la Indexing API.
- Crea un account di servizio e scarica la sua chiave privata, che è un file JSON.
- Aggiungi quell'account di servizio come Proprietario (Owner) nelle autorizzazioni utente della tua proprietà di Search Console. Quasi tutti sbagliano questo passaggio la prima volta, e saltarlo fa sì che ogni chiamata API restituisca un errore 403.
- Attendi la propagazione dei permessi, che può richiedere da pochi minuti a qualche ora prima che le chiamate comincino ad andare a buon fine.
- Invia gli URL con tipo di notifica
URL_UPDATEDoppureURL_DELETED, autenticandoti con un token OAuth ottenuto in cambio della tua chiave privata.
Uno script che fa tutto questo ha di solito le stesse poche parti: un modulo di autenticazione che carica la chiave, una funzione che invia un URL e riprova in caso di errore, e un ciclo principale che legge gli URL dalla tua sitemap e li invia restando sotto la quota giornaliera.
Ogni progetto ha una quota predefinita di 200 richieste di pubblicazione al giorno, con aggiornamenti e rimozioni conteggiati insieme, più 180 richieste di metadati e 380 richieste totali al minuto. Il limite giornaliero si azzera a mezzanotte, ora del Pacifico. Un aggiornamento della documentazione di ottobre 2026, riportato da Search Engine Journal, ha rimosso il modulo di richiesta di approvazione e i passaggi per chiedere una quota più alta, e Google non ha detto se il requisito di approvazione in sé sia cambiato. Se stai pianificando in base a un aumento di quota, consulta la pagina attuale delle quote della Google API Console invece delle vecchie guide.
Diversi strumenti commerciali racchiudono questa stessa API in una dashboard, così non devi scrivere tu il codice di autenticazione. In genere richiedono un canone mensile o per progetto e dichiarano tempi medi di indicizzazione di un paio di minuti, anche se i risultati dipendono comunque dalla coda di scansione di Google e dalla qualità della pagina.
Quando l'API è lo strumento sbagliato
Lasciala perdere per i contenuti evergreen, per le pagine che Google ha già scansionato e scartato e per qualsiasi sito in cui una sitemap pulita e una buona struttura di link interni fanno già raccogliere i nuovi URL in tempi ragionevoli. Per questi siti le alternative sono una sitemap inviata in Search Console e la Richiesta di indicizzazione manuale per qualche pagina occasionale. La sitemap è il percorso principale di scoperta per i tuoi URL in blocco, mentre l'API è una corsia prioritaria per pagine specifiche.
Errori comuni da evitare
- Pensare che invio equivalga a indicizzazione. L'API mette in coda una scansione e non promette alcun risultato, quindi una pagina scarna o duplicata non si indicizzerà più in fretta perché hai chiamato l'API.
- Saltare il passaggio della proprietà in Search Console. L'account di servizio deve essere Proprietario della proprietà e non un semplice utente, altrimenti ogni chiamata fallisce con un errore 403.
- Usarla su contenuti fuori dai tipi supportati aspettandosi l'affidabilità che Google promette per gli annunci di lavoro e gli eventi in diretta.
- Richiedere l'indicizzazione dello stesso URL in Search Console più volte nel giro di poche ore.
- Trattare l'API come un sostituto della sitemap.
- Caricare la chiave JSON dell'account di servizio in un repository pubblico. Trattala come una password.
Se una pagina continua a non indicizzarsi qualunque richiesta tu faccia, la causa è spesso la qualità dei contenuti o la duplicazione, più che la velocità di scansione. Può aiutarti a verificarlo uno strumento gratuito per confermare il posizionamento delle parole chiave prima di dare per scontato che il collo di bottiglia sia l'indicizzazione.
Domande frequenti
La Google Indexing API garantisce che la mia pagina venga indicizzata?
No. Notifica a Google che un URL è cambiato e chiede una scansione prioritaria. Il crawler di Google visita comunque la pagina e applica i consueti controlli di qualità e pertinenza prima di decidere se indicizzarla.
Posso usare l'Indexing API per qualsiasi tipo di pagina?
Ufficialmente Google dice che l'API supporta le pagine con dati strutturati JobPosting o BroadcastEvent. Molte persone inviano altri tipi di URL e li vedono accettati, ma Google non si è impegnato a far sì che questo continui a funzionare in modo affidabile in futuro.
Qual è il limite giornaliero dell'Indexing API?
Il valore predefinito è di 200 richieste di pubblicazione al giorno per progetto, che comprendono sia aggiornamenti sia rimozioni, con un tetto al minuto di 180 richieste di metadati. Il conteggio giornaliero si azzera a mezzanotte, ora del Pacifico.
Perché l'API restituisce 403 Forbidden?
La causa abituale è che l'account di servizio non è stato aggiunto come Proprietario della proprietà in Search Console. Inoltre i permessi possono impiegare da pochi minuti a qualche ora per propagarsi, quindi una chiamata fatta subito dopo la configurazione può ancora fallire.
L'API può forzare Google a rieseguire la scansione di una pagina?
Chiede una scansione prioritaria, e poi è Google a decidere cosa succede. Scansionare una pagina non obbliga Google a indicizzarla.
Richiedi indicizzazione (Request Indexing) in Search Console è lo stesso dell'Indexing API?
Entrambi mettono un URL in una coda di scansione prioritaria. Richiedi indicizzazione è gratuito, manuale e integrato nella console che già usi, mentre l'API automatizza lo stesso tipo di richiesta su molti URL.
In cosa l'API è diversa dall'invio di una sitemap?
Una sitemap elenca i tuoi URL perché Google li scansioni con i suoi tempi e resta la via principale per la maggior parte delle tue pagine. L'API spinge singoli URL, per esempio quelli nuovi o eliminati, in una coda più rapida.
Perché Google continua a dire "Rilevata, attualmente non indicizzata" anche dopo che ho richiesto l'indicizzazione?
Di solito Google sta dando bassa priorità alla pagina a causa del crawl budget, della qualità percepita dei contenuti o della somiglianza con altre pagine del tuo sito. Correggere la pagina in sé spesso è più efficace che ripetere gli invii.
Parla con il team
Inseguire un singolo URL bloccato con Search Console richiede circa cinque minuti. Inseguire i problemi di indicizzazione su un intero sito, settimana dopo settimana, è un uso poco sensato di chiamate API lanciate a mano. Se vuoi un quadro chiaro di quali pagine sono indicizzate, quali sono bloccate e perché, parla con il team e ricevi un report di esempio costruito sul tuo sito.
Letture correlate: Search Console API: How to Get Access and What It Returns.
Fonti
Sull'autore
SearchBlueprint ha ricercato, scritto e valutato questo articolo con la stessa pipeline di contenuti che i nostri clienti usano sui loro siti. Il punteggio indicato nella firma è quello che il nostro motore di contenuti ha assegnato a questa pagina prima della pubblicazione. Nulla qui è rivisto a mano, ed è proprio questo il punto: è il risultato del prodotto, pubblicato dove chiunque può verificarlo.