Export dát zo Search Console: ako obísť limit 1 000 riadkov
Tlačidlo Exportovať v prehľade Výkon v Google Search Console stiahne najviac 1 000 riadkov, čo malému webu zvyčajne stačí, no pri väčšom webe sa tak k väčšine dopytov a stránok nedostanete. Google ponúka ešte tri ďalšie cesty: Search Console API, konektor v nástroji Data Studio a hromadný export do BigQuery, pričom každá má iný limit, inú náročnosť a iné pasce pri čítaní čísel. Článok ich porovnáva podľa oficiálnej dokumentácie a ukazuje, ako nastaviť export do BigQuery krok za krokom.
1. Štyri spôsoby exportu a ich limity
Dáta z prehľadu Výkon sa dajú zo Search Console dostať štyrmi spôsobmi, ktoré sa líšia hlavne tým, koľko riadkov vám poskytnú a koľko práce stojí ich nastavenie. Pomocník Search Console ich v sekcii o exporte radí od najjednoduchšieho, teda od tlačidla priamo v prehľade, cez API až po hromadný export do BigQuery (Google: Export Search Console data using the Search Console API). Štvrtou cestou je konektor v nástroji Data Studio, ktorý dáta načítava cez rovnaké rozhranie ako API.
| Spôsob | Koľko dát dostanete | Pre koho sa hodí |
|---|---|---|
| Tlačidlo Exportovať v prehľade | Najviac 1 000 riadkov, formát Google Sheets, Excel alebo CSV | Malé weby a rýchla jednorazová kontrola |
| Search Console API | Najviac 50 000 riadkov za deň, typ vyhľadávania a vlastníctvo | Stredne veľké weby, ktoré si vedia napísať skript |
| Konektor v Data Studiu | Rovnaký limit 50 000 riadkov ako API | Pravidelné prehľady pre klienta alebo vedenie bez programovania |
| Hromadný export do BigQuery | Všetky dáta okrem anonymizovaných dopytov, denne a bez limitu riadkov | Veľké weby a e-shopy s tisíckami stránok |
Limity v tabuľke pochádzajú z pomocníka Search Console a z blogu Google Search Central, ktorý v článku o údajoch výkonu uvádza, že cez rozhranie sa dá exportovať najviac 1 000 riadkov, kým API a konektor pre Data Studio vydajú najviac 50 000 riadkov za deň pre jeden web a jeden typ vyhľadávania (Google Search Central: Performance data deep dive). Pri hromadnom exporte Google píše, že uvidíte všetky údaje výkonu, ktoré má Search Console pre vaše vlastníctvo k dispozícii, s výnimkou anonymizovaných dopytov (Google: About bulk data export).
2. Export priamo z prehľadu: 1 000 riadkov
Väčšina prehľadov v Search Console má vpravo hore tlačidlo exportu, ktoré stiahne presne to, čo práve vidíte, vrátane použitých filtrov a zoskupenia. Pomocník uvádza, že dáta sú orezané na 1 000 riadkov reprezentatívnych príkladov, čo pri menšom webe môže byť väčšina alebo všetky údaje, no väčšie weby ich majú zvyčajne oveľa viac (Google: Export data directly from a Search Console report). Súčty v prehľade pritom zahŕňajú aj orezané dáta, takže súčet riadkov v stiahnutom súbore sa so súčtom v grafe nemusí zhodovať.
Exportuje sa graf aj tabuľka a na výber máte Google Sheets, Microsoft Excel alebo CSV. Hodnoty, ktoré prehľad zobrazuje ako „~“ alebo „-“, teda nedostupné údaje, budú v stiahnutom súbore nuly (Google: Performance report). Pri výpočte priemernej preklikovosti v tabuľkovom editore preto takéto riadky treba odfiltrovať, inak priemer klesne kvôli nulám, ktoré v skutočnosti znamenajú chýbajúci údaj.
Limit 1 000 riadkov sa dá čiastočne obísť filtrami, lebo každý export ich má 1 000 zvlášť. Ak web delíte napríklad na blog, kategórie a produkty, môžete stiahnuť tri exporty s filtrom stránok na každú sekciu, alebo použiť filter dopytov s regulárnym výrazom podľa návodu na regex filtre v Search Console. Úplné dáta to nenahradí, no pri webe s niekoľkými tisíckami dopytov je to najrýchlejšia cesta bez akéhokoľvek nastavovania.
3. Search Console API: až 50 000 riadkov denne
API (aplikačné programové rozhranie, teda spôsob, akým si dáta vypýta skript namiesto človeka) podporuje podľa pomocníka filtrovanie, zoraďovanie, typ agregácie a všetky ostatné funkcie dostupné v prehľadoch, no nie voľné SQL dopyty. Google ho opisuje ako bezplatné, s kvótou využitia, a vhodné pre stredne veľké weby, ktoré chcú viac dát, než ukáže prehľad (Google: Search Console API). Limit je 50 000 riadkov za deň pre každý typ vyhľadávania, napríklad web, obrázky alebo správy, a pre každé vlastníctvo.
Jedna požiadavka vráti podľa dokumentácie metódy searchanalytics.query predvolene 1 000 riadkov a parametrom rowLimit ich počet zvýšite až na 25 000. Ďalšie riadky získate stránkovaním cez parameter startRow, a keď startRow prekročí počet výsledkov, odpoveď je úspešná, len bez riadkov (Google: Search Analytics query). Parameter dataState s hodnotou all pridá aj čerstvé, ešte nespracované dáta, bez neho však dostanete len konečné údaje.
{
"startDate": "2026-10-01",
"endDate": "2026-10-31",
"dimensions": ["query", "page"],
"type": "web",
"rowLimit": 25000,
"startRow": 0
}
Pri väčšom objeme narazíte skôr na kvóty než na limit riadkov. Dokumentácia limitov uvádza, že najdrahšie sú požiadavky zoskupené alebo filtrované podľa stránky a dopytu súčasne a že náročnosť rastie s dĺžkou obdobia, takže dopyt za šesť mesiacov je oveľa drahší než dopyt za jeden deň. Odporúča preto neťahať opakovane tie isté dáta a pri prekročení krátkodobej kvóty počkať 15 minút. Pre jeden web platí limit 1 200 požiadaviek za minútu (Google: Search Console API usage limits). V praxi z toho vyplýva, že skript je lepšie spúšťať po dňoch a výsledky si ukladať, než sa zakaždým pýtať na celý kvartál.
4. Konektor v Data Studiu: prehľady bez programovania
Data Studio je bezplatný nástroj Googlu na zostavovanie prehľadov a grafov a jeho konektor pre Search Console podľa dokumentácie slúži na meranie výkonu webu vo vyhľadávaní, pričom prehľad môžete doplniť o dáta z iných zdrojov, napríklad z Google Analytics (Google: Connect to Search Console). Ak hľadáte návod na Looker Studio, starý pomocník na adrese support.google.com/looker-studio dnes presmerúva práve na túto dokumentáciu Data Studia.
Pripojenie zaberie pár minút a postup podľa dokumentácie je takýto:
- Prihláste sa do Data Studia a vľavo hore zvoľte Create a potom Data Source.
- Vyberte konektor Search Console a ak treba, povoľte prístup k dátam tlačidlom Authorize.
- V paneli Sites zvoľte web. Ak ho nevidíte, dokumentácia radí overiť, či ste do Data Studia aj Search Console prihlásení rovnakým účtom Google a máte k vlastníctvu aspoň oprávnenie na zobrazenie.
- V paneli Tables vyberte Site Impression alebo URL Impression a v paneli Search Type predvolený typ vyhľadávania.
- Kliknite na Connect a z dátového zdroja vytvorte prehľad.
Voľba tabuľky rozhoduje o tom, ako sa čísla počítajú. Site Impression zodpovedá agregácii podľa vlastníctva, URL Impression agregácii podľa stránky, a jeden dátový zdroj podľa dokumentácie vie používať len jednu z nich, takže na porovnanie vedľa seba treba vytvoriť dva zdroje a pridať ich do jedného prehľadu. Len tabuľka URL Impression navyše podporuje typy Discover a Google News. Prázdny riadok v stĺpci dopytov znamená dopyty, ktoré Google kvôli ochrane súkromia nezobrazuje, a dokumentácia radí odstrániť ho filtrom, ktorý vylúči prázdne hodnoty.
Pri zdieľaní prehľadu s klientom rozhodujú prihlasovacie údaje dátového zdroja. Možnosť Owner's credentials dovolí ostatným vidieť dáta bez vlastného prístupu k Search Console, kým Viewer's credentials vyžaduje, aby mal každý čitateľ prístup sám. Komu a s akými oprávneniami do Search Console prístup dať, rieši článok o používateľoch a oprávneniach v Search Console.
5. Hromadný export do BigQuery krok za krokom
Hromadný export (bulk data export) posiela do BigQuery, databázovej služby Google Cloud, každý deň dáta výkonu a podľa blogu Google Search Central sa ho netýka denný limit riadkov, ktorý platí pre rozhranie a API (Google Search Central: Bulk data export). Projekt v Google Cloud musí mať zapnutú fakturáciu, hoci existuje bezplatná úroveň využitia. Podľa cenníka BigQuery je zadarmo prvých 10 GiB úložiska a prvý 1 TiB spracovaných dát z dopytov mesačne (Google Cloud: BigQuery pricing).
Postup podľa pomocníka Search Console má dve časti (Google: Start a new bulk data export):
- V Google Cloud Console prepnite na projekt, do ktorého chcete dáta posielať, a v časti APIs & Services zapnite BigQuery API aj BigQuery Storage API.
- V časti IAM and Admin pridajte účet služby
search-console-data-export@system.gserviceaccount.coma dajte mu roly BigQuery Job User a BigQuery Data Editor. - V Search Console otvorte Nastavenia a potom Hromadný export údajov a do poľa Cloud project ID vložte ID projektu, nie číslo projektu.
- Zvoľte názov množiny dát, predvolene
searchconsole. Ak posielate do jedného projektu viac vlastníctiev, každé potrebuje iný názov. - Vyberte umiestnenie dát. Pomocník upozorňuje, že po začatí exportov sa nedá ľahko zmeniť.
- Potvrďte tlačidlom Continue. Prvý export prebehne do 48 hodín od úspešného nastavenia.
Export ukladá dáta len odo dňa nastavenia a staršie obdobie doplníte cez API alebo z prehľadov. V BigQuery vzniknú tri tabuľky: searchdata_site_impression s dátami agregovanými podľa vlastníctva, searchdata_url_impression s dátami podľa adresy a ExportLog so záznamom úspešných exportov (Google: Table guidelines and reference). Tabuľky sa predvolene uchovávajú navždy, takže Google odporúča nastaviť expiráciu partícií, napríklad na mesiac, šesť alebo dvanásť mesiacov, a nie na celú tabuľku, lebo vtedy by sa zmazali všetky dáta. Expirácia má byť aspoň 14 dní a schému tabuliek, napríklad pridaním stĺpca, meniť nesmiete, inak export zlyhá.
O chybách exportu posiela Search Console e-mail všetkým vlastníkom a používateľom s úplným oprávnením a stav posledného pokusu ukazuje na stránke nastavení exportu. Po neopraviteľnej chybe skúša Search Console údaje doplniť ešte približne týždeň, potom dáta za daný deň zahodí (Google: Manage and monitor bulk data exports). V zozname chýb v pomocníkovi sú okrem iného chýbajúce fakturačné údaje, chýbajúce oprávnenia účtu služby a nezapnuté BigQuery API.
6. Ako exportované čísla správne čítať
Prvá pasca je rozdiel medzi súčtom riadkov a súčtom v grafe. Anonymizované dopyty, ktoré podľa blogu Google Search Central nezadá viac ako niekoľko desiatok používateľov za dva až tri mesiace, v tabuľkách nikdy nie sú, no v súčtoch grafu sú započítané, pokiaľ nefiltrujete podľa dopytu (Google Search Central: Performance data deep dive). V tabuľkách BigQuery ich označuje stĺpec is_anonymized_query a pole dopytu je pri nich prázdne.
Druhá pasca je agregácia. Pri agregácii podľa vlastníctva sa viac výsledkov z jedného webu pre ten istý dopyt počíta ako jedno zobrazenie a s najvyššou pozíciou, kým pri agregácii podľa stránky sa každá adresa počíta zvlášť. Preklikovosť a priemerná pozícia sú preto pri agregácii podľa vlastníctva spravidla vyššie (Google: Performance report, about the data). Čísla z tabuliek searchdata_site_impression a searchdata_url_impression teda nesčitujte ani priamo neporovnávajte, podrobnejšie to vysvetľuje článok o priemernej pozícii v Search Console.
Tretia vec sa týka výpočtu. Search Console ukladá dáta postupne, takže v tabuľkách sú riadky s opakovanými kľúčmi a metriky treba takmer vždy sčítať. Priemernú pozíciu z exportu nedostanete hotovú: pomocník uvádza vzorec SUM(sum_top_position)/SUM(impressions) + 1, lebo pozícia sa v tabuľke počíta od nuly. Dopyt na najčastejšie dopyty za posledných 28 dní môže vyzerať takto, pričom projekt nahradíte ID svojho projektu:
SELECT
query,
SUM(clicks) AS kliky,
SUM(impressions) AS zobrazenia,
SAFE_DIVIDE(SUM(clicks), SUM(impressions)) AS ctr,
SUM(sum_top_position) / SUM(impressions) + 1 AS priemerna_pozicia
FROM `projekt.searchconsole.searchdata_site_impression`
WHERE data_date >= DATE_SUB(CURRENT_DATE(), INTERVAL 28 DAY)
AND search_type = 'web'
AND NOT is_anonymized_query
GROUP BY query
ORDER BY kliky DESC
LIMIT 1000;
Podmienka na data_date neslúži len na vymedzenie obdobia, lebo pri cenníku podľa spracovaných dát BigQuery účtuje objem prečítaných bajtov a obmedzenie dátumu zmenší, koľko dát dopyt prečíta. Keď dáta zo Search Console spájate s Google Analytics, pamätajte, že každý nástroj meria niečo iné, o čom píše článok o meraní SEO v GA4.
Časté otázky
Koľko riadkov sa dá stiahnuť zo Search Console?
Tlačidlo exportu v prehľade stiahne najviac 1 000 riadkov. Search Console API a konektor v Data Studiu vydajú najviac 50 000 riadkov za deň pre jeden web a jeden typ vyhľadávania. Hromadný export do BigQuery obsahuje všetky dáta okrem anonymizovaných dopytov.
Prečo sa súčet klikov v exporte nezhoduje s grafom v Search Console?
Graf zahŕňa aj anonymizované dopyty a orezané riadky, ktoré v tabuľke ani v exporte nie sú. Rozdiel spôsobuje aj agregácia: dáta podľa stránky sa počítajú inak než dáta podľa celého vlastníctva.
Je hromadný export do BigQuery zadarmo?
Search Console za export nič neúčtuje, no dáta podliehajú cenám úložiska a dopytov v Google Cloud. Projekt musí mať zapnutú fakturáciu a podľa cenníka BigQuery je mesačne zadarmo prvých 10 GiB úložiska a prvý 1 TiB spracovaných dát z dopytov.
Dostanem cez BigQuery aj dáta spred nastavenia exportu?
Nie. Prvý export prebehne do 48 hodín od nastavenia a obsahuje dáta od toho dňa. Staršie obdobie podľa pomocníka Search Console doplníte cez API alebo exportom z prehľadov.
Ako vypočítať priemernú pozíciu z dát v BigQuery?
Pre tabuľku podľa vlastníctva použite vzorec SUM(sum_top_position)/SUM(impressions) + 1 a pre tabuľku podľa adries SUM(sum_position)/SUM(impressions) + 1. Jednotka sa pripočítava preto, lebo pozícia je v tabuľkách číslovaná od nuly.
Čo je Site Impression a URL Impression v Data Studiu?
Ide o dve tabuľky konektora Search Console. Site Impression počíta dáta podľa celého vlastníctva, URL Impression podľa jednotlivých stránok. Jeden dátový zdroj vie použiť len jednu z nich a typy Discover a Google News podporuje iba URL Impression.