Modelová situace: analytik každý měsíc stahuje čísla z Google Search Console do sdíleného přehledu. Značkové dotazy odděluje vlastním seznamem slov a protože firma prodává ve více zemích, pouští zvláštní dotaz pro každou zemi a výsledky sčítá v tabulce. Je to pracné a snadno se v tom udělá chyba.
Google 16. listopadu 2026 oznámil, že tři funkce z přehledu výkonu v Search Console jsou nově i v Search Analytics API. Přes toto rozhraní stahují skripty a nástroje na přehledy stejná data jako web Search Console. Příspěvek napsali Daniel Waisberg, Nati Yosephian a Karin Gadasi z týmu Search Console.
Údaje vycházejí z dokumentace Googlu ověřené k 19. listopadu 2026. Kde se zdroje liší nebo mlčí, je to uvedeno.
Jaké tři novinky přibyly do Search Analytics API?
Google přidal značkovou klasifikaci dotazů (brandedClassification), typ výsledků webMultimodal a seznam filtrů filterLists. Všechny tři už v přehledu výkonu existovaly, API tedy dohání to, co šlo dosud jen naklikat. Podle příspěvku se dají kombinovat, například při sledování značky v regionálních trzích.
Dokumentace řadí brandedClassification mezi dimenze, tedy vlastnosti, podle kterých se data člení, jako je země, zařízení nebo stránka. Při psaní požadavků platí její znění.
- brandedClassification: rozdělení dotazů na značkové a neznačkové, hodnoty jsou BRANDED a NON_BRANDED.
- type s hodnotou webMultimodal: výsledky hledání pomocí obrázku, tedy z Google Lens, z Circle to Search na Androidu a z nahrávání obrázků ve Vyhledávání.
- filterLists: filtr, který v jednom požadavku přijme více zemí nebo více zařízení najednou.
U jakých webů vrátí klasifikace značkových dotazů data?
Značkový pohled dostanou jen způsobilé vlastnosti, stejně jako v Search Console. Podle dokumentace jde o vlastnosti nejvyšší úrovně s dostatečným objemem dotazů a zobrazení. Příspěvek z listopadu 2025 o filtru v přehledu dodává, že nefunguje u adresy s cestou ani u subdomény. Minimální objem Google neuvádí.
U nezpůsobilé vlastnosti API chybu nevrátí, odpověď podle příspěvku jen neobsahuje žádné řádky. Prázdná odpověď proto sama nic nevypovídá: může znamenat nezpůsobilou vlastnost, ale i období před 21. únorem 2026, odkdy podle dokumentace data existují. Pomůže pomocný dotaz na stejné období bez klasifikace. Pokud řádky vrací a období leží po 21. 2. 2026, zbývá jako vysvětlení způsobilost vlastnosti.
Klasifikaci neprovádí seznam slov. Podle příspěvku z listopadu 2025 ji určuje interní systém podporovaný umělou inteligencí, který počítá s názvem značky ve všech jazycích i s překlepy. Za značkové označí i dotazy bez názvu, pokud míří na jedinečný produkt nebo službu webu. Google upozorňuje, že je kontextová a občas se zmýlí.
Vlastní tabulka značkových slov se s ní nebude shodovat, proto obě řady vedte odděleně. Meziroční srovnání přes API zatím není možné, protože o rok starší data neexistují. Ať podle brandedClassification filtrujete, nebo seskupujete, nelze ji v jednom požadavku spojit s filtrem query. Seskupení podle dimenze query dokumentace v tomto pravidle nezmiňuje, vyzkoušejte ho na krátkém období.
Jak ověřit značkové dotazy pro vlastní web
Ověřit, že jde o vlastnost nejvyšší úrovně, ne o adresu s cestou nebo subdoménu.
Poslat požadavek na zvolené období po 21. 2. 2026 bez značkové klasifikace a ověřit, že vrací řádky.
Stejný požadavek zopakovat s dimenzí brandedClassification a bez filtru query.
Prázdná odpověď při neprázdném pomocném dotazu a období po 21. 2. 2026 ukazuje na způsobilost vlastnosti, ne na chybu.
Značkové řady vést zvlášť od vlastních seznamů slov, protože definice značky se liší.
Co spadá pod web multimodal a kde budou data?
Pod web multimodal spadá hledání pomocí obrázku: Google Lens, Circle to Search na Androidu a nahrávání obrázků ve Vyhledávání Google. Modelová situace: prodejce nábytku chce vědět, zda se k němu lidé dostanou, když vyfotí cizí židli a hledají podobnou. Takové hledání patří pod typ webMultimodal, pokud z něj web získá zobrazení nebo kliknutí.
Circle to Search je funkce Androidu, kdy se na obrazovce označí část obrazu a podle ní se hledá. Příspěvek k přehledu výkonu z 24. září 2026 uvádí ještě funkci Chromu Search this image v nabídce pravého tlačítka. V dokumentaci API tento zdroj uvedený není.
Výchozí typ web odpovídá kombinované záložce Vše a podle dokumentace nezahrnuje Discover ani Google News. Zda se webMultimodal s typem web překrývá, žádný z přečtených zdrojů neříká, proto oba typy zatím nesčítejte.
Podle příspěvku z 16. listopadu 2026 budou data o multimodálním hledání i v BigQuery, ale jen u vlastností s aktivním hromadným exportem. BigQuery je databáze Googlu pro velké objemy dat a export se zapíná v nastavení vlastnosti. Datum zpřístupnění příspěvek neuvádí.
Stránka s tabulkami exportu k 19. listopadu 2026 multimodální typ mezi hodnotami pole search_type nezná, uvádí šest: web, image, video, news, discover a googleNews. Export nezahrnuje historii před zapnutím, zpětná data jdou jen z API nebo z přehledů.
K čemu slouží filterLists a co tím odpadá?
Seznam filterLists umožní v jednom požadavku filtrovat podle více zemí nebo více zařízení, takže odpadá skládání výsledků z několika požadavků. Modelový příklad (nejde o skutečná data): firma prodává do Česka a na Slovensko a chce jedno číslo za oba trhy jen z mobilů a tabletů. Bez filterLists by to znamenalo čtyři požadavky podle kombinací země a zařízení a ruční sečtení výsledků.
Seznam filterLists je ve skupině filtrů (dimensionFilterGroups) vedle pole filters. Jeho položka má povinné pole dimension a povinné pole expressions s hodnotami a řádek projde, pokud se jeho hodnota shoduje s kteroukoli z nich. Dokumentace ukázkový požadavek neobsahuje, struktura vychází z tabulky parametrů.
Země se zapisují třípísmennými kódy podle normy ISO 3166-1 alpha-3, například CZE a SVK, zařízení jako DESKTOP, MOBILE a TABLET. Příspěvek jako příklad uvádí skupiny EMEA, LATAM nebo DACH. Protože filterLists přijímá jen kódy zemí, skupinu je třeba rozepsat, u DACH tedy na DEU, AUT a CHE.
Google v příspěvku uvádí, že odpadá i údržba složitých seznamů klíčových slov v regulárních výrazech, což se vztahuje spíš ke značkovým dotazům než k zemím. Zůstává omezení na dimenze country a device a na přesné hodnoty.
Čím se API liší od filtrů v přehledu výkonu?
Hlavně pravidly a omezeními: stejné pohledy už v Search Console existovaly, API je zpřístupňuje skriptům a vlastním přehledům.
- Více zemí a zařízení: nápověda přehledu uvádí, že lze vybrat více zemí nebo zařízení a zobrazit jejich souhrnná data. V API to řeší filterLists jen pro country a device. Nápověda také říká, že nelze filtrovat podle více vzhledů ve výsledcích. Datum zavedení neuvádí.
- Porovnání: přehled umí porovnat dvě hodnoty a ukáže rozdíl, vždy jen jedno porovnání najednou.
- Značkové dotazy: filtr v přehledu je oznámený 20. listopadu 2025 a pro všechny způsobilé weby dostupný od 11. března 2026. API ho nabízí od 16. listopadu 2026, data začínají 21. února 2026.
- Multimodální hledání: v přehledu od 24. září 2026, v API od 16. listopadu 2026. Hromadný export do BigQuery má data získat, datum Google neuvádí.
Co ověřit, než se novinky zapojí do reportu?
Projděte omezení z dokumentace API platná k 19. listopadu 2026. Kombinace, které dokumentace nezakazuje, ale ani nepotvrzuje, vyzkoušejte na krátkém období. Napojení dat do pravidelných přehledů patří pod reporting a dashboardy, měření návštěv pod webovou analytiku.
- U značkové klasifikace ověřit vlastnost nejvyšší úrovně a dostatečný objem dat; podporovaný operátor je jen equals.
- Nespojovat brandedClassification s filtrem query v jednom požadavku, ať se podle ní filtruje, nebo seskupuje.
- U filterLists použít jen country a device a stejnou dimenzi nezadávat zároveň ve filters. Kombinaci seznamu zemí se seznamem zařízení vyzkoušet na krátkém období, dokumentace ji v příkladu neukazuje.
- Skupiny filtrů spojovat jen přes groupType and; hodnotu or API zatím nepodporuje.
- Při filtrování nebo seskupení podle page nepoužít aggregationType byProperty, dokumentace doporučuje auto.
- Kombinaci webMultimodal s brandedClassification dokumentace výslovně neuvádí, proto ji otestovat.
- Pro přesné součty vynechat dimenze page a query a stránkovat přes rowLimit (nejvýš 25 tisíc řádků) a startRow; API navíc vrací jen nejlepší řádky, nejvýš 50 tisíc na den a typ vyhledávání.
Zdroje a stav informací
Stav informací k 19. 11. 2026. Údaje jsou ověřené u těchto zdrojů:
- Příspěvek o novinkách ve filtrování a reportování v Search Analytics API (16. 11. 2026) (Google Search Central Blog)
- Search Analytics: query | Search Console API (Google for Developers)
- Introducing the branded queries filter in Search Console (Google Search Central Blog)
- Příspěvek o multimodálním hledání v přehledu výkonu Search Console (24. 9. 2026) (Google Search Central Blog)
- Performance report (Search results): Advanced filtering and comparison (Nápověda Search Console (Google))
- Návod k získání všech dat o výkonu přes Search Console API (Google for Developers)
- Nastavení hromadného exportu dat do BigQuery (nápověda Search Console) (Nápověda Search Console (Google))
- Hromadný export dat: struktura tabulek (nápověda Search Console) (Nápověda Search Console (Google))
Jak články vznikají a ověřují: redakční zásady blogu.
Než přepíšete přehledy, vyzkoušejte tři požadavky na krátkém období: značkové dotazy bez filtru na query, typ webMultimodal a více zemí přes filterLists. Prázdnou odpověď u značkových dotazů porovnejte se stejným obdobím bez klasifikace a značkové řady začínejte 21. 2. 2026.