Francesco IamurriSEO & DIGITAL STRATEGY

Risorse / Approfondimenti SEO

Search Console aggiorna le API: come leggere brand, mercati e ricerca multimodale nei report aziendali

Illustrazione dei nuovi filtri Search Console API: brand, mercati geografici e ricerca visuale.

Google porta nuovi filtri nella Search Analytics API. Ecco come usarli per costruire report più utili, verificare le estrazioni e riconoscere i limiti dei dati.

Apri il report mensile e i clic organici sono aumentati. È una buona notizia, ma prima di decidere dove investire serve capire che cosa sta crescendo. Più persone cercano il nome della tua azienda? Le pagine commerciali intercettano nuove ricerche? Oppure il risultato complessivo nasconde un calo nel mercato su cui stai lavorando?

Il totale, da solo, non risponde.

Il 16 novembre 2026 Google ha annunciato tre aggiornamenti della Search Analytics API: classificazione delle query di brand, dati della ricerca multimodale e filtri multipli per paesi e dispositivi. Sono capacità già presenti nell’interfaccia di Search Console, ora utilizzabili anche nelle estrazioni automatizzate. Lo spiega l’annuncio ufficiale di Google Search Central.

Per chi gestisce dashboard, script o report aziendali, il vantaggio è poter inserire queste distinzioni nel processo di raccolta. Prima, però, bisogna definire che cosa vogliamo misurare.

Separare chi ti cerca da chi cerca quello che vendi

Una ricerca che contiene il nome dell’azienda e una ricerca generica di un servizio possono entrambe generare valore, ma raccontano situazioni diverse.

Nel primo caso esiste già una conoscenza del brand. Nel secondo, il sito può incontrare una persona che sta ancora valutando fornitori, prodotti o soluzioni. Per questo, nel report aziendale terrei separati i due andamenti.

La nuova dimensione brandedClassification consente di raggruppare o filtrare i risultati nelle classi BRANDED e NON_BRANDED. Il dato è disponibile soltanto per proprietà idonee: una risposta senza righe non dimostra automaticamente l’assenza di traffico. Google specifica che le proprietà non idonee non restituiscono righe per questa classificazione.

Partirei quindi da una verifica semplice: la segmentazione è disponibile per la proprietà che alimenta il report? Poi confronterei il risultato con l’interfaccia, usando lo stesso periodo e lo stesso perimetro.

Se oggi utilizzi espressioni regolari per riconoscere il brand, conserverei temporaneamente entrambe le letture. La classificazione Google e le tue regole potrebbero delimitare insiemi diversi: il cambio di metodo va annotato, altrimenti una variazione nella dashboard rischia di sembrare una variazione del mercato.

Una richiesta per confrontare brand, paesi e dispositivi

L’endpoint resta quello del metodo searchAnalytics.query. Serve un’autorizzazione OAuth; per la sola lettura è previsto lo scope https://www.googleapis.com/auth/webmasters.readonly.

Questo corpo JSON illustra un’estrazione giornaliera della classificazione brand, limitata a Italia, Germania e Francia, su mobile e desktop:

{
  "startDate": "2026-11-01",
  "endDate": "2026-11-14",
  "type": "web",
  "dimensions": [
    "date",
    "brandedClassification"
  ],
  "dimensionFilterGroups": [
    {
      "groupType": "and",
      "filterLists": [
        {
          "dimension": "country",
          "expressions": [
            "ITA",
            "DEU",
            "FRA"
          ]
        },
        {
          "dimension": "device",
          "expressions": [
            "MOBILE",
            "DESKTOP"
          ]
        }
      ]
    }
  ],
  "dataState": "final"
}

È un esempio costruito dalla documentazione, non un’estrazione eseguita sui dati di un sito. I paesi vengono selezionati come insieme: per ottenere righe separate per mercato, aggiungerei country alle dimensioni.

Ci sono due vincoli da rispettare: la classificazione brand non può essere combinata con un filtro query nella stessa richiesta; inoltre, una dimensione non può essere filtrata contemporaneamente attraverso filters e filterLists. Le date seguono il fuso Pacific Time di Search Console. Parametri e combinazioni sono descritti nel riferimento ufficiale dell’API.

Sul piano aziendale, definirei gruppi di paesi coerenti con le responsabilità commerciali. Una vista “estero” troppo ampia può nascondere differenze importanti fra mercati con lingue, cataloghi e investimenti diversi.

