Marketing

API di Google Search Console: nuovi filtri per analizzare il traffico SEO e automatizzare i report su larga scala

Imbuto analitico che organizza dati provenienti da pagine web in grafici distinti, simbolo dei nuovi filtri delle API di Google Search Console.
Contenuto curato da Massimo Chioni

Google ha aggiornato il 16 novembre 2026 l'API Search Analytics di Search Console, introducendo tre funzionalità che permettono di analizzare il rendimento organico attraverso criteri di segmentazione finora disponibili principalmente nell'interfaccia web. Le novità riguardano la distinzione tra ricerche associate a un brand e ricerche generiche, l'accesso ai dati della ricerca multimodale e la possibilità di selezionare contemporaneamente più paesi o tipologie di dispositivi.

L'aggiornamento interessa soprattutto le organizzazioni che utilizzano i dati di Google Search Console all'interno di dashboard, software SEO e sistemi di monitoraggio sviluppati internamente. Le nuove opzioni consentono di ottenere informazioni più specifiche con interrogazioni automatizzate, riducendo la necessità di combinare manualmente numerosi report.

L'annuncio, pubblicato sul blog ufficiale Google Search Central e firmato da Daniel Waisberg, Nati Yosephian e Karin Gadasi del team Search Console, risponde alle richieste degli sviluppatori e degli operatori del settore che avevano bisogno di utilizzare queste informazioni nei propri strumenti di analisi.

Dall'interfaccia di Search Console ai sistemi di reporting automatico

Le funzionalità annunciate a novembre non rappresentano tre strumenti completamente nuovi. Google aveva già introdotto progressivamente le relative possibilità di analisi nel report sul rendimento di Search Console, consentendo agli utenti di esaminare segmenti specifici del traffico direttamente dal browser.

Il filtro dedicato alle ricerche con brand era stato presentato nel novembre 2025, mentre le informazioni sulla ricerca multimodale erano entrate nei report nel settembre 2026. Anche la selezione contemporanea di più paesi e dispositivi era già stata resa disponibile nell'interfaccia.

La differenza riguarda l'estensione di queste funzionalità all'API Search Analytics, che permette a software e applicazioni di interrogare programmaticamente i dati di rendimento.

Un'agenzia incaricata di monitorare numerosi siti può raccogliere automaticamente clic, impressioni, CTR e posizione media, senza accedere singolarmente a ogni proprietà. Gli stessi dati possono alimentare dashboard centralizzate, report periodici destinati ai clienti o sistemi interni che segnalano variazioni significative nelle prestazioni.

L'API di Google Search Console consentiva già da tempo di filtrare e raggruppare le informazioni secondo dimensioni quali pagina, query, paese e dispositivo. Erano inoltre disponibili filtri testuali, comprese le espressioni regolari, e la possibilità di analizzare differenti tipologie di ricerca.

L'intervento del 16 novembre amplia quindi le modalità di interrogazione esistenti, senza sostituire i sistemi precedenti né introdurre un nuovo endpoint dedicato.

Ricerche con brand e senza brand: la classificazione entra nelle API

Una delle novità più rilevanti è l'introduzione della dimensione brandedClassification, utilizzabile per raggruppare o filtrare i dati distinguendo le ricerche associate a un marchio da quelle che non presentano questa relazione.

I valori previsti dalla documentazione ufficiale sono BRANDED e NON_BRANDED.

La distinzione permette di comprendere meglio l'origine della visibilità organica. Un'azienda può ricevere numerosi clic da utenti che cercano direttamente il suo nome commerciale, ma ottenere risultati differenti sulle ricerche generiche relative ai prodotti o servizi offerti.

Questa differenza ha conseguenze concrete nella valutazione delle attività SEO. Un aumento complessivo del traffico può dipendere dalla maggiore notorietà del marchio, da una campagna pubblicitaria che ha stimolato successive ricerche su Google oppure dalla crescita del posizionamento sulle query non associate al brand.

Disporre dei due segmenti separati consente di osservare questi fenomeni con maggiore precisione, pur senza attribuire automaticamente a una specifica attività di marketing le variazioni registrate.

Prima dell'aggiornamento, gli sviluppatori potevano costruire classificazioni personalizzate attraverso filtri sulle query ed espressioni regolari. Questa possibilità rimane disponibile, ma richiede di mantenere elenchi aggiornati comprendenti denominazioni commerciali, abbreviazioni, eventuali errori di digitazione e varianti del marchio.

La nuova classificazione utilizza invece il sistema predisposto da Google, semplificando il lavoro necessario per costruire report ricorrenti. Non bisogna però considerarla infallibile: il riconoscimento delle ricerche associate a un brand può presentare classificazioni non corrette, specialmente quando i nomi commerciali coincidono con termini di uso comune.

