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

Typ vlastnosti
Ověřit, že jde o vlastnost nejvyšší úrovně, ne o adresu s cestou nebo subdoménu.
Pomocný dotaz
Poslat požadavek na zvolené období po 21. 2. 2026 bez značkové klasifikace a ověřit, že vrací řádky.
Značkový dotaz
Stejný požadavek zopakovat s dimenzí brandedClassification a bez filtru query.
Vyhodnocení prázdné odpovědi
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.
Oddělené řady
Značkové řady vést zvlášť od vlastních seznamů slov, protože definice značky se liší.
Postup vychází z toho, že nezpůsobilá vlastnost vrací prázdnou odpověď, a z data začátku klasifikace v dokumentaci API.

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.

  1. U značkové klasifikace ověřit vlastnost nejvyšší úrovně a dostatečný objem dat; podporovaný operátor je jen equals.
  2. Nespojovat brandedClassification s filtrem query v jednom požadavku, ať se podle ní filtruje, nebo seskupuje.
  3. 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.
  4. Skupiny filtrů spojovat jen přes groupType and; hodnotu or API zatím nepodporuje.
  5. Při filtrování nebo seskupení podle page nepoužít aggregationType byProperty, dokumentace doporučuje auto.
  6. Kombinaci webMultimodal s brandedClassification dokumentace výslovně neuvádí, proto ji otestovat.
  7. 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ů:

Jak články vznikají a ověřují: redakční zásady blogu.

ZKUSTE TO V PRAXI

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.

Nejasný pojem?Nahlédněte do slovníku ↗