API di Google Search Console: tre nuove funzionalità cambiano l’analisi dei dati SEO
Google ha aggiornato il 16 novembre 2026 la Search Analytics API di Search Console, introducendo tre funzionalità che consentono di analizzare con maggiore precisione il traffico organico e automatizzare operazioni finora più complesse. Le novità riguardano la classificazione delle ricerche associate a un marchio, il monitoraggio della ricerca multimodale e la possibilità di applicare filtri simultanei a più Paesi e dispositivi.
L’intervento risponde a un’esigenza concreta di sviluppatori, specialisti SEO e aziende che gestiscono siti di grandi dimensioni: ottenere dati già segmentati direttamente dalle API, senza dover ricostruire ogni volta le informazioni attraverso interrogazioni separate o successive elaborazioni.
L’annuncio è stato pubblicato sul blog ufficiale Google Search Central da Daniel Waisberg, Nati Yosephian e Karin Gadasi, del team Search Console. Le tre funzionalità erano state introdotte progressivamente nell’interfaccia del servizio. L’aggiornamento di novembre ne estende la disponibilità alle applicazioni che utilizzano la Search Analytics API, rendendole accessibili ai sistemi di reportistica personalizzati.
La distinzione è rilevante. Non cambia il funzionamento dell’algoritmo di ricerca, né viene annunciato un nuovo criterio di posizionamento. Cambiano invece le informazioni che possono essere richieste programmaticamente a Google e le modalità con cui organizzarle nei sistemi di analisi.
Ricerche con brand e senza brand: la classificazione arriva nelle API
Una delle novità principali riguarda il parametro brandedClassification, che permette di distinguere le ricerche correlate a un marchio da quelle che non presentano questa caratteristica.
La funzione nasce da un aggiornamento precedente. Google aveva annunciato il filtro per le query con brand nel novembre 2025, estendendolo a tutti i siti idonei nel marzo 2026. Dal 16 novembre la stessa classificazione può essere utilizzata attraverso le API di Google Search Console.
La differenza rispetto ai metodi tradizionali riguarda soprattutto il riconoscimento delle ricerche. In precedenza, per separare il traffico associato a un’azienda da quello generato da ricerche generiche, gli analisti ricorrevano spesso a filtri testuali ed espressioni regolari. Era necessario individuare il nome commerciale, le possibili varianti, gli errori di digitazione e le denominazioni dei prodotti.
Il sistema di classificazione di Google considera anche queste relazioni. Una ricerca può essere associata al brand quando contiene il nome dell’azienda, una sua variante oppure riferimenti a prodotti e servizi riconducibili al marchio.
Attraverso brandedClassification è ora possibile filtrare o raggruppare i risultati utilizzando i valori BRANDED e NON_BRANDED.
La nuova classificazione non sostituisce tutti i filtri personalizzati, ma evita di dover mantenere manualmente numerosi elenchi di parole chiave quando l’obiettivo è distinguere il rendimento delle ricerche di marca da quello delle ricerche generiche.
Esistono tuttavia limitazioni precise. La documentazione tecnica specifica che la funzionalità è disponibile soltanto per proprietà di primo livello con un volume sufficiente di query e impressioni. Non è quindi garantita per ogni sito registrato in Search Console.
La classificazione è disponibile per dati a partire dal 21 febbraio 2026. Inoltre, una richiesta che utilizza brandedClassification non può contenere contemporaneamente un filtro sulla dimensione query. Quando la proprietà non risulta idonea, la richiesta relativa alla classificazione non restituisce righe.
Questi vincoli devono essere considerati nella progettazione delle dashboard, soprattutto quando un sistema raccoglie automaticamente i dati di numerose proprietà.
Il traffico della ricerca multimodale entra nei report automatizzati
La seconda novità riguarda le modalità con cui gli utenti effettuano ricerche utilizzando immagini e informazioni visive.
Google aveva introdotto il reporting della ricerca multimodale nell’interfaccia Search Console il 24 settembre 2026. L’aggiornamento di novembre permette di recuperare questi dati anche attraverso le API, impostando il parametro type sul valore webMultimodal.
La nuova tipologia comprende il rendimento associato a Google Lens, alla funzione Cerchia e cerca disponibile su Android e ai caricamenti di immagini nella Ricerca Google.
Si tratta di interazioni differenti rispetto alla tradizionale ricerca basata esclusivamente su parole digitate. Un utente può fotografare un oggetto per cercare informazioni, selezionare visivamente un elemento presente sullo schermo oppure caricare un’immagine per individuare risultati pertinenti.
L’introduzione di webMultimodal nelle API di Google Search Console consente di integrare queste metriche nei sistemi di monitoraggio già utilizzati per le altre tipologie di ricerca.
La documentazione distingue il nuovo valore dalle opzioni precedentemente disponibili, come web, image, video, discover, news e googleNews.
Questa distinzione evita un errore interpretativo: la ricerca multimodale sul web non coincide semplicemente con la ricerca nella scheda Immagini. I due insiemi di dati rappresentano modalità di interazione differenti e devono essere analizzati secondo le rispettive definizioni.
Per un sito di commercio elettronico, ad esempio, può diventare utile osservare quali pagine prodotto ricevono visite attraverso esperienze di ricerca visiva. Un catalogo di arredamento, abbigliamento o componenti tecnici può così distinguere una parte del traffico proveniente da strumenti che consentono di cercare oggetti partendo dalla loro rappresentazione fotografica.
L’analisi non permette però di stabilire automaticamente quale immagine abbia determinato una visita, né di attribuire un eventuale incremento a una specifica ottimizzazione senza ulteriori elementi.
Google ha inoltre confermato che i dati della ricerca multimodale saranno disponibili anche in BigQuery per le proprietà con un’esportazione collettiva dei dati già attiva. Questa possibilità assume particolare rilevanza quando la quantità di informazioni rende poco praticabile una gestione basata esclusivamente su interrogazioni periodiche.
Più Paesi e dispositivi nella stessa richiesta
La terza modifica interviene direttamente sulla struttura dei filtri della Search Analytics API.
Il nuovo campo filterLists consente di specificare più valori per una stessa dimensione all’interno di una richiesta. Le dimensioni supportate sono country e device.
La documentazione prevede che una lista possa contenere diversi codici Paese oppure più tipologie di dispositivo. Una riga soddisfa il filtro quando il valore della dimensione corrisponde a uno qualsiasi degli elementi specificati.
Per i Paesi vengono utilizzati i codici ISO 3166-1 alpha-3. Per i dispositivi sono previsti i valori DESKTOP, MOBILE e TABLET.
In precedenza era possibile filtrare i dati attraverso il campo filters, ma ogni condizione indicava un singolo valore o una specifica espressione di confronto. Le nuove liste permettono invece di selezionare più valori esatti senza costruire richieste separate per ciascuno.
Un’azienda presente in Italia, Francia e Germania può quindi interrogare con un’unica richiesta il rendimento complessivo relativo a questi mercati, eventualmente limitandolo al traffico mobile e desktop.
Lo stesso principio si applica a raggruppamenti geografici utilizzati nella reportistica internazionale, come DACH, EMEA o LATAM. È però necessario specificare i singoli Paesi: l’API non introduce un parametro che riconosce automaticamente le macroregioni commerciali.
Le nuove condizioni possono essere combinate con altri filtri, rispettando le regole previste dalla documentazione.
Un limite da considerare riguarda l’impossibilità di utilizzare contemporaneamente filters e filterLists sulla stessa dimensione all’interno della medesima richiesta. Le liste accettano inoltre corrispondenze esatte, non espressioni regolari o condizioni testuali arbitrarie.
Il comportamento delle liste multiple è particolarmente utile quando un sistema deve recuperare dati aggregati. Quando invece servono risultati separati per ogni Paese o dispositivo, è necessario includere le relative dimensioni nella richiesta oppure effettuare interrogazioni distinte.
Come cambia la reportistica SEO per i grandi siti editoriali
Le nuove funzionalità acquistano valore soprattutto quando l’analisi riguarda migliaia di URL e differenti tipologie di traffico.
Un quotidiano online con numerose sezioni può utilizzare le API di Google Search Console per distinguere il rendimento delle pagine editoriali, dei contenuti di servizio e delle diverse aree tematiche. Le dimensioni page, query, date, country e device, già disponibili prima dell’aggiornamento, consentono di costruire segmentazioni dettagliate.
L’introduzione della ricerca multimodale aggiunge una prospettiva ulteriore, soprattutto per le testate che pubblicano contenuti nei quali la componente visiva svolge un ruolo centrale.
Le analisi possono riguardare, per esempio, guide illustrate, contenuti dedicati a prodotti, servizi locali e articoli informativi accompagnati da immagini riconoscibili. La disponibilità di dati specifici permette di verificare il rendimento effettivo di queste pagine nella ricerca multimodale, senza presumere che la loro natura visiva determini necessariamente risultati migliori.
La classificazione delle ricerche con brand offre invece una lettura differente della visibilità editoriale.
Un aumento delle visite provenienti da ricerche che contengono il nome della testata può indicare un rafforzamento della sua riconoscibilità nei comportamenti di ricerca. Un incremento delle visite generate da query non associate al marchio può segnalare una maggiore capacità di intercettare esigenze informative generiche.
Sono indicatori distinti, che richiedono interpretazioni differenti. Nessuno dei due rappresenta, isolatamente, una misura completa dell’autorevolezza editoriale.
La possibilità di automatizzare queste segmentazioni riduce il lavoro necessario per produrre confronti periodici tra sezioni, periodi e mercati, ma non elimina la necessità di controllare la qualità dei dati.
E-commerce e portali multilingua: analisi più coerenti tra mercati
La gestione di siti internazionali presenta difficoltà specifiche. Cataloghi differenti, versioni linguistiche, abitudini di ricerca e distribuzione del traffico tra dispositivi possono rendere complesso confrontare le prestazioni delle diverse aree commerciali.
I nuovi filtri permettono di costruire richieste omogenee per gruppi di Paesi e tipologie di dispositivo. Un portale attivo in diversi mercati europei può analizzare con maggiore continuità il traffico proveniente da una determinata area geografica, confrontandone le variazioni nel tempo.
Per gli e-commerce assume particolare interesse l’incrocio tra classificazione delle ricerche con brand e ricerca multimodale.
La prima consente di distinguere il traffico associato alla notorietà del marchio dalle ricerche generiche. La seconda permette di osservare una modalità di scoperta dei prodotti che parte da immagini e oggetti.
Non bisogna però confondere queste informazioni con i risultati commerciali. Search Console misura il rendimento nella Ricerca Google attraverso indicatori come clic, impressioni, CTR e posizione media. Per ricostruire ordini, ricavi e conversioni occorre integrare altre fonti di dati, rispettando le differenze tra i rispettivi sistemi di misurazione.
Nei portali multilingua esiste un’ulteriore distinzione: filtrare per Paese non equivale a filtrare per lingua.
La dimensione geografica identifica il Paese associato alla ricerca, mentre la lingua del contenuto dipende dall’organizzazione del sito e dagli URL utilizzati.
Per confrontare le prestazioni delle versioni italiane, tedesche o francesi di un portale può quindi essere necessario combinare i dati di Search Console con una classificazione interna delle pagine, basata sui percorsi URL o su informazioni provenienti dal sistema di gestione dei contenuti.
Il nuovo campo filterLists non introduce una dimensione linguistica autonoma e non sostituisce questo lavoro.
Parametri, autenticazione e limiti tecnici ancora presenti
L’ampliamento delle funzionalità non modifica alcuni vincoli strutturali delle API di Google Search Console.
Il metodo Search Analytics continua a utilizzare richieste HTTP POST verso la risorsa searchAnalytics/query, riferita a una proprietà verificata. L’accesso richiede un’autorizzazione adeguata, attraverso gli ambiti previsti da Google per la lettura o la gestione dei dati Search Console.
Restano disponibili i parametri temporali startDate ed endDate, le dimensioni di raggruppamento, i filtri, la modalità di aggregazione e le impostazioni per la paginazione.
Il parametro rowLimit permette di richiedere da 1 a 25.000 righe per chiamata, con un valore predefinito di 1.000. La paginazione avviene attraverso startRow, che indica la posizione iniziale dei risultati da recuperare.
Secondo la guida ufficiale dedicata all’estrazione dei dati, il metodo Search Analytics espone inoltre un massimo di 50.000 righe al giorno per tipologia di ricerca. Non si tratta dunque di un sistema che garantisce l’accesso indiscriminato a tutte le combinazioni di query e URL registrate.
Google precisa che le risposte privilegiano le righe principali e che l’aggiunta di dimensioni dettagliate, come pagina e query, può determinare l’esclusione di alcuni dati.
Questa caratteristica è particolarmente importante quando si analizzano siti editoriali con un elevato numero di articoli o cataloghi commerciali molto estesi.
Un sistema automatico che recupera 25.000 righe non può considerare quel risultato necessariamente completo. Deve gestire la paginazione, verificare i limiti applicabili e distinguere tra dati aggregati e informazioni di dettaglio.
Anche il metodo di aggregazione influenza la lettura delle metriche. I valori calcolati a livello di proprietà possono differire da quelli aggregati per pagina canonica. La documentazione impedisce, inoltre, di richiedere l’aggregazione per proprietà quando i dati vengono filtrati o raggruppati per pagina.
Restano operative le quote di utilizzo previste per le API, che comprendono limiti legati al carico delle richieste e alla frequenza di interrogazione. Un sistema di reportistica deve quindi controllare il consumo delle quote, evitare richieste inutilmente complesse e gestire correttamente gli eventuali errori.
Per le esigenze di archiviazione e analisi di grandi volumi di informazioni, l’esportazione collettiva verso BigQuery continua a rappresentare una soluzione distinta e complementare rispetto alle interrogazioni dirette.
Dati recenti e serie storiche: attenzione alla confrontabilità
Un’altra questione riguarda l’aggiornamento temporale delle informazioni.
Le API di Google Search Console permettono di utilizzare il parametro dataState per distinguere i dati consolidati da quelli più recenti, ancora soggetti a elaborazione.
Il valore final, utilizzato anche quando il parametro viene omesso, restituisce dati definitivi. Con all è possibile includere informazioni più recenti che potrebbero non essere ancora complete. Il valore hourly_all permette invece di ottenere dati con dettaglio orario, utilizzando la relativa dimensione.
Le risposte possono contenere metadati che identificano il primo giorno o la prima ora con informazioni incomplete. Questi riferimenti sono utili per evitare confronti impropri tra periodi consolidati e rilevazioni ancora provvisorie.
Google indica generalmente un intervallo di due o tre giorni per la disponibilità dei dati definitivi, pur consentendo l’accesso a informazioni più recenti attraverso le modalità previste.
Per i sistemi che producono automaticamente report giornalieri, la gestione di questo aspetto è determinante. Una diminuzione apparente delle visite nelle ultime ore potrebbe dipendere dal completamento ancora in corso dei dati, anziché da un effettivo cambiamento del rendimento organico.
Occorre inoltre prestare attenzione alla disponibilità storica delle nuove classificazioni.
Nel caso di brandedClassification, il riferimento documentato è il 21 febbraio 2026. Non sarebbe quindi corretto costruire automaticamente serie storiche omogenee su periodi precedenti, attribuendo alla nuova classificazione una copertura retroattiva che Google non ha dichiarato.
La verifica delle date disponibili deve precedere qualsiasi confronto destinato a report direzionali o valutazioni sull’andamento SEO.
Dall’interfaccia alle API: cosa cambia realmente per gli strumenti di analisi
L’annuncio del 16 novembre riguarda principalmente il trasferimento di funzionalità già introdotte nell’interfaccia Search Console verso l’accesso programmatico.
Il filtro delle ricerche con brand era stato presentato nel novembre 2025. Il reporting sulla ricerca multimodale era arrivato nel settembre 2026. Le nuove possibilità di selezione simultanea di Paesi e dispositivi completano l’allineamento tra i filtri disponibili nel servizio e quelli utilizzabili dagli sviluppatori.
Prima dell’aggiornamento, un’azienda poteva consultare alcune di queste informazioni direttamente nei report di Search Console, ma non disponeva necessariamente delle corrispondenti opzioni attraverso la Search Analytics API.
Questo disallineamento complicava il lavoro delle piattaforme di monitoraggio SEO, delle agenzie e dei team interni che raccolgono dati di numerose proprietà in dashboard condivise.
Ora diventa possibile trasferire nei flussi automatizzati segmentazioni precedentemente disponibili soprattutto attraverso la consultazione dell’interfaccia.
Il cambiamento può ridurre le operazioni necessarie per produrre report ricorrenti. Non significa però che ogni elaborazione personalizzata diventi superflua.
La classificazione delle pagine per categoria editoriale, l’associazione delle visite agli obiettivi commerciali e la costruzione di indicatori specifici continuano a dipendere dall’architettura dei sistemi utilizzati.
Allo stesso modo, gli strumenti di terze parti dovranno adeguare le proprie integrazioni per sfruttare i nuovi campi. La pubblicazione delle funzionalità da parte di Google non implica che ogni software SEO le abbia già implementate.
Una maggiore precisione nei report non modifica il posizionamento
L’aggiornamento delle API di Google Search Console introduce opportunità concrete per la misurazione del traffico organico, ma il suo perimetro resta quello dell’analisi.
Google aveva già chiarito, presentando il filtro per le ricerche con brand, che la classificazione non influenza il funzionamento dei sistemi di ranking.
Lo stesso principio vale per le nuove possibilità di interrogazione dei dati. L’utilizzo di webMultimodal non migliora automaticamente la presenza di un sito nei risultati visivi, così come l’adozione di filterLists non determina una maggiore visibilità nei mercati internazionali.
Le informazioni ottenute possono orientare decisioni editoriali e tecniche, individuare variazioni nel comportamento degli utenti e rendere più accurato il monitoraggio delle prestazioni. Gli eventuali effetti sul traffico dipenderanno dalle attività effettivamente realizzate sui siti e dal loro rendimento nella Ricerca Google.
Resta infine una questione operativa per chi sviluppa sistemi di reporting: la documentazione del metodo Search Analytics, aggiornata al 16 novembre 2026, definisce con precisione le nuove opzioni, le combinazioni ammesse e le incompatibilità tra filtri.
L’adeguamento delle integrazioni richiede quindi una verifica delle richieste già utilizzate, soprattutto nei sistemi che combinano classificazione delle query, segmentazione geografica e analisi delle pagine.
Il controllo preventivo delle risposte vuote, dei limiti di estrazione e delle regole di aggregazione permette di evitare che l’introduzione dei nuovi parametri produca report incompleti o confronti statisticamente poco attendibili.