Google zaktualizowało Search Analytics API w Google Search Console, przenosząc do API trzy funkcje, które dotychczas były dostępne wyłącznie w panelu WWW albo wymagały obejść po stronie własnych skryptów: natywną klasyfikację zapytań brandowych (brandedClassification), oddzielny typ wyszukiwania dla ruchu wizualnego i multimodalnego (webMultimodal) oraz wielowartościowe listy filtrów krajów i urządzeń (filterLists). Dla osób budujących własne dashboardy, łączących GSC z BigQuery czy rozwijających własne narzędzia SEO to jedna z bardziej praktycznych zmian w API w tym roku.
1. Natywna klasyfikacja zapytań brandowych (brandedClassification)
Dotychczas rozdzielenie ruchu na Brand i Non-brand w danych z API oznaczało konieczność utrzymywania własnych reguł dopasowania nazwy firmy, domeny oraz najczęstszych literówek. Takie podejście ma trzy słabe punkty:
- reguły trzeba aktualizować ręcznie dla każdej domeny,
- proste dopasowanie tekstowe nie wyłapuje zapytań o powiązane produkty czy warianty nazwy marki,
- przy pobieraniu danych na poziomie zapytań tracisz zanonimizowane frazy, przez co suma kliknięć nie zgadza się z pełnym wykresem w Search Console.
Nowy wymiar i filtr brandedClassification pozwala grupować lub filtrować dane bezpośrednio według klasyfikacji Google (wartości BRANDED oraz NON_BRANDED).
Ograniczenia w API, o których warto pamiętać:
- Nie każdy serwis ma tę opcję. Zarówno w panelu GSC (pod Query -> Filter jako Branded queries / Non-branded queries), jak i w API funkcja pojawia się wyłącznie dla kwalifikujących się usług o odpowiednim wolumenie ruchu - na mniejszych lub nowszych domenach filtr w ogóle się nie wyświetla, a API zwraca pusty zestaw wierszy.
- W filtrze
brandedClassificationobsługiwany jest wyłącznie operatorequals. - Klasyfikacji
brandedClassificationnie można łączyć z filtrem `query` w jednym żądaniu API.
W praktyce najlepiej sprawdza się model hybrydowy: pobieranie brandedClassification do dziennych sum (razem z ruchem zanonimizowanym) tam, gdzie Google zwraca dane, oraz pozostawienie własnego matchera jako fallbacku dla mniejszych domen.

2. Ruch z wyszukiwania multimodalnego (type: "webMultimodal")
W Search Analytics API pojawił się nowy typ wyszukiwania: webMultimodal (obok dotychczasowych web, image, video, news itp.).
Obejmuje on kliknięcia, wyświetlenia, CTR oraz średnią pozycję z wyszukiwań wizualnych i multimodalnych:
- Google Lens,
- Circle to Search na Androidzie,
- wyszukiwania przez przesłanie zdjęcia w Google Search,
- opcji „Szukaj obrazu” w przeglądarce Chrome.

Ważne ograniczenie w API: ponieważ punktem wyjścia jest obraz, a nie zapytanie tekstowe, dla type: "webMultimodal" nie jest dostępny wymiar `query`. Raporty można pobierać po dacie (date), adresie URL (page), kraju (country) oraz urządzeniu (device).

Dla branż wizualnych (e-commerce, wnętrza, moda, kosmetyki czy lokalne usługi beauty) to pierwsza możliwość automatycznego śledzenia w API, ile ruchu pochodzi z zapytań obrazem zamiast wpisywania fraz w wyszukiwarkę.
3. Filtrowanie po wielu krajach i urządzeniach jednocześnie (filterLists)
Trzecia nowość upraszcza zapytania wielorynkowe. Pole dimensionFilterGroups[].filterLists[] pozwala w jednym wywołaniu API dopasować wiersze do listy dokładnych wartości (logika OR wewnątrz listy) dla wymiarów country (kody ISO 3166-1 alpha-3) lub device (DESKTOP, MOBILE, TABLET).
Zamiast wysyłać osobne żądania dla każdego kraju i składać dane po swojej stronie albo pobierać pełny ruch i ciąć go lokalnie, możesz odfiltrować np. grupę rynków jednym zapytaniem. Ograniczenie: w jednym żądaniu nie można jednocześnie filtrować tego samego wymiaru przez filters i filterLists.
Podsumowanie i plan wdrożenia we własnym narzędziu
- Rozszerz klienta Search Analytics API o parametr
type: "webMultimodal"oraz obsługędimensionFilterGroups[].filterLists[]. - Dodaj opcjonalną synchronizację wymiaru
["date", "brandedClassification"]i porównaj rozkład Brand/Non-brand z dotychczasowym regexem. - Traktuj
brandedClassificationiwebMultimodaljako dane opcjonalne w pipeline synchronizacji, żeby mniejsze lub niekwalifikujące się domeny nie przerywały pobierania danych.
Najczęściej zadawane pytania
brandedClassification to natywny wymiar i filtr w Google Search Analytics API (listopad 2026), który dzieli ruch z wyszukiwarki na zapytania brandowe (BRANDED) oraz niebrandowe (NON_BRANDED) według klasyfikacji Google, bez konieczności utrzymywania własnych wyrażeń regularnych.
Zarówno w panelu WWW Google Search Console, jak i w API funkcja brandedClassification jest dostępna wyłącznie dla kwalifikujących się usług o odpowiednim wolumenie ruchu. Na mniejszych lub nowszych domenach filtr nie pojawia się w interfejsie, a API zwraca pusty zestaw wierszy.
Typ webMultimodal raportuje kliknięcia, wyświetlenia, CTR i średnią pozycję z wyszukiwań wizualnych oraz multimodalnych: Google Lens, Circle to Search na Androidzie, przesyłania zdjęć w Google Search oraz opcji „Szukaj obrazu” w Chrome. Ze względu na brak zapytania tekstowego wymiar query nie jest w tym trybie dostępny - dane można pobierać po date, page, country i device.
Pole dimensionFilterGroups[].filterLists[] pozwala w jednym wywołaniu API dopasować wiersze do listy dokładnych wartości (logika OR wewnątrz listy) dla wymiarów country (kody ISO 3166-1 alpha-3) lub device (DESKTOP, MOBILE, TABLET). W jednym żądaniu nie można jednocześnie filtrować tego samego wymiaru przez filters i filterLists.
Źródła
- Google Search Central Blog: Search Analytics API update (listopad 2026)
Sprawdzę indeksację, robots.txt i renderowanie - dostaniesz listę konkretów do naprawy.




