16 listopada 2026 Google dodał do Search Analytics API trzy rzeczy, które do tej pory miał tylko interfejs Search Console: podział na zapytania brandowe i niebrandowe, dane z wyszukiwania obrazem oraz filtr po kilku krajach lub urządzeniach w jednym żądaniu. Komuś, kto przegląda raporty ręcznie, niewiele to zmienia, ale w dashboardach, raportach w Looker Studio i własnych skryptach można wreszcie wyrzucić listy fraz z nazwą marki i pętle, które odpytywały API osobno dla każdego kraju.

Co dokładnie ogłosił Google

Wpis na blogu Google Search Central podpisali Daniel Waisberg, Nati Yosephian i Karin Gadasi z zespołu Search Console. Każda z nowości działała już w raporcie skuteczności w interfejsie, a do API trafiła, bo według autorów prosili o to twórcy narzędzi i osoby, które automatyzują raportowanie. Wiadomość podał też tego samego dnia Search Engine Roundtable.

NowośćJak jej użyć w APINajważniejsze ograniczenie
Zapytania brandowegrupowanie lub filtr po brandedClassification (wartości BRANDED i NON_BRANDED)działa tylko dla kwalifikujących się usług, pozostałe dostają odpowiedź bez wierszy
Wyszukiwanie multimodalnetype ustawiony na webMultimodalobejmuje Google Lens, Circle to Search na Androidzie i przesyłanie obrazów do wyszukiwarki
Kilka krajów i urządzeńnowe pole filterListstego samego wymiaru nie można filtrować naraz przez filters i filterLists

Zmiany dotyczą metody searchanalytics.query, a jej dokumentacja dopowiada szczegóły, których w ogłoszeniu nie ma.

Zapytania brandowe: brandedClassification

Filtr zapytań brandowych pojawił się w interfejsie Search Console w listopadzie 2025 roku, a od marca 2026 Google udostępnia go wszystkim kwalifikującym się witrynom. Za zapytanie brandowe Google uznaje takie, które zawiera nazwę marki, jej warianty lub literówki, a także zapytanie o produkt czy usługę charakterystyczną dla danej witryny, nawet bez nazwy. Podział robi wewnętrzny system wspomagany przez AI, który rozpoznaje nazwę marki w różnych językach, więc żaden regex nie jest tu potrzebny. Google zastrzega, że część zapytań może trafić do złej grupy, a sam filtr nie ma wpływu na ranking.

Do tej pory automatyczny podział ruchu wymagał własnej listy fraz albo regexa na wymiarze query. Taka lista się starzeje, nie łapie wszystkich literówek i nie widzi zapytań o produkt, w których marki nie ma. Teraz API samo zwraca obie grupy i można je zestawić w jednym raporcie.

Dokumentacja dodaje warunki, które trzeba znać przed zbudowaniem raportu:

  • filtr brandedClassification obsługuje tylko operator equals,
  • grupowania ani filtra po tym wymiarze nie można połączyć w jednym żądaniu z filtrem po query,
  • dane są dostępne od 21 lutego 2026,
  • działa to tylko dla usług najwyższego poziomu (nie dla usług ze ścieżką, np. example.com/blog/, ani dla subdomen) i tylko przy wystarczającej liczbie zapytań i wyświetleń.

Ostatni punkt ma praktyczne skutki, bo usługa, która nie spełnia warunków, dostaje zamiast błędu pustą odpowiedź. Skrypt albo konektor do hurtowni danych musi ten przypadek rozpoznać: brak wierszy nie oznacza zera kliknięć z marki, a raport nie powinien się na nim wywracać.

Najbardziej przyda się to przy rzetelnej ocenie efektów SEO. Zapytania brandowe mają zwykle wysokie pozycje i CTR, więc w jednej linii kliknięć potrafią przykryć stagnację ruchu niebrandowego, czyli tego, który pokazuje, czy znajdują Cię nowe osoby. Dwie osobne serie na wykresie odpowiadają na to lepiej. Widać na nich też efekt kampanii wizerunkowych, bo wzrost zapytań o markę nie ginie w reszcie ruchu.

