---
title: "Aktualizacja Google Search Analytics API (listopad 2026): brandedClassification, webMultimodal i filterLists"
slug: "aktualizacja-google-search-analytics-api-listopad-2026"
date: 2026-11-17
lastUpdated: 2026-11-18
description: "Google przeniosło do Search Analytics API trzy funkcje znane dotąd z panelu WWW: natywną klasyfikację zapytań brandowych (brandedClassification), dane z wyszukiwania multimodalnego (webMultimodal) oraz wielowartościowe filtry krajów i urządzeń (filterLists)."
author: "Jakub Krysmalski"
canonical: "https://krysmalski.pl/blog/aktualizacja-google-search-analytics-api-listopad-2026"
tags:
  - "SEO"
---

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 `brandedClassification` obsługiwany jest wyłącznie operator `equals`.
- Klasyfikacji `brandedClassification` **nie 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

1. Rozszerz klienta Search Analytics API o parametr `type: "webMultimodal"` oraz obsługę `dimensionFilterGroups[].filterLists[]`.
1. Dodaj opcjonalną synchronizację wymiaru `["date", "brandedClassification"]` i porównaj rozkład Brand/Non-brand z dotychczasowym regexem.
1. Traktuj `brandedClassification` i `webMultimodal` jako dane opcjonalne w pipeline synchronizacji, żeby mniejsze lub niekwalifikujące się domeny nie przerywały pobierania danych.

## Najczęściej zadawane pytania

### Czym jest brandedClassification w Google Search Analytics API?

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.

### Dlaczego brandedClassification nie działa na każdej domenie w Search Console?

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.

### Jakie dane zwraca nowy typ wyszukiwania type: "webMultimodal" w GSC API?

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.

### Do czego służy filterLists w Search Analytics API?

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)](https://developers.google.com/search/blog/2026/11/search-analytics-api-update)

---

*Wpis pochodzi z serwisu [krysmalski.pl](https://krysmalski.pl/blog/aktualizacja-google-search-analytics-api-listopad-2026)*
