Jak zkontrolovat pozici klíčového slova pomocí Google API (průvodce 2026)

Rychlý kvíz

Jak sledovat svoje pozice na Googlu?

Otázka 1 z 425%

Proč chcete sledovat pozice?

Abych věděl, kde stojímAbych je zlepšilAbych ukázal výsledky klientům nebo nadřízenému

Pokus o kontrolu pozice klíčového slova pomocí Google API patří mezi úkoly, které vypadají jako vyřešený problém, dokud je nezkusíte. Neexistuje žádný koncový bod rankings.get() a dvě rozhraní Google, po kterých lidé sahají jako první, odpovídají na jinou otázku, než jakou si pokládáte. Správné místo k začátku je dokumentace Search Analytics v Search Console, pokud rozumíte tomu, co tam znamená „pozice“.

Má Google oficiální rozhraní API pro pozice klíčových slov?

Ne. Google nikdy nevydal rozhraní, které by přijalo klíčové slovo a vrátilo vaši živou pozici na google.com. Je to záměrné: automatické dotazování stránky výsledků vyhledávání zakazují podmínky Googlu a firma nemá obchodní zájem dodávat infrastrukturu pro sledování pozic.

Místo toho existují tři částečné cesty, každá s pevnou hranicí:

Jak získám pozice klíčových slov z Search Console API?

Dotažte se koncového bodu searchAnalytics s dimenzí query a přečtěte pole position. Jde o údaje z první ruky přímo od Googlu, jsou zdarma a nemají limit počtu klíčových slov: dostanete každý dotaz, u kterého váš web dostal zobrazení.

Funkční požadavek v Pythonu:

from google.oauth2 import service_account
from googleapiclient.discovery import build

creds = service_account.Credentials.from_service_account_file(
    "service-account.json",
    scopes=["https://www.googleapis.com/auth/webmasters.readonly"],
)
service = build("searchconsole", "v1", credentials=creds)

response = service.searchanalytics().query(
    siteUrl="https://example.com/",
    body={
        "startDate": "2026-07-01",
        "endDate": "2026-07-31",
        "dimensions": ["query", "page"],
        "rowLimit": 25000,
    },
).execute()

for row in response.get("rows", []):
    query, page = row["keys"]
    print(f"{row['position']:.1f}  {query}  ->  {page}")

Tři omezení, na která lidé narazí

• Pozice je průměr, ne konkrétní pořadí. Hodnota 7,4 neznamená, že jste na 7. místě; znamená, že zobrazení se rozložila na pozice s průměrem 7,4, a možná se pohybovala od 3. do 15. místa podle zařízení a lokality.
• Jen váš web. Pozici konkurenta nelze zobrazit. Search Console je podle návrhu rozhraní omezené na vlastnictví webu.
• Klíčová slova bez zobrazení jsou neviditelná. Pokud se umísťujete na 60. místě a nikdo se tak daleko nepodíval, dotaz se v datech vůbec neobjeví.

Právě třetí bod tiše kazí reporting. Klíčové slovo, které jste ještě nedostali na první stránky, v Search Console jednoduše neexistuje, takže pomocí tohoto rozhraní samotného nelze změřit postup z 60. místa na 20. místo.

Můžu k sledování pozic použít Custom Search JSON API?

Technicky ano, smysluplně ne. Custom Search JSON API vyžaduje nejdřív vytvořit Programmable Search Engine. I když je nastaven tak, aby prohledával celý web, uplatňuje vlastní řazení a vlastní omezení, takže pořadí, které vrací, není pořadí z google.com.

Bezplatná úroveň je navíc omezena na 100 dotazů denně, placené použití se účtuje za tisíc dotazů a s denním stropem. Pro několik klíčových slov kontrolovaných občas je to použitelné. Jako nástroj na sledování pozic ale produkuje čísla, která vypadají autoritativně a jsou potichu špatně, a to je horší než žádná data.

A co stahování výsledků přímo z Google (scraping)?

Nedělejte to. Automatické dotazování Google Search bez povolení je v rozporu s Podmínkami služby Google a při jakémkoli objemu vyvolá blokování IP adres a ověřovací zábrany CAPTCHA. Kromě právní otázky je technická realita nepříjemná: výsledky jsou personalizované, lokalizované a stále častěji sestavované s funkcemi AI, takže „pozice“ získaná stažením se mění podle datového centra, lokality a relace, i když se na vašem webu nic nezměnilo.

Pokud potřebujete pozice konkurence, komerční SERP API je cesta, která je zároveň legální podle smluvních podmínek poskytovatele a provozně stabilní. Je to placená položka a tato cena je poctivou cenou za data, která Google nerozdává zdarma. Firmy, které potřebují tento postup sběru dat vybudovat a sledovat bez vlastních lidí, obvykle přizvou specialistu; náš přehled 10 nejlepších agentur pro analýzu dat ve Francii uvádí poskytovatele, kteří takový reporting zavádějí.

Co byste vlastně měli postavit?

Pro většinu týmů je praktická architektura hybridní a vypadá takto:

• Search Console API jako páteř. Zdarma, bez limitu klíčových slov, z první ruky a jediný zdroj, který ukazuje, na co máte skutečně zobrazení.
• SERP API pro malou, vybranou sadu klíčových slov. Vaše dvacet nebo třicet komerčně důležitých výrazů, kontrolovaných denně, včetně pozic konkurence.
• Vrstva viditelnosti v AI. Stále častěji nejde jen o otázku „na jaké pozici jsem“, ale také „jsem citován, když se někdo zeptá asistenta“. Klasická rozhraní pro pozice na to neodpovídají vůbec.

Týmy, které si tuto architekturu nechtějí navrhovat samy, ji obvykle předají specialistovi; náš přehled 10 nejlepších SEO agentur ve Francii představuje poskytovatele, kteří pro klienty spravují tuto sadu nástrojů pro reporting.

Ten poslední bod není vzdálená budoucnost. Když odpověď AI vyřeší dotaz přímo v rozhraní, pozice deset a pozice tři vedou ke stejnému výsledku, tedy k žádnému kliknutí. Sledování citací vedle pozic je to, k čemu slouží náš server MCP pro Search Console a platforma pro viditelnost v AI, a dokumentace popisuje nastavení od začátku do konce.

Závěr

Neexistuje oficiální rozhraní Googlu pro živé pozice klíčových slov: pro vlastní průměrná data použijte Search Console API, pro přesné a konkurenční pozice SERP API od třetí strany a rozhraní Custom Search JSON API pro práci s pořadím úplně vynechte. Stavět na špatném z nich je nejčastější chyba a vede k přehledu, který s jistotou ukazuje nepřesné údaje.

Pokud si tento postup nechcete stavět a udržovat sami, Sorank propojí váš Search Console a sleduje citace v AI na jednom místě.