Klasyfikację robi teraz model Google, więc oszczędzasz pracę, ale zależysz od cudzego algorytmu. Przy marce, której nazwa jest zwykłym słowem, wyniki trzeba sprawdzać krytycznie.

Wyszukiwanie obrazem: webMultimodal

Raport wyszukiwania multimodalnego trafił do interfejsu Search Console 24 września 2026. Obejmuje wyszukiwania przez Google Lens, Circle to Search na Androidzie i przesyłanie obrazów do wyszukiwarki. We wrześniowym ogłoszeniu Google wymieniał też opcję „Search this image” z menu kontekstowego Chrome. Teraz te same dane pobierzesz z API, ustawiając type na webMultimodal.

Dla usług z aktywnym zbiorczym eksportem danych (bulk data export) dane multimodalne mają też trafiać do BigQuery. Przy większych witrynach to wygodniejsza droga niż API, które w jednym żądaniu oddaje najwyżej 25 000 wierszy, i to tylko te z najwyższymi wartościami, bez gwarancji kompletu.

Do tej pory wyszukiwanie obrazem ginęło w ogólnych statystykach, więc sprawdziłbym, ile ruchu przychodzi tą drogą, zwłaszcza w sklepie z produktami, które ludzie fotografują telefonem, w serwisie z przepisami albo w poradniku o roślinach. Puste dane oznaczają, że nie ma czego optymalizować. Gdy liczby rosną, przejrzyj jakość obrazów, teksty alternatywne i strony, które w tym kanale pojawiają się najczęściej, ale z wnioskami o trendach poczekaj, bo ten segment ma jeszcze krótką historię.

Inne raporty o wyszukiwaniu z AI, które Google szykował dla Search Console, opisałem w tekście o raportach AI Search w Search Console.

filterLists: kilka krajów i urządzeń w jednym żądaniu

Pole filterLists siedzi wewnątrz dimensionFilterGroups, obok zwykłych filters. Zwykły filtr porównuje wymiar z jedną wartością, a filterLists przyjmuje dla jednego wymiaru listę dokładnych wartości. Wiersz pasuje, jeśli jego wartość jest równa którejkolwiek z nich. Dokumentacja wymienia dwa wymiary: country (trzyliterowe kody krajów ISO 3166-1 alfa-3) i device (DESKTOP, MOBILE, TABLET).

Poniższy przykład napisałem sam na podstawie schematu z dokumentacji, nie pochodzi od Google i nie uruchamiałem go na API. Pobiera podział na ruch brandowy i niebrandowy z urządzeń mobilnych w Polsce, Niemczech i Czechach:

{
  "startDate": "2026-10-01",
  "endDate": "2026-10-31",
  "type": "web",
  "dimensions": ["brandedClassification"],
  "dimensionFilterGroups": [
    {
      "groupType": "and",
      "filterLists": [
        { "dimension": "country", "expressions": ["POL", "DEU", "CZE"] },
        { "dimension": "device", "expressions": ["MOBILE"] }
      ]
    }
  ]
}

Wcześniej taki zakres wymagał kilku osobnych żądań, których wyniki trzeba było potem łączyć po swojej stronie. To zdradliwe, bo średniej pozycji i CTR nie da się po prostu zsumować. Teraz Google liczy je od razu dla całej grupy, a przy okazji kod jest prostszy i łatwiej zmieścić się w limitach API.

Google podaje jako przykład grupy rynków EMEA, LATAM i DACH. W jednym żądaniu nie można jednak filtrować tego samego wymiaru naraz przez filters i filterLists.

Jak połączyć nowe filtry

Google podkreśla, że filtry działają razem. Daje to na przykład takie zestawienia:

  1. Zapytania brandowe z grupy krajów, np. DACH, osobno dla komputerów i telefonów, pokażą, czy rozpoznawalność rośnie tam, gdzie wchodzisz na nowy rynek.
  2. Wyszukiwanie obrazem z podziałem na rynki i urządzenia pokaże, które strony zbierają ruch z Lens i Circle to Search w wybranych krajach.
  3. Ruch niebrandowy z telefonów to wejścia zdobyte bez nazwy marki na urządzeniach, z których w wielu serwisach przychodzi większość ruchu.

