Search Analytics API z filtrami marki, multimodalności i wielu rynków
16 listopada 2026 · Aktualności
Raport wyników w Search Console przez ostatni rok zmieniał się szybciej niż jego odpowiednik w API. Filtry zapytań markowych, dane o wyszukiwaniu multimodalnym oraz filtrowanie po wielu krajach i urządzeniach pojawiały się w interfejsie, ale nie w punkcie końcowym, z którego korzystają narzędzia zewnętrzne i własne dashboardy. Google domknął tę lukę: wszystkie trzy możliwości są teraz dostępne w Search Analytics API. Dla zespołów, które raportują poza interfejsem, oznacza to koniec części obejść — na przykład ręcznie utrzymywanych list wyrażeń regularnych do rozpoznawania zapytań markowych.
Co dokładnie trafiło do API
Search Analytics API to warstwa, przez którą dane o wynikach wyszukiwania wychodzą poza Search Console. Korzystają z niej wewnętrzne systemy raportowe, aplikacje do monitoringu pozycji i zewnętrzni dostawcy narzędzi SEO. Do tej pory trzy nowsze mechanizmy podziału danych trzeba było odtwarzać samodzielnie albo pobierać je z interfejsu ręcznie.
Teraz każdy z nich jest osobnym, udokumentowanym elementem zapytania. Zmiana jest odpowiedzią na zgłoszenia z ekosystemu — prośby o udostępnienie tych danych do raportowania niestandardowego i zautomatyzowanych procesów. To istotne zastrzeżenie: nie chodzi o nowe metryki, lecz o nowe sposoby cięcia tych samych danych, które wcześniej były dostępne wyłącznie w raporcie wydajności.
W praktyce oznacza to, że wynik zapytania można teraz zawęzić po stronie API, zamiast pobierać szerszy zbiór i filtrować go dopiero w arkuszu lub w bazie. Dla dużych witryn różnica w liczbie pobieranych wierszy bywa większa niż różnica w samym zapytaniu.
Trzy nowe parametry w praktyce
Dokumentacja opisuje trzy dodatki, które można łączyć w jednym wywołaniu. Każdy odpowiada funkcji znanej już z interfejsu, ale dopiero teraz dostępnej w zapytaniu programowym.
- Zapytania markowe — parametr
brandedClassificationpozwala grupować lub filtrować dane według podziału na ruch markowy i niemarowy. Działa to tak samo jak w Search Console, czyli wyłącznie dla usług, które kwalifikują się do tego raportu. - Wyszukiwanie multimodalne — ustawienie
typena wartośćwebMultimodalzwraca dane o wynikach generowanych przez Google Lens, Circle to Search na Androidzie oraz wyszukiwanie obrazem wgranym do Wyszukiwarki Google. - Filtry wielu krajów i urządzeń — nowe pole
filterListsumożliwia zawężenie zapytania do kilku krajów albo kilku typów urządzeń jednocześnie, bez wysyłania osobnych żądań dla każdej kombinacji. - Łączenie filtrów — parametry działają razem, więc w jednym zapytaniu można połączyć grupę krajów, zestaw urządzeń i podział markowy, a następnie porównać segmenty w obrębie jednego wyniku.
- Eksport zbiorczy — dane multimodalne trafiają również do BigQuery dla usług, które mają aktywowany zbiorczy eksport danych.
Warto zwrócić uwagę na ostatni punkt, bo zmienia sposób pracy zespołów analitycznych. Zamiast cyklicznie odpytywać API i składać historię we własnym magazynie, można korzystać z danych, które i tak są już eksportowane do hurtowni.
Dlaczego to więcej niż wygoda
Do tej pory raportowanie międzynarodowe wymagało albo wielu zapytań, albo kompromisu: jedno zapytanie na kraj, jedno na typ urządzenia i ręczne scalanie wyników. Przy kilkunastu rynkach liczba kombinacji rośnie szybko, a wraz z nią koszt utrzymania pipeline'u i ryzyko, że któraś kombinacja wypadnie z harmonogramu.
Możliwość wskazania grupy krajów w jednym wywołaniu upraszcza ten obraz. Google podaje jako przykłady regiony EMEA, LATAM i DACH — czyli zbiory, które w raportach biznesowych i tak funkcjonują jako całość. Zamiast więc dopasowywać strukturę zapytań do listy państw, można oprzeć ją na tym, jak firma faktycznie dzieli rynki.
Drugi zysk dotyczy rozdzielenia ruchu markowego od niemarowego. Utrzymywanie własnej listy wyrażeń regularnych z nazwami marki to zajęcie, które starzeje się razem z każdą kampanią i każdym nowym wariantem nazwy. Przeniesienie tego podziału do API oznacza, że definicja przestaje zależeć od tego, czy ktoś pamiętał dopisać kolejny wariant do listy.
Trzeci obszar to treści multimodalne. Skoro wynik może powstać z obrazu, nie z tekstu, osobny zbiór danych pozwala ocenić, które strony radzą sobie w tego typu wyszukiwaniu. Bez tego cały ten ruch rozpływał się w ogólnej liczbie wyświetleń i nie dawał się przypisać do konkretnego formatu treści.
Ograniczenia, o których trzeba pamiętać
Najważniejsze zastrzeżenie dotyczy zapytań markowych. Dane są dostępne tylko dla usług kwalifikujących się do tego raportu — dla pozostałych odpowiedź nie zawiera żadnych wierszy. Pusty wynik nie jest więc błędem zapytania ani awarią, lecz konsekwencją tego, że dana usługa nie spełnia warunków.
Podobnie trzeba czytać dane multimodalne. Obejmują one konkretne powierzchnie: Google Lens, Circle to Search na Androidzie i wyszukiwanie obrazem w Wyszukiwarce. To nie jest zbiorczy pomiar wszystkich niestandardowych wyników, jakie Google potrafi pokazać, i nie należy rozciągać tych liczb na inne formaty.
Eksport do BigQuery również zależy od konfiguracji. Działa dla usług z aktywnym zbiorczym eksportem danych, więc w witrynach, które go nie mają, ta ścieżka po prostu nie będzie dostępna. Warto to sprawdzić przed zaplanowaniem raportu, zamiast odkrywać ograniczenie w momencie wdrożenia.
I wreszcie sama natura zmiany: to nowe filtry, nie nowe wskaźniki. Wyświetlenia, kliknięcia i pozycje pozostają tym, czym były — zmienia się jedynie możliwość patrzenia na nie z kilku perspektyw naraz. Kto oczekuje innych liczb, znajdzie tu raczej lepszy podział niż nową miarę.
Od czego zacząć wdrożenie
Pierwszy krok jest porządkowy: sprawdź, które usługi kwalifikują się do podziału markowego i czy mają włączony eksport zbiorczy. To dwa warunki, które decydują o tym, czy nowe parametry w ogóle zwrócą dane, i szkoda czasu na budowanie raportu wokół nich bez tej wiedzy.
Drugi krok to porównanie z tym, co robisz dziś. Jeśli utrzymujesz listy wyrażeń regularnych dla zapytań markowych albo wysyłasz osobne zapytania na każdy kraj, zacznij od jednego segmentu i sprawdź, czy wynik pokrywa się z dotychczasowym. Dopiero potem warto przepisywać cały pipeline — różnice w definicjach potrafią być subtelniejsze, niż wyglądają na pierwszy rzut oka.
Trzeci krok jest dokumentacyjny. Zapisz, jakie grupy krajów i jakie kombinacje urządzeń są używane w raportach, żeby filterLists odzwierciedlało realny podział firmy, a nie przypadkowy zestaw z pierwszego testu. Przy okazji warto ustalić, kto odpowiada za aktualizację tych definicji, gdy pojawi się nowy rynek.
Na koniec zostaje strona, od której wszystko się zaczyna — same treści i ich techniczna jakość. Dane z API pokażą, które adresy wypadają lepiej w wynikach multimodalnych albo w ruchu niemarowym, ale nie naprawią tytułów, opisów ani danych strukturalnych. Nasze narzędzia SEO pozwalają sprawdzić te elementy na stronie, żeby wnioski z raportu miały pokrycie w tym, co faktycznie widzi robot.