Jak používat Google Search Console API?

Q: Jak používat Google Search Console API?

Vytvořte projekt v Cloudu, povolte API, autorizujte se přes OAuth a poté načítejte data o výkonu, kontrolu URL a sitemapy. Zde jsou postup a kvóty.

Vytvořte projekt v konzoli Google Cloud, povolte Google Search Console API, vytvořte přihlašovací údaje OAuth 2.0 a přihlaste se účtem Google, který má k dané vlastnosti přístup. Poté můžete odesílat požadavky na čtyři zdroje: Search Analytics pro kliknutí, zobrazení, CTR a pozici; URL Inspection pro stav indexace; Sitemaps a Sites. Samotné klíče API nestačí: každé volání vyžaduje token OAuth a kvóty omezují, kolik dat si můžete vyžádat.

Co API pokrývá a co ne

Zdroj	Metody	K čemu slouží
Search Analytics	`query`	Řádky s výkonem podle dotazu, stránky, země, zařízení, vzhledu ve vyhledávání, data nebo hodiny
URL Inspection	`index.inspect`	Indexovaná verze jedné URL: pokrytí, poslední procházení, kanonické adresy
Sitemaps	`list`, `get`, `submit`, `delete`	Správa sitemap odeslaných pro danou vlastnost
Sites	`list`, `get`, `add`, `delete`	Vlastnosti v přihlášeném účtu

To je celé API. Odkazy, Statistiky procházení, report Indexování stránek a report Core Web Vitals nemají žádný endpoint, takže zůstávají pouze v rozhraní Search Console. URL Inspection ukazuje, co je v indexu Google, nikoli živý test stránky.

Nastavení přístupu

V konzoli Google Cloud vytvořte nebo vyberte projekt.
Pro tento projekt povolte Google Search Console API.
Nakonfigurujte obrazovku souhlasu OAuth a vytvořte ID klienta OAuth.
Vyžádejte si scope: https://www.googleapis.com/auth/webmasters.readonly pro čtení, nebo https://www.googleapis.com/auth/webmasters, pokud chcete také odesílat či mazat sitemapy.
Přihlaste se účtem, který má k dané vlastnosti oprávnění. Ke čtení dat o výkonu je potřeba alespoň přístup pro čtení; API vidí přesně to, co vidí tento účet.

První dotaz na Search Analytics

POST https://www.googleapis.com/webmasters/v3/sites/sc-domain%3Aexample.com/searchAnalytics/query
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{
  "startDate": "2026-09-01",
  "endDate": "2026-09-30",
  "dimensions": ["query", "page"],
  "type": "web",
  "rowLimit": 25000,
  "startRow": 0
}

Web se uvádí v cestě, zakódovaný jako URL: sc-domain:example.com pro vlastnost typu doména, nebo přesný prefix včetně koncového lomítka, například https://www.example.com/, pro vlastnost typu prefix URL. Nejdůležitější pole:

Data jsou včetně obou krajních dnů a v pacifickém čase.
type je ve výchozím stavu web; dalšími hodnotami jsou image, video, news, googleNews a discover. Každý typ vyžaduje samostatný požadavek.
Filtry se zadávají v dimensionFilterGroups s operátory od equals a contains po includingRegex a excludingRegex (syntaxe RE2).
rowLimit se pohybuje od 1 do 25 000 (výchozí hodnota je 1 000); zbytek dat načtete pomocí startRow.
dataState je ve výchozím stavu final; all přidává čerstvé, nedokončené dny a hourly_all funguje s dimenzí hour.

Každý řádek vrací keys, clicks, impressions, ctr (0 až 1) a position, seřazené podle kliknutí, pokud neseskupujete podle data.

Limity, které ovlivňují váš kód

50 000 řádků denně na typ vyhledávání. Procházejte data pomocí startRow v krocích po 25 000 a skončete u prázdné odpovědi. Chcete-li získat co nejvíce dat, dotazujte se po jednotlivých dnech.
Kvóta zátěže. Nejnáročnější je seskupení nebo filtrování podle stránky i dotazu zároveň a dlouhá období stojí víc než krátká. Pokud překročíte krátkodobou kvótu, Google vás vyzve, abyste počkali 15 minut.
Četnost požadavků. 1 200 dotazů za minutu na web a uživatele; 40 000 za minutu a 30 000 000 za den na projekt.
Kvóta URL Inspection. 2 000 kontrol denně a 600 za minutu pro každou vlastnost.
16 měsíců historie a data bývají k dispozici dva až tři dny po skončení dne.
Řádky se nesčítají na celkové hodnoty. Vzácné dotazy jsou z řádků na úrovni dotazů vynechány a seskupení podle stránky počítá zobrazení jinak než seskupení podle vlastnosti, proto celkové hodnoty čtěte z požadavku bez dimenze dotazu.

Časté chyby

Použití http://, když je vlastnost na https://, nebo vynechání koncového lomítka vede k chybě oprávnění, i když účet přístup má.
Požadavek na URL mimo vlastnost je v URL Inspection zamítnut: URL musí ležet pod siteUrl, který předáte.
Měsíc seskupený podle dotazu a stránky v jednom volání vrátí jen nejvýznamnější řádky. Denní požadavky vrátí víc.

Jak pomáhá AutoPSEO

Pokud nechcete udržovat OAuth a stránkování, AutoPSEO se připojuje přes přihlášení Google a stejná data zpřístupňuje prostřednictvím vlastního REST API na /v1 (s dokumentem OpenAPI 3.1) a serveru MCP, autorizovaného klíčem API z Account → API keys. K dispozici jsou klíče jen pro čtení, endpoint search analytics vrací až 5 000 řádků na volání a nástroje aplikace pro URL Inspection hlídají za vás denní kvótu Google 2 000 kontrol. Viz MCP a klíče API. Pokud chcete uchovat data déle než 16 měsíců, aniž byste psali vlastní pipeline, přečtěte si, jak dlouho Search Console uchovává data.

Zdroje: Google API reference, metoda Search Analytics query, limity použití, získání všech vašich dat a průvodce autorizací.