Come verificare la posizione delle keyword con le API di Google (guida 2026)

Provare a verificare la posizione di una keyword con le API di Google è uno di quei compiti che sembrano già risolti finché non ci si mette davvero le mani. Non esiste un endpoint rankings.get(), e le due API di Google a cui ci si rivolge per prime rispondono ciascuna a una domanda leggermente diversa da quella che ci si pone. La documentazione Search Analytics di Search Console è il punto di partenza giusto, a patto di capire cosa significhi lì "posizione".

Google ha un'API ufficiale per il posizionamento delle keyword?

No. Google non ha mai rilasciato un'API che accetti una keyword e restituisca la tua posizione in tempo reale su google.com. È una scelta voluta: l'interrogazione automatizzata della pagina dei risultati è vietata dai termini di Google, e l'azienda non ha alcun interesse commerciale a fornire un'infrastruttura di rank tracking.

Esistono invece tre strade parziali, ognuna con un limite netto:

Come ottengo le posizioni delle keyword dall'API di Search Console?

Interroga l'endpoint searchAnalytics con la dimensione query e leggi il campo position. Sono dati di prima parte, direttamente da Google, gratuiti e senza limiti di keyword: ottieni ogni query per cui il tuo sito ha ricevuto impressioni.

La richiesta funzionante, in Python:

from google.oauth2 import service_account
from googleapiclient.discovery import build

creds = service_account.Credentials.from_service_account_file(
    "service-account.json",
    scopes=["https://www.googleapis.com/auth/webmasters.readonly"],
)
service = build("searchconsole", "v1", credentials=creds)

response = service.searchanalytics().query(
    siteUrl="https://example.com/",
    body={
        "startDate": "2026-07-01",
        "endDate": "2026-07-31",
        "dimensions": ["query", "page"],
        "rowLimit": 25000,
    },
).execute()

for row in response.get("rows", []):
    query, page = row["keys"]
    print(f"{row['position']:.1f}  {query}  ->  {page}")

I tre limiti che colgono tutti di sorpresa

• La posizione è una media, non un ranking. Un valore di 7,4 non significa che sei in posizione 7: significa che le impressioni si sono distribuite su posizioni con una media di 7,4, magari da 3 a 15 a seconda di dispositivi e località.
• Solo il tuo sito. Non c'è modo di vedere la posizione di un concorrente. Search Console è un'API limitata per definizione alla singola proprietà.
• Le keyword senza impressioni sono invisibili. Se sei in posizione 60 e nessuno è sceso fin lì, la query non compare proprio nei dati.

È proprio il terzo punto a compromettere silenziosamente il reporting. Una keyword per cui non sei ancora entrato nelle prime pagine semplicemente non esiste in Search Console, il che rende impossibile misurare i progressi dalla posizione 60 alla posizione 20 con questa sola API.

Posso usare la Custom Search JSON API per controllare il posizionamento?

Tecnicamente sì, in pratica no. La Custom Search JSON API richiede di creare prima un Programmable Search Engine. Anche se lo configuri per cercare su tutto il web, applica un proprio ranking e proprie restrizioni, quindi l'ordine che restituisce non è quello di google.com.

Inoltre è limitata a 100 query al giorno nel piano gratuito, con l'uso a pagamento fatturato ogni mille query e un tetto giornaliero. Per una manciata di keyword controllate di tanto in tanto può andare. Come rank tracker, invece, produce numeri che sembrano autorevoli ma sono silenziosamente sbagliati, il che è peggio che non avere alcun dato.

E fare scraping direttamente su Google?

Non farlo. L'interrogazione automatizzata di Google Search senza autorizzazione è contraria ai Termini di servizio di Google e, a qualsiasi volume, porta a blocchi dell'IP e a muri di CAPTCHA. Al di là della questione delle policy, la realtà tecnica è sgradevole: i risultati sono personalizzati, localizzati e sempre più composti con funzionalità di IA, quindi una "posizione" ottenuta con lo scraping varia in base al data center, alla località e alla sessione, anche quando sul tuo sito non è cambiato nulla.

Se ti servono le posizioni dei concorrenti, una SERP API commerciale è la strada che è al tempo stesso legale secondo gli accordi del fornitore e stabile dal punto di vista operativo. È una voce di costo, e quel costo è il prezzo onesto di dati che Google non regala. Le aziende che hanno bisogno di costruire e monitorare questa pipeline senza assumere internamente si affidano di solito a uno specialista; il nostro confronto delle 10 migliori agenzie di data analytics in Francia elenca fornitori che impostano questo tipo di reporting.

Cosa conviene costruire davvero?

Per la maggior parte dei team l'architettura più pragmatica è ibrida, e si presenta così:

• L'API di Search Console come spina dorsale. Gratuita, con keyword illimitate, di prima parte, ed è l'unica fonte che ti dice per cosa stai davvero ottenendo impressioni.
• Una SERP API per un piccolo insieme selezionato di keyword. I tuoi venti o trenta termini commercialmente critici, controllati ogni giorno, comprese le posizioni dei concorrenti.
• Un livello di visibilità nell'IA. Sempre più spesso la domanda non è solo "in che posizione sono" ma "vengo citato quando qualcuno chiede a un assistente". Le classiche API di posizionamento non rispondono a nulla di tutto questo.

I team che preferiscono non progettare tutto questo da soli lo affidano di solito a uno specialista; il nostro confronto delle 10 migliori agenzie SEO in Francia presenta fornitori che gestiscono questo stack di reporting per i propri clienti.

Quest'ultimo punto non è una preoccupazione per il futuro. Quando una risposta dell'IA risolve la query direttamente nell'interfaccia, la posizione dieci e la posizione tre portano allo stesso risultato: nessun clic. Monitorare le citazioni insieme alle posizioni è esattamente ciò per cui sono pensati il nostro server MCP per Search Console e la nostra piattaforma di visibilità nell'IA, e la documentazione spiega la configurazione dall'inizio alla fine.

Conclusione

Non esiste un'API ufficiale di Google per le posizioni delle keyword in tempo reale: usa l'API di Search Console per i tuoi dati medi, una SERP API di terze parti per le posizioni esatte e quelle dei concorrenti, e lascia perdere del tutto la Custom Search JSON API per il monitoraggio del posizionamento. Costruire sulla soluzione sbagliata è l'errore più comune in questo ambito, e produce una dashboard che è inesatta con grande sicurezza.

Se preferisci non costruire e mantenere da solo questa pipeline, Sorank collega la tua Search Console e monitora le citazioni nell'IA in un unico posto.