NovéStaviam na Claude od AnthropicAI automatizácia procesovAI v marketingu
Najnovší článokMagazín: články o marketingu, PPC, SEO a AI

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ôsobKoľko dát dostanetePre koho sa hodí
Tlačidlo Exportovať v prehľadeNajviac 1 000 riadkov, formát Google Sheets, Excel alebo CSVMalé weby a rýchla jednorazová kontrola
Search Console APINajviac 50 000 riadkov za deň, typ vyhľadávania a vlastníctvoStredne veľké weby, ktoré si vedia napísať skript
Konektor v Data StudiuRovnaký limit 50 000 riadkov ako APIPravidelné prehľady pre klienta alebo vedenie bez programovania
Hromadný export do BigQueryVšetky dáta okrem anonymizovaných dopytov, denne a bez limitu riadkovVeľ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:

  1. Prihláste sa do Data Studia a vľavo hore zvoľte Create a potom Data Source.
  2. Vyberte konektor Search Console a ak treba, povoľte prístup k dátam tlačidlom Authorize.
  3. 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.
  4. V paneli Tables vyberte Site Impression alebo URL Impression a v paneli Search Type predvolený typ vyhľadávania.
  5. 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):

  1. 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.
  2. V časti IAM and Admin pridajte účet služby search-console-data-export@system.gserviceaccount.com a dajte mu roly BigQuery Job User a BigQuery Data Editor.
  3. V Search Console otvorte Nastavenia a potom Hromadný export údajov a do poľa Cloud project ID vložte ID projektu, nie číslo projektu.
  4. 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.
  5. Vyberte umiestnenie dát. Pomocník upozorňuje, že po začatí exportov sa nedá ľahko zmeniť.
  6. 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.

HľadaťDohodnúť stretnutie