La ricerca multimodale entra nelle estrazioni

Il secondo aggiornamento riguarda webMultimodal, il tipo di ricerca che comprende Google Lens, Circle to Search su Android e caricamenti di immagini in Google Search. Google annuncia anche la disponibilità di questi dati in BigQuery per le proprietà con esportazione collettiva attiva.

Un esempio essenziale per osservare le pagine coinvolte:

{
  "startDate": "2026-11-01",
  "endDate": "2026-11-14",
  "type": "webMultimodal",
  "dimensions": [
    "page"
  ],
  "dataState": "final"
}

Per un ecommerce, partirei dalle categorie in cui l’immagine aiuta davvero a scegliere: arredamento, moda, ricambi, oggetti riconoscibili per forma o dettaglio.

Confronterei poi le pagine che emergono con la qualità del catalogo: fotografie, varianti, descrizioni e informazioni necessarie a capire il prodotto. Il report può suggerire dove approfondire; non dimostra, da solo, che una determinata modifica alle immagini abbia causato una crescita.

Eviterei di chiamare questa vista “citazioni AI”. Il perimetro descritto da Google riguarda ricerche multimodali: l’etichetta del report deve rendere chiaro al lettore quale fenomeno sta osservando. La funzionalità di reporting era stata presentata a settembre; la novità attuale è l’accesso tramite API.

Più dettaglio richiede più attenzione ai limiti

Quando un’estrazione funziona, viene voglia di aggiungere tutte le dimensioni disponibili. È comprensibile, ma prima distinguerei due obiettivi: controllare l’andamento generale e cercare le pagine o le query su cui intervenire.

Google documenta che le estrazioni dettagliate possono perdere parte dei dati e che il metodo espone fino a 50.000 righe al giorno per tipo di ricerca, ordinate per clic. La paginazione procede con richieste successive tramite startRow; non elimina i limiti interni del servizio. Il riferimento è la guida all’estrazione dei dati di performance.

Per questo costruirei due raccolte:

  • una vista sintetica, destinata a seguire i KPI;
  • una vista dettagliata, destinata all’analisi operativa.

Non pretenderei che la somma di ogni tabella dettagliata coincida sempre con il totale della vista sintetica. Chiederei invece a chi prepara il report di documentare aggregazione, filtri e limiti di ciascuna estrazione.

Come aggiornerei una dashboard aziendale

Il primo intervento sarebbe sul significato dei numeri, prima ancora che sulla grafica.

Vista Domanda a cui deve rispondere
Brand e non brand Sta cambiando la domanda legata al nome dell’azienda o quella legata all’offerta?
Paesi e dispositivi In quali mercati e condizioni di navigazione si concentra la variazione?
Ricerca multimodale Quali pagine intercettano ricerche basate anche sulle immagini?
Risultati commerciali Alle variazioni di visibilità corrispondono richieste, ordini o ricavi?

L’ultima riga richiede dati commerciali o analytics da leggere accanto a quelli di Search Console. Eviterei di attribuire a una singola query un fatturato che il sistema di misurazione non consente di ricostruire.

Nella raccolta salverei anche proprietà, periodo, tipo di ricerca, filtri applicati e stato dell’esecuzione. Una tabella vuota dovrebbe avere un significato verificabile: dato non disponibile, nessuna riga restituita oppure errore tecnico.

Il controllo da chiedere prima di usare i nuovi report

Prima della messa in produzione, chiederei a SEO e sviluppatore una breve verifica condivisa: confronto con l’interfaccia, controllo delle proprietà idonee, gestione degli errori e annotazione del cambio di metodo.

Al responsabile marketing chiederei invece quali decisioni devono migliorare grazie alla nuova segmentazione. Se nessuno sa dire che cosa farebbe diversamente davanti a un risultato, probabilmente stiamo aggiungendo una tabella senza aggiungere informazione utile.

Queste API permettono di rendere più leggibile il contributo della ricerca organica. Il valore per l’azienda emerge quando ogni segmento aiuta a individuare un controllo, assegnarlo alla persona giusta e verificare che cosa succede dopo.

Cominciamo dal tuo progetto

Il tuo sito.
Il prossimo passo.

Raccontami la situazione e il risultato che vuoi raggiungere. Partiamo da una breve call conoscitiva.

francesco@taoweb.it