I team che cercano un'API di posizionamento di Google di solito vogliono una cosa precisa: una chiamata che restituisca in che posizione si trova una pagina per una parola chiave. Google non pubblica questa cosa.
Quello che Google pubblica è un insieme di API che descrivono le tue prestazioni, lo stato del tuo indice e la tua situazione di scansione. Sono davvero utili e sono tutte gratuite. Sono anche strutturalmente incapaci di rispondere alla domanda con cui la maggior parte delle persone arriva a questa ricerca.
Abbiamo passato una giornata a misurare cosa restituiscono davvero quelle API su una proprietà dal vivo, comprese le parti facili da leggere male. Tre risultati si sono distinti: i dati arrivano con tre giorni di ritardo, il numero di posizione è una media che non si riproduce rispetto a un risultato dal vivo, e l'unica API che suona più simile a una verifica di posizionamento restituisce un verdetto che da solo non dice nulla di utile.
Cosa pubblica davvero Google
Quattro superfici vengono confuse con un'API di posizionamento. Ecco a cosa serve ciascuna, secondo la documentazione di Google stessa.
La Search Analytics API restituisce clic, impressioni, CTR e posizione media per una proprietà verificata. È la cosa più vicina ai dati di posizionamento che Google offra, ed è la fonte di ogni numero di "posizione media" in Search Console.
La URL Inspection API restituisce lo stato di indicizzazione di un singolo URL: se Google lo conosce, se è indicizzato e, se non lo è, perché.
La Indexing API sembra inviare pagine all'indicizzazione. La documentazione di Google limita i tipi supportati ai dati strutturati JobPosting e BroadcastEvent, che è un caso d'uso ristretto, non un invio generale all'indice.
La Custom Search JSON API restituisce risultati web per una query. Cerca in un indice che configuri tu, e non ti dice in che posizione sta il tuo sito nei risultati principali di Google.
Nessuna di loro restituisce "la tua posizione per questa parola chiave". Quel lavoro non esiste nella linea di prodotti di Google, e l'assenza è deliberata, non una svista. Google non ha alcun motivo commerciale per distribuire su larga scala i dati di posizionamento dei concorrenti.
Cosa abbiamo misurato: i dati hanno tre giorni
Abbiamo recuperato il dettaglio giornaliero della nostra proprietà il 12 settembre 2026. La data più recente con dei dati era il 9 settembre.
Data disponibile | Righe restituite |
|---|---|
2026-09-02 | sì |
2026-09-03 | sì |
2026-09-04 | sì |
2026-09-05 | sì |
2026-09-06 | sì |
2026-09-07 | sì |
2026-09-08 | sì |
2026-09-09 | sì, la più recente |
Tre giorni di ritardo, in modo costante. Il parametro window conta all'indietro dalla data disponibile più recente e non da oggi, e questa è una piccola trappola: una richiesta di sette giorni restituisce otto date che terminano il 9 settembre, non il 12 settembre.
Per un report mensile è irrilevante. Per la domanda "la modifica di ieri alla pagina ha rotto qualcosa", è squalificante. Nessuna configurazione lo risolve. Il ritardo è dalla parte di Google.
Cosa abbiamo misurato: una posizione media non è un posizionamento
Questo è il risultato più importante, ed è quello che fa credere alle persone che un'API di posizionamento di Google esista e stia solo facendo la ritrosa.
La posizione media è la posizione media del tuo URL su tutte le impressioni del periodo, ponderata su paesi, dispositivi e varianti di query. Una verifica di posizionamento dal vivo restituisce un numero, da una località, su un dispositivo, in un istante. Sono due misure diverse che condividono un nome.
Abbiamo testato lo scarto su 25 query estratte dai nostri dati di Search Console, poi abbiamo verificato le stesse 25 parole chiave contro un SERP dal vivo di Stati Uniti, inglese, desktop, a profondità 100.
Risultato | Conteggio |
|---|---|
Query utilizzabili in entrambi gli insiemi | 23 |
Comparse nella top 100 dal vivo | 14 (61%) |
Avevano impressioni in Search Console ma nessun risultato dal vivo riproducibile | 9 (39%) |
Mediana dello scarto assoluto dove esistevano entrambi | 7,4 posizioni |
Scarto assoluto medio | 8,5 posizioni |
Scarto maggiore | 36,6 posizioni |
Entro 3 posizioni l'una dall'altra | 4 su 14 |
Con uno scarto superiore a 10 posizioni | 4 su 14 |
Dove esistono entrambe le misure, divergono di una mediana di 7,4 posizioni.
Due dettagli contano più delle medie.
Primo, nove delle 23 query hanno prodotto una posizione in Search Console ma nessun risultato dal vivo nella verifica Stati Uniti, inglese, desktop. Non è un bug. Le impressioni si accumulano da altri paesi, altre lingue, altri dispositivi e superfici di immagini o video. Una singola verifica con target geografico non le riprodurrà, e un team che tratta i due numeri come la stessa misura passerà una settimana a inseguire una discrepanza che è un artefatto del metodo.
Secondo, la direzione non è coerente. La maggior parte delle posizioni dal vivo stava sotto la media di Search Console, cosa che ci si aspetta quando la media include superfici con prestazioni migliori. Ma una query si è spostata di 36,6 posizioni nella direzione opposta, da 73,6 a 37. Non c'è alcun fattore di correzione da applicare.
Lo scarto va in entrambe le direzioni, quindi non c'è alcun fattore di correzione da applicare.
La conseguenza pratica per chi sta scegliendo un'API di posizionamento di Google: i dati gratuiti non ti diranno una posizione, e i dati a pagamento non saranno d'accordo con essi. Entrambi misurano correttamente cose diverse. Trattare l'uno come sostituto dell'altro è il punto in cui il reporting va storto.
Dove il lato first-party è davvero insostituibile è nella copertura, che abbiamo misurato separatamente nel confronto tra alternative alle API SERP.
Cosa restituisce invece la URL Inspection API
La URL Inspection API è l'unica superficie di Google che sembra una verifica di posizionamento, perché le dai un URL senza parola chiave e ricevi indietro uno stato. Abbiamo testato due URL.
Stato dell'URL | Verdetto | Stato di copertura | Ora dell'ultima scansione |
|---|---|---|---|
Pubblicato circa un'ora prima | NEUTRAL | URL sconosciuto a Google | Sconosciuta |
Pubblicato circa nove ore prima | NEUTRAL | Scoperto, attualmente non indicizzato | Sconosciuta |
Entrambi hanno restituito lo stesso verdetto. Il campo che distingue davvero i due casi è la stringa di stato di copertura, che è una frase, non un enum. Il campo del verdetto dice NEUTRAL sia per un URL che Google non ha mai visto sia per un URL che ha scoperto ma non indicizzato.
È un'API utilizzabile e un segnale di monitoraggio scarso se presa da sola. Se vuoi un avviso quando una pagina non è indicizzata, analizza lo stato di copertura invece del verdetto, e aspettati che l'ora dell'ultima scansione manchi proprio per gli URL che ti interessano di più.
Le quattro superfici e il lavoro che nessuna di esse fa
Domanda | Superficie Google | Risposta |
|---|---|---|
Come sono andato su questa query la settimana scorsa | Search Analytics API | Sì, con tre giorni di ritardo, come media |
Questo URL è indicizzato | URL Inspection API | Sì, per URL, su richiesta |
Dove sono posizionato adesso per qualsiasi parola chiave | nessuna | No |
Dove sono posizionati i miei concorrenti | nessuna | No |
Che aspetto ha il SERP per una parola chiave su cui non mi posiziono | nessuna | No |
Lo schema è coerente. Le API di Google descrivono la tua proprietà dall'interno. Una domanda di posizionamento si pone dall'esterno, su una pagina di risultati, e Google non fornisce questo.
Come coprire il divario senza pagare troppo
La configurazione pratica sono due fonti con compiti diversi, non una fonte a cui si chiede di fare entrambe le cose.
Usa le API di Google come verità di base sulla tua proprietà. Clic, impressioni e stato di indicizzazione sono fatti first-party che non puoi ottenere altrove, e sono gratuiti. Recuperali secondo un calendario e tratta il ritardo di tre giorni come una proprietà dello strumento.
Usa una fonte SERP per la visione esterna. Posizioni dal vivo, posizioni dei concorrenti e parole chiave su cui non ti posizioni ancora. Questa è la parte a pagamento, ed è più economica di quanto la maggior parte dei team presuma: nel nostro test, verificare 23 parole chiave a profondità 100 è costato $0,2975, cioè $0,0129 per verifica.
Non provare a riconciliare i due numeri. Misurano cose diverse. La mossa utile è leggerli insieme: Search Console ti dice cosa è successo, e una verifica dal vivo ti dice cosa sta succedendo. Quando non concordano, guarda la composizione per paese e dispositivo di quella query prima di concludere qualsiasi cosa.
La meccanica per far girare entrambi da un unico script è nel nostro tracker a due fonti, e il lato costo della metà dal vivo è quantificato nel test di verifica in blocco.
Domande frequenti
Google ha un'API di posizionamento ufficiale? No. Google pubblica API per le tue prestazioni di ricerca (Search Analytics), lo stato di indicizzazione (URL Inspection) e due ristretti tipi di invio (Indexing). Nessuna restituisce una posizione per una parola chiave.
Perché Search Console mostra una posizione se non c'è un'API di posizionamento? Perché la posizione media è una metrica di prestazione calcolata dalle tue impressioni, non una consultazione di posizionamento. È la posizione media su tutte le impressioni del periodo, mediata su paesi, dispositivi e superfici.
Quanto sono indietro i dati di Search Console? Tre giorni nella nostra misura del 12 settembre 2026, con la data disponibile più recente al 9 settembre. Il parametro window conta all'indietro da quella data, quindi una richiesta di sette giorni restituisce otto date che terminano nel giorno disponibile più recente.
La URL Inspection API può dirmi se una pagina è indicizzata? Sì, ed è lo strumento giusto per quel compito. Leggi la stringa di stato di copertura invece del campo del verdetto, perché il verdetto restituisce NEUTRAL sia per un URL sconosciuto sia per un URL scoperto ma non indicizzato.
La Custom Search JSON API è un'API di posizionamento? No. Restituisce risultati da un motore di ricerca che configuri tu, non la tua posizione nei risultati principali di Google.
Qual è il modo più economico per ottenere dati di posizionamento reali? Verifica l'insieme più piccolo di parole chiave su cui agisci davvero, alla profondità che corrisponde a dove ti posizioni. Le verifiche a profondità 10 sono costate $0,002 per parola chiave nel nostro test e a profondità 100 sono costate $0,014, quindi l'impostazione della profondità muove la fattura sette volte più del numero di parole chiave.
Vista Auspia: la risposta onesta a "esiste un'API di posizionamento di Google" è no, e il seguito utile è smettere di cercarla. Le API di Google rispondono bene alle domande first-party e non riescono affatto a rispondere alle domande di posizionamento. Metti in budget una piccola somma per la visione esterna e spendi il resto dello sforzo sulla parte che Google non farà per te, cioè decidere cosa cambiare quando i due numeri non concordano.
Scritto da: Gabriel Finch, ricercatore di recupero della ricerca, revisione di oltre 1.200 risposte AI presso Auspia. Scrive di infrastruttura di ricerca, sistemi di recupero e di cosa ogni fonte di dati riesce davvero a vedere.