Przy łączeniu pamiętaj, że filtr brandowy nie współpracuje z filtrem po query. Zestawienia „zapytania brandowe zawierające daną frazę” nie zbudujesz jednym żądaniem.

Czego nie wiadomo i na co uważać

  • Próg dla danych brandowych. Google nie podaje progu liczby zapytań i wyświetleń. Wiadomo tylko, że usługa, która go nie spełnia, dostaje pusty wynik.
  • Dokładność klasyfikacji. Zapytania na brandowe i niebrandowe dzieli model Google i może się przy tym mylić. Wartości bezwzględne traktuj orientacyjnie, trendy są bardziej wiarygodne niż pojedyncze liczby.
  • Historia danych. Dane brandowe są dostępne od 21 lutego 2026, więc pełne porównanie rok do roku da się zrobić najwcześniej w lutym 2027.
  • Udział wyszukiwania obrazem. Google nie podaje, jaką część ruchu stanowi wyszukiwanie multimodalne. Czy w Twoim przypadku to istotny kanał, pokażą dopiero Twoje dane.
  • Narzędzia zewnętrzne. Z ogłoszenia nie wynika, kiedy nowe pola trafią do konektorów (także tego do Looker Studio) i narzędzi SEO opartych na API.

Podsumowanie

Te dane znasz już z interfejsu, a od teraz możesz je pobierać automatycznie. Najwięcej zyskają osoby, które raportują dla wielu rynków i marek, i zespoły, które utrzymywały własne listy fraz brandowych. Jeśli korzystasz z API, sprawdź nowe wartości w dokumentacji, dopisz obsługę pustych odpowiedzi i zacznij od prostego zestawienia: ruch brandowy kontra niebrandowy w ostatnich miesiącach. Podstawy pracy z narzędziem znajdziesz w przewodniku po Google Search Console.

Często zadawane pytania

Co nowego jest w Search Analytics API?

Google dodał trzy opcje: grupowanie i filtrowanie po brandedClassification (zapytania brandowe i niebrandowe), typ wyszukiwania webMultimodal oraz pole filterLists, które pozwala filtrować po kilku krajach lub urządzeniach w jednym żądaniu. Wszystkie trzy funkcje działały wcześniej w interfejsie Search Console.

Dlaczego API zwraca pustą odpowiedź przy filtrze brandowym?

Dane o zapytaniach brandowych są dostępne tylko dla kwalifikujących się usług: usług najwyższego poziomu z wystarczającą liczbą zapytań i wyświetleń. Usługi ze ścieżką w adresie, subdomeny i małe witryny dostają odpowiedź bez wierszy. Dokumentacja opisuje to jako zwykłe zachowanie API, więc samo zapytanie jest w porządku.

Jak pobrać dane z Google Lens i Circle to Search przez API?

Ustaw w żądaniu type na webMultimodal. Dane obejmują Google Lens, Circle to Search na Androidzie i przesyłanie obrazów do wyszukiwarki Google. Dla usług z aktywnym zbiorczym eksportem danych mają też trafiać do BigQuery.

Czy filtr brandowy można połączyć z filtrem po frazie?

Nie. Filtrowania i grupowania po brandedClassification nie można łączyć z filtrem po query w tym samym żądaniu. Można za to łączyć je z krajami, urządzeniami i typem wyszukiwania.

Źródła

  1. New filtering and reporting capabilities in the Search Analytics API Google Search Central Blog · developers.google.com ·
  2. Search Analytics: query Google for Developers · developers.google.com
  3. Introducing the branded queries filter in Search Console Google Search Central Blog · developers.google.com ·
  4. Announcing web multimodal Search performance reporting in Search Console Google Search Central Blog · developers.google.com ·
  5. Google Search Analytics API Adds Branded Queries, Multimodal & Country/Devices Filters Search Engine Roundtable · seroundtable.com ·