La disponibilità della nuova dimensione è inoltre soggetta a condizioni precise. Secondo la documentazione tecnica, i dati sono accessibili a partire dal 21 febbraio 2026 e soltanto per proprietà di livello superiore che raggiungono un volume sufficiente di query e impressioni. Le proprietà non idonee non restituiscono righe per questa classificazione.

Esiste anche un vincolo nelle interrogazioni: brandedClassification supporta esclusivamente l'operatore equals e non può essere utilizzato insieme a un filtro sulla dimensione query nella stessa richiesta.

Un sistema di analisi che intenda confrontare il traffico con brand di diversi siti dovrà quindi verificare preventivamente l'effettiva disponibilità della classificazione per ciascuna proprietà, evitando di interpretare automaticamente una risposta vuota come assenza di traffico.

La ricerca multimodale diventa analizzabile attraverso Search Analytics

La seconda novità riguarda i dati provenienti dalle modalità di ricerca che combinano immagini e altri elementi visivi.

Google ha aggiunto il valore webMultimodal al parametro type, permettendo di richiedere informazioni sulle prestazioni dei contenuti nelle ricerche effettuate attraverso Google Lens, Cerchia e cerca sui dispositivi Android e caricamenti di immagini nella Ricerca Google.

Si tratta di modalità di interazione differenti rispetto alla tradizionale digitazione di parole nella barra di ricerca. Un utente può fotografare un oggetto, selezionare visivamente un elemento presente sullo schermo oppure caricare un'immagine per cercare informazioni correlate.

L'API di Google Search Console consente ora di integrare il rendimento di queste esperienze all'interno degli strumenti di monitoraggio, utilizzando il tipo di ricerca previsto dalla documentazione.

Per gli e-commerce il dato può risultare particolarmente interessante. Si consideri, a titolo esemplificativo, un negozio online con migliaia di schede prodotto dedicate ad abbigliamento, arredamento e accessori. L'azienda potrebbe interrogare periodicamente le prestazioni delle pagine nella ricerca multimodale e individuare le categorie che ricevono maggiore esposizione attraverso le ricerche visive.

Un incremento delle impressioni multimodali per una determinata categoria potrebbe suggerire la necessità di approfondire la qualità delle immagini, la completezza delle schede prodotto e la relazione tra contenuti visivi e informazioni testuali.

L'analisi non dimostrerebbe automaticamente che un intervento sulle immagini produca migliori posizionamenti. Offrirebbe però un'indicazione aggiuntiva sui percorsi attraverso i quali gli utenti incontrano i prodotti nella Ricerca Google.

La documentazione ufficiale non specifica con precisione l'intera profondità storica disponibile per webMultimodal. Di conseguenza, le analisi retrospettive devono partire dalla verifica effettiva dei periodi per i quali vengono restituite informazioni.

Google ha inoltre annunciato la disponibilità dei dati multimodali anche attraverso BigQuery per le proprietà con esportazione collettiva attiva. L'annuncio non indica tuttavia una data precisa di attivazione per tutte le esportazioni: la presenza delle relative informazioni deve essere verificata nella struttura dei dati effettivamente disponibile.

Filtri multipli per paesi e dispositivi: meno richieste e analisi territoriali più semplici

La terza modifica interviene su una difficoltà operativa frequente nei progetti SEO internazionali.

Fino all'introduzione della nuova opzione, chi desiderava raccogliere i dati aggregati relativi a un insieme selezionato di paesi poteva dover effettuare più interrogazioni e successivamente combinare i risultati.

Con il campo filterLists, l'API Search Analytics permette di indicare più valori per le dimensioni country e device all'interno della stessa richiesta.

Un'azienda presente in Germania, Austria e Svizzera può quindi impostare una selezione che comprenda questi tre mercati, utilizzando i codici paese ISO 3166-1 alpha-3 previsti dall'API.

Analogamente, è possibile selezionare contemporaneamente più tipologie di dispositivi tra DESKTOP, MOBILE e TABLET.

Google cita espressamente raggruppamenti geografici come EMEA, LATAM e DACH. Non si tratta però di nuove dimensioni territoriali riconosciute automaticamente dal sistema: lo sviluppatore deve specificare i paesi che compongono il gruppo desiderato.

Il vantaggio è soprattutto organizzativo. Un'impresa internazionale può definire le proprie aree commerciali, utilizzare gli stessi criteri nei report mensili e ridurre le operazioni necessarie per costruire aggregazioni territoriali coerenti.

La documentazione stabilisce alcune restrizioni. Il campo filterLists è previsto per paesi e dispositivi e utilizza corrispondenze esatte. Non è possibile applicare contemporaneamente filters e filterLists alla stessa dimensione nella medesima richiesta.

Rimangono invece disponibili le consuete possibilità di raggruppamento dei risultati attraverso dimensions, già presenti prima dell'aggiornamento. Un'interrogazione che seleziona più paesi non richiede necessariamente di visualizzare un'unica cifra aggregata: i risultati possono essere organizzati secondo le dimensioni compatibili indicate nella richiesta.

Questa distinzione è utile per evitare un equivoco. I nuovi filtri semplificano la selezione di insiemi di dati, ma non introducono automaticamente strumenti di confronto statistico, sistemi di previsione o funzioni di attribuzione delle conversioni.

Siti multilingua, e-commerce e portali editoriali: tre applicazioni operative

Le nuove possibilità offerte dall'API di Google Search Console acquistano particolare rilevanza quando i dati devono essere analizzati su proprietà con numerose pagine, mercati differenti o attività editoriali continue.

Nel caso di un sito multilingua, ad esempio, un responsabile marketing potrebbe confrontare le prestazioni organiche nei principali mercati europei, distinguendo il traffico associato al marchio da quello generico.

Per approfondire il rendimento delle differenti versioni linguistiche, potrebbe utilizzare i filtri già esistenti sulla dimensione page, selezionando sezioni del sito identificate da percorsi linguistici distinti.

È necessario ricordare che la dimensione country identifica il paese da cui proviene la ricerca, non la lingua dell'utente o della pagina. Un sito con contenuti in italiano, inglese e tedesco richiede quindi un'impostazione analitica che tenga separati mercati geografici e versioni linguistiche.

Un e-commerce potrebbe invece predisporre una dashboard che confronti periodicamente le prestazioni delle categorie merceologiche, utilizzando i filtri sulle pagine già disponibili e integrando i dati della ricerca multimodale. L'obiettivo sarebbe individuare eventuali differenze tra la visibilità nella ricerca tradizionale e quella nelle esperienze visive, senza confondere le metriche di Search Console con vendite e conversioni effettive.

Per un portale editoriale, il problema può essere ancora diverso. Un sito che pubblica decine di articoli ogni settimana deve distinguere le oscillazioni fisiologiche delle notizie dalle variazioni persistenti nel rendimento dei contenuti.

Le API permettono di creare controlli periodici sulle sezioni editoriali, confrontare mercati e dispositivi e osservare le prestazioni delle pagine nel tempo.

Un quotidiano online con edizioni destinate a più paesi potrebbe, per esempio, analizzare il traffico proveniente dai dispositivi mobili nei mercati di riferimento, separandolo da quello desktop. Il nuovo filtro multiplo ridurrebbe la necessità di effettuare richieste distinte per ogni combinazione territoriale.

L'automazione consentirebbe anche di evidenziare le pagine che registrano variazioni rilevanti nelle impressioni o nei clic, lasciando all'analista la valutazione delle possibili cause.

Una diminuzione delle impressioni, infatti, può derivare da molte circostanze: riduzione dell'interesse per una notizia, stagionalità delle ricerche, maggiore concorrenza, modifiche alla composizione dei risultati oppure problemi tecnici del sito.

Il valore del sistema risiede nella possibilità di individuare tempestivamente le anomalie e fornire dati confrontabili, non nell'attribuzione automatica di una spiegazione.

Automazione dei report SEO: cosa cambia per agenzie e responsabili marketing

La gestione simultanea di più proprietà rappresenta uno degli ambiti nei quali l'aggiornamento può produrre i maggiori benefici operativi.

Un'agenzia SEO che segue numerosi clienti deve spesso preparare report con criteri differenti: alcuni richiedono la distinzione tra ricerche con brand e senza brand, altri hanno bisogno di analisi territoriali, altri ancora devono monitorare categorie di prodotto o sezioni editoriali.

Con le nuove opzioni, una parte di queste segmentazioni può essere effettuata direttamente durante l'interrogazione dell'API.

Il software può acquisire i dati attraverso procedure programmate, conservarli in un archivio e renderli disponibili nelle dashboard utilizzate dai consulenti o dai responsabili aziendali.

Questo approccio permette di mantenere criteri di lettura più uniformi, soprattutto nei progetti che prevedono report settimanali o mensili.

La maggiore facilità di interrogazione non elimina comunque la necessità di progettare correttamente le analisi. Le metriche devono essere interpretate tenendo conto delle differenze tra le proprietà, della disponibilità dei dati e delle modalità di aggregazione.

Un ulteriore elemento riguarda il confronto temporale. Quando una nuova classificazione è disponibile soltanto a partire da una determinata data, non è corretto costruire serie storiche che presuppongano la presenza delle stesse informazioni nei periodi precedenti.

Per le agenzie, quindi, l'aggiornamento può diminuire il lavoro manuale necessario alla preparazione dei report. La valutazione delle prestazioni e delle decisioni da intraprendere rimane però un'attività che richiede competenze SEO, conoscenza del settore e attenzione alla qualità dei dati.

Limiti tecnici, autorizzazioni e disponibilità delle nuove funzioni

L'integrazione delle nuove opzioni non modifica i requisiti generali di accesso all'API di Google Search Console.

Le applicazioni devono essere configurate attraverso un progetto Google Cloud e utilizzare il protocollo OAuth 2.0 per accedere ai dati delle proprietà autorizzate.

Per le applicazioni destinate esclusivamente alla lettura delle informazioni è disponibile l'ambito di autorizzazione webmasters.readonly.

Le richieste continuano a essere gestite attraverso il metodo searchanalytics.query, utilizzando la struttura documentata per date, dimensioni, filtri e tipologia di ricerca.

La documentazione ufficiale prevede un massimo di 25.000 righe per singola risposta, con possibilità di paginazione attraverso startRow. Questo limite non equivale alla disponibilità illimitata di tutti i dati.

Google specifica infatti che l'API Search Analytics espone fino a 50.000 righe al giorno per tipologia di ricerca, ordinate in base ai clic. Le interrogazioni più dettagliate possono quindi non restituire tutte le combinazioni di query e pagine presenti nei dati sottostanti.

Per le organizzazioni che gestiscono grandi volumi informativi, tale limite è particolarmente rilevante. Un portale con centinaia di migliaia di URL non può presumere di ricostruire integralmente ogni dettaglio del traffico semplicemente moltiplicando le richieste.

Esistono inoltre quote di utilizzo che regolano la frequenza e il carico delle interrogazioni. La documentazione indica, per Search Analytics, un limite di 1.200 richieste al minuto per sito e un limite di 1.200 richieste al minuto per utente. A livello di progetto sono previsti 40 milioni? No: il limite documentato è di 40.000 richieste al minuto e 30 milioni al giorno.

Accanto al numero di chiamate, Google considera il carico generato dalle interrogazioni. Le richieste che combinano filtri su pagine e query oppure interessano intervalli temporali molto estesi risultano generalmente più onerose.

Un sistema di monitoraggio progettato correttamente dovrebbe quindi distribuire le acquisizioni nel tempo, evitare richieste ripetitive sugli stessi periodi già consolidati e conservare localmente le informazioni necessarie alle analisi ricorrenti.

Occorre prestare attenzione anche alla scelta tra aggregazione per proprietà e aggregazione per pagina. I conteggi possono differire a seconda della modalità utilizzata e non tutte le combinazioni sono ammesse. In particolare, quando si filtra o si raggruppa per pagina, l'aggregazione per proprietà non è supportata.

I dati aggiuntivi non modificano direttamente il posizionamento su Google

L'aggiornamento del 16 novembre 2026 riguarda gli strumenti di accesso e organizzazione delle informazioni, non il funzionamento degli algoritmi che determinano l'ordine dei risultati di ricerca.

L'utilizzo dei nuovi filtri non aumenta direttamente il ranking delle pagine, non modifica l'indicizzazione e non attribuisce vantaggi SEO ai siti che interrogano le API.

Le informazioni aggiuntive possono però contribuire a decisioni più documentate.

Un'azienda che osserva una crescita del traffico con brand ma una contrazione delle ricerche generiche potrebbe decidere di approfondire la copertura dei contenuti informativi e commerciali. Un sito internazionale potrebbe individuare mercati nei quali le impressioni crescono senza un corrispondente aumento dei clic. Un e-commerce potrebbe rilevare differenze significative tra la visibilità delle pagine prodotto nelle diverse modalità di ricerca.

Si tratta di indicazioni che richiedono ulteriori verifiche, eventualmente attraverso Google Analytics, strumenti di analisi tecnica, dati commerciali e controlli diretti delle pagine coinvolte.

La possibilità di combinare segmentazioni geografiche, dispositivi e classificazione delle ricerche facilita soprattutto la costruzione di sistemi di monitoraggio continuativi.

Per le organizzazioni che dispongono già di un'infrastruttura di reporting, il passaggio operativo consiste nell'aggiornare le interrogazioni esistenti, verificare le proprietà idonee alle nuove classificazioni e controllare che le dashboard distinguano correttamente i dati disponibili da quelli assenti per limitazioni tecniche.

Una proprietà che non restituisce informazioni attraverso il filtro delle ricerche con brand, per esempio, deve essere trattata diversamente da una proprietà che presenta effettivamente zero clic nel periodo esaminato. È una distinzione essenziale quando i risultati vengono aggregati automaticamente e utilizzati per confrontare le prestazioni di decine di siti.