API Google Search Console: Guida Completa per Automatizzare Report SEO

L'API di Google Search Console apre possibilita enormi per chi vuole andare oltre l'interfaccia web standard. Puoi estrarre dati storici, creare report personalizzati, integrare metriche SEO nei tuoi sistemi e automatizzare analisi che richiederebbero ore di lavoro manuale.

Panoramica delle API disponibili

Google offre diverse API per interagire con Search Console:

1. Search Console API (Search Analytics)

Permette di estrarre dati di rendimento: clic, impressioni, CTR, posizione media per query, pagine, paesi, dispositivi.

2. URL Inspection API

Consente di ispezionare lo stato di indicizzazione di URL specifici programmaticamente.

3. Indexing API

Per siti con contenuti specifici (job posting, livestream), permette di notificare Google di nuovi o rimossi URL.

Configurazione e autenticazione

Per usare le API, devi configurare l'autenticazione OAuth 2.0:

Passo 1: Crea un progetto Google Cloud

1. Vai su console.cloud.google.com
2. Crea un nuovo progetto
3. Abilita l'API "Google Search Console API"

Passo 2: Configura le credenziali

1. Vai su "Credenziali" nel menu
2. Crea credenziali OAuth 2.0
3. Configura la schermata di consenso
4. Scarica il file JSON delle credenziali

Passo 3: Autorizza l'accesso

L'account che autorizza deve avere accesso alla proprieta Search Console che vuoi interrogare.

API Search Analytics

L'API piu usata. Permette query flessibili sui dati di rendimento:

Parametri principali

• startDate / endDate: Intervallo temporale
• dimensions: query, page, country, device, date
• dimensionFilterGroups: Filtri per dimensione
• rowLimit: Numero massimo di righe (max 25.000)

Metriche disponibili

• clicks
• impressions
• ctr
• position

Esempio di richiesta

Richiesta per ottenere le top query degli ultimi 7 giorni:

{
  "startDate": "2026-03-20",
  "endDate": "2026-03-27",
  "dimensions": ["query"],
  "rowLimit": 100
}

API URL Inspection

Permette di verificare lo stato di indicizzazione di URL specifici:

Informazioni ottenibili

• Stato di indicizzazione
• Ultimo crawl
• Canonical rilevato
• Usabilita mobile
• Rich results rilevati

Limiti

• 2.000 richieste al giorno per proprieta
• 600 richieste al minuto

Indexing API

L'Indexing API e diversa: serve a notificare Google di URL nuovi o rimossi.

Chi puo usarla

Originariamente limitata a:

• JobPosting (offerte di lavoro)
• BroadcastEvent (eventi livestream)

Nel 2026, Google ha esteso l'accesso ad altri tipi di contenuto in alcuni casi.

Tipi di notifica

• URL_UPDATED: Nuovo URL o URL modificato
• URL_DELETED: URL rimosso

Quote

• 200 richieste al giorno per proprieta (default)
• Possibile richiedere aumenti di quota

Esempi pratici

Report settimanale automatico (Python)

Ecco uno schema per un report automatico:

# Pseudo-codice
from googleapiclient.discovery import build

# Autenticazione
service = build('searchconsole', 'v1', credentials=creds)

# Query per top pagine
request = {
    'startDate': '2026-03-20',
    'endDate': '2026-03-27',
    'dimensions': ['page'],
    'rowLimit': 50
}

response = service.searchanalytics().query(
    siteUrl='https://esempio.com',
    body=request
).execute()

# Elabora e invia report

Monitoraggio posizioni keyword

Traccia le posizioni delle keyword piu importanti nel tempo salvando i dati giornalmente in un database.

Alert per cali di traffico

Confronta i dati di questa settimana con la precedente e invia alert se ci sono cali significativi.

Integrazione con Data Studio

Usa l'API per alimentare dashboard personalizzate in Looker Studio (ex Data Studio).

Limiti e quote

Come gestire i limiti

• Implementa retry con exponential backoff
• Usa la paginazione per grandi dataset
• Cache i risultati per ridurre le chiamate
• Distribuisci le richieste nel tempo

Strumenti e integrazioni

Librerie ufficiali

• Python: google-api-python-client
• Node.js: googleapis
• PHP: google-api-php-client
• Java: google-api-java-client

Strumenti no-code

• Supermetrics: Connettore per fogli Google e Data Studio
• Zapier: Integrazione con altri servizi
• Google Sheets Add-ons: Query dirette da fogli

Tool SEO con integrazione API

• Screaming Frog (connessione API)
• Ahrefs (importazione dati)
• Semrush (connessione Search Console)

Il nostro servizio di indicizzazione automatica ti fa risparmiare tempo migliorando la tua visibilità SEO.

Conclusione

Le API di Google Search Console aprono possibilita enormi per l'automazione SEO:

• Report automatici personalizzati
• Monitoraggio continuo delle performance
• Alert per problemi o opportunita
• Integrazione con altri sistemi

Investire tempo nell'apprendimento delle API ti permette di scalare le analisi SEO e prendere decisioni basate su dati freschi e completi.