Search Console API: query brand e Google Lens nei report
Search Console API: dal 16 novembre 2026 puoi separare query brand e non brand, leggere i dati di Google Lens e filtrare più paesi in una sola richiesta.
- Autore
Luca Avallone- Data di pubblicazione
- Tempo di lettura
- 7 min di lettura

Articolo redatto con il supporto dell'intelligenza artificiale e verificato sulle fonti ufficiali indicate in fondo alla pagina.
Con la Search Console API ora puoi separare in automatico le query brand da quelle non brand, leggere i dati delle ricerche fatte con Google Lens e filtrare più paesi o dispositivi in una sola richiesta. Google lo ha annunciato il 16 novembre 2026 sul blog di Search Central: tre nuove funzioni arrivano nella Search Analytics API, l'interfaccia che porta i dati di Search Console in altri strumenti. Conta per chi costruisce report SEO automatici, dashboard per i clienti o monitoraggi su più mercati.
In sintesi
- La dimensione
brandedClassificationdivide le query inBRANDEDeNON_BRANDED, senza più liste di parole chiave o espressioni regolari da mantenere. - Il tipo di ricerca
webMultimodalrestituisce i dati di Google Lens, Cerchia e Cerca su Android e delle immagini caricate nella Ricerca Google. - Il nuovo campo
filterListsfiltra più paesi o più dispositivi in una sola chiamata. - Il filtro brand vale solo per le proprietà di primo livello con abbastanza query e impressioni: per le altre la risposta arriva senza righe.
Cosa cambia nella Search Console API
La Search Analytics API è l'interfaccia con cui programmi, fogli di calcolo e strumenti esterni leggono i dati del report Prestazioni di Search Console: clic, impressioni, CTR e posizione media. Il post del 16 novembre 2026 è firmato dal team di Search Console. Due delle tre funzioni erano già nel report Prestazioni: il filtro brand dal novembre 2025 e il tipo di ricerca multimodale dal settembre 2026. Per il filtro su più paesi e dispositivi il post rimanda a un annuncio di Google su LinkedIn.
Nella documentazione dell'API c'è anche un dettaglio tecnico da non perdere: il parametro searchType è indicato come deprecato e va sostituito da type. Se un vostro script usa ancora il vecchio nome, è il momento giusto per aggiornarlo.
Query brand e non brand: come funziona il filtro nell'API
Una query brand è una ricerca che contiene il nome del vostro marchio o che si riferisce a un prodotto o servizio unico del vostro sito. Google spiega che la classificazione non si basa su espressioni regolari ma su un sistema interno assistito dall'AI, che riconosce il marchio in tutte le lingue e anche con i refusi più comuni. Google stesso avverte che alcune query possono essere classificate in modo sbagliato.
Nell'API il filtro funziona con queste regole, riportate nella documentazione ufficiale:
- si usa la dimensione
brandedClassificationcon i valoriBRANDEDoNON_BRANDEDe solo con l'operatoreequals; - non si può combinare nella stessa richiesta con un filtro sulla dimensione
query; - i dati sono disponibili a partire dal 21 febbraio 2026;
- vale solo per le proprietà di primo livello, non per le proprietà con un percorso (come example.com/blog) o per i sottodomini, e richiede un volume sufficiente di query e impressioni.
Perché è utile: le ricerche brand misurano soprattutto la notorietà del marchio, quelle non brand misurano quanto la SEO porta clienti nuovi. Tenerle insieme falsa la lettura. Un e-commerce che fa molta pubblicità, per esempio, può vedere salire i clic organici solo perché più persone cercano il nome del negozio, mentre il traffico non brand resta fermo. Ne abbiamo parlato anche nella guida alla SEO per Shopify e al posizionamento su Google.
Ricerche con Google Lens e immagini: il tipo webMultimodal
La ricerca multimodale è la ricerca fatta partendo da un'immagine invece che da un testo. Nell'API si ottiene impostando type su webMultimodal: secondo la documentazione comprende i risultati di Google Lens, di Cerchia e Cerca su Android e delle immagini caricate nella Ricerca Google. Google aveva introdotto questo tipo di ricerca nel report Prestazioni il 24 settembre 2026, con distribuzione globale.
Per un negozio online il dato è prezioso: chi fotografa una scarpa, un mobile o un'etichetta e cerca dove comprarla è un cliente con un'intenzione molto concreta. Le proprietà che hanno attivo l'export collettivo dei dati verso BigQuery ricevono questi dati anche lì. Per capire da dove arrivano davvero le visite organiche nel vostro strumento di analytics, vi può servire la nostra guida su come riconoscere il traffico da Google Search.
Più paesi e più dispositivi in una sola richiesta
Il campo filterLists permette di indicare più valori per la stessa dimensione in un'unica voce. Secondo la documentazione funziona con due dimensioni:
- country, con i codici paese a tre lettere ISO 3166-1 alpha-3 (per esempio
ITA,DEU,FRA); - device, con i valori
DESKTOP,MOBILEeTABLET.
Non si può filtrare la stessa dimensione sia con filters sia con filterLists nella stessa richiesta. Per chi vende in più mercati europei significa poter estrarre in una chiamata i dati di un gruppo di paesi, invece di farne una per paese e sommarle a mano. I filtri si possono anche combinare: per esempio solo query non brand, solo mobile, solo i paesi in cui spedite.
Cosa fare in pratica
- Controllate l'idoneità. Aprite il report Prestazioni di Search Console sulla proprietà di primo livello e verificate se compare il filtro brand. Se non c'è, l'API restituirà zero righe.
- Aggiornate gli script. Sostituite
searchTypecontypee togliete le vecchie liste di parole chiave usate per separare il traffico brand. - Aggiungete due viste fisse al report mensile. Clic e impressioni non brand (la crescita SEO vera) e il tipo
webMultimodal(le ricerche da immagine sui vostri prodotti). - Raggruppate i mercati. Con
filterListscreate un'unica estrazione per i paesi in cui vendete. - Automatizzate l'invio. Un flusso che ogni settimana interroga l'API e aggiorna un foglio o una dashboard evita il lavoro manuale. È il tipo di lavoro che seguiamo nelle automazioni per aziende ed e-commerce.
Ricordate un limite: l'API non garantisce di restituire tutte le righe, ma solo quelle principali entro i limiti interni di Search Console. Per analisi complete su siti grandi conviene l'export verso BigQuery. Se il report mostra pagine prodotto con molte impressioni e pochi clic, il passo successivo è lavorare sulle schede e sulla velocità del negozio con l'ottimizzazione e-commerce Shopify. E per il quadro generale di come sta cambiando la ricerca di Google, leggete il nostro articolo su Gemini 4 Hydrogen nella Ricerca Google.
Domande frequenti
Cos'è il filtro query brand della Search Console API?
È la dimensione brandedClassification della Search Analytics API, disponibile dal 16 novembre 2026. Divide le query in BRANDED e NON_BRANDED usando la classificazione automatica di Google, senza liste di parole chiave.
Perché l'API non restituisce dati sulle query brand?
Il filtro vale solo per le proprietà di primo livello con un volume sufficiente di query e impressioni. Per le proprietà con un percorso, per i sottodomini o per i siti con poco traffico la risposta arriva senza righe.
Il tipo webMultimodal comprende Google Lens?
Sì. Secondo la documentazione di Google, webMultimodal comprende i risultati di Google Lens, di Cerchia e Cerca su Android e delle immagini caricate nella Ricerca Google.
Serve saper programmare per usare queste funzioni?
Per l'API sì, oppure serve uno strumento che la usi per voi. Il filtro brand e il tipo di ricerca multimodale sono comunque disponibili senza codice nel report Prestazioni di Search Console.
Vuoi report SEO che si aggiornano da soli?
Se vuoi un report che separi traffico brand e non brand, mostri le ricerche da immagine e si aggiorni ogni settimana senza lavoro manuale, richiedi un preventivo: costruiamo il flusso sui dati del tuo sito.
Fonti: Google Search Central, New filtering and reporting capabilities in the Search Analytics API (16 novembre 2026); Google, documentazione Search Analytics: query; Google Search Central, filtro query brand in Search Console (20 novembre 2025); Google Search Central, ricerca multimodale in Search Console (24 settembre 2026).
Vuoi un aiuto concreto?
Applichiamo queste strategie al tuo store.
Dalla creazione dell'eCommerce all'advertising: raccontaci il progetto e ti diciamo cosa ha senso fare, in che ordine.
Continua a leggere



