Google Search Console API pro váš vlastní stack
Výkonnostní data ze Search Console přes čistý REST endpoint.
Stahujte kliknutí, zobrazení, CTR a průměrnou pozici — podle dotazu, stránky a časového rozsahu — přímo z Google Search Console do svého produktu, dashboardu nebo datového skladu. Připojte GSC jednou uvnitř SEOcrawl AI, vygenerujte klíč Bearer ve svém dashboardu a volejte REST /v1 — žádné Google OAuth, které byste museli psát sami. Je to stejná kanonická datová vrstva, která pohání MCP SEOcrawl AI, takže vám čísla vždycky sedí. Pokrytí indexace a kontrola URL míří na REST vzápětí; přes MCP jsou živé už teď.
Najděte property. Stahujte data z GSC.
Vygenerujte token Bearer z dashboardu a předejte jej v hlavičce Authorization. Jednou si zjistěte id property ze Search Console a pak její výkon dotazujte přes REST. Stejný klíč funguje jak v REST API, tak na serveru MCP.
Základní URL
https://api.seocrawl.ai/v1Hlavička Authorization
Authorization: Bearer sca_live_your_token_hereKaždá metrika ze Search Console, přes REST
Kliknutí, zobrazení, CTR a průměrná pozice — podle dotazu, stránky, časového rozsahu a období proti období. Každý endpoint je vázaný na property: nejdřív si zjistěte její id a pak čtěte její data ze Search Console. Tyto skupiny GSC jsou v provozu ve v1; pokrytí indexace a kontrolu URL dnes nabízí MCP a na REST míří vzápětí.
Property
Vypíše property ze Search Console připojené k vašemu účtu. id každé property použijete v cestě všech endpointů GSC.
- GET
/v1/propertiesŽivě
Výkon
Celková kliknutí, zobrazení, CTR a průměrná pozice za časový rozsah — plus změna proti předchozímu období ve stejném okně.
- GET
/v1/properties/{id}/gsc/summaryŽivě - GET
/v1/properties/{id}/gsc/compareŽivě
Dotazy
Vyhledávací dotazy, na které se zobrazujete, s metrikami pro každý z nich — a kompletní denní historie libovolného klíčového slova.
- GET
/v1/properties/{id}/gsc/top-keywordsŽivě - GET
/v1/properties/{id}/gsc/keywords/detailŽivě
Stránky
Vaše nejvýkonnější URL s metrikami ze Search Console — a kompletní denní rozpad výkonu libovolné stránky.
- GET
/v1/properties/{id}/gsc/top-pagesŽivě - GET
/v1/properties/{id}/gsc/pages/detailŽivě
Pokrytí indexace
Co Google skutečně indexuje: stavy pokrytí a historie indexace. Dnes živé v MCP; REST endpointy se postupně zavádějí.
- GET
/v1/properties/{id}/indexation/summaryBrzy
Kontrola URL
Kontrola jednotlivých URL — pokrytí, poslední procházení a stav indexace konkrétní stránky. Přes MCP dostupné už teď; REST následuje.
- GET
/v1/properties/{id}/url-inspectionBrzy
Skutečná data ze Search Console, stavěná pro produkty
Váš reálný výkon v Google Search Console — ne odhady třetích stran — přes čisté REST API s autentizací Bearer a limity požadavků, sdílející jednu kanonickou datovou vrstvu s MCP, takže si čísla nikdy neodporují.
Přímo ze Search Console
Kliknutí, zobrazení, CTR a průměrná pozice stažené z vaší vlastní property v GSC — reálná čísla, která hlásí Google, ne modelované ani scrapované odhady. Předvídatelné zdroje, standardní metody, typovaný JSON a chyby odpovídající RFC.
Žádné Google OAuth k naprogramování
Připojte Search Console jednou uvnitř SEOcrawl AI a pak ho čtěte jediným klíčem Bearer sca_live_. Odpadá projekt v Google Cloud, souhlasová obrazovka i obnova tokenů — klíče vytvoříte a zrušíte v dashboardu během pár vteřin.
Jedna kanonická datová vrstva
REST endpointy pro GSC a nástroje GSC v MCP jsou sourozenci nad stejným zdrojem, se shodou ověřovanou v CI. Váš dashboard i vaši AI agenti vidí vždy identická kliknutí, zobrazení a pozice.
Granularita po dotazu i po stránce
Přečtěte si souhrny za celou property, nebo se zanořte do detailu: nejlepší dotazy, nejlepší stránky, denní vývoj jednoho klíčového slova nebo historie jedné URL — stejné dimenze, jaké vidíte v Search Console, dostupné přes HTTP.
Srovnání období rovnou v API
Požádejte o rozsah (last_7_days, last_28_days, last_3_months, last_year) nebo o explicitní data from/to a srovnání období dostanete rovnou — bez druhého volání a bez počítání dat na klientovi, abyste dopočítali změny.
Zdokumentované limity požadavků
60 požadavků za minutu a 1 000 za hodinu na token, s jasnými odpověďmi 429 + Retry-After. Limity REST jsou oddělený pool od využití MCP — jedno nikdy nevyhladoví druhé.
Začněte ve 3 krocích
Od nuly k prvnímu volání na Search Console během pár minut.
Vygenerujte klíč
Připojte Search Console v SEOcrawl AI, otevřete API tokeny a vygenerujte token Bearer. Zkopírujte jej jednou — začíná na sca_live_.
Najděte property
Zavolejte GET /v1/properties s Authorization: Bearer sca_live_… a získáte id (UUID) property ze Search Console, kterou chcete číst.
Stahujte data z GSC
Zavolejte /v1/properties/{id}/gsc/summary?range=last_28_days pro souhrny, nebo /gsc/top-keywords, /gsc/top-pages a endpointy /detail — a pošlete JSON rovnou do svého produktu, dashboardu nebo skladu.
Tři způsoby, jak se dostat k datům ze Search Console
Stejná čísla z GSC, jiné rozhraní — vyberte to, které sedí k tomu, jak stavíte.
REST API
Pro produkty, dashboardy a datové pipeline. Autentizace Bearer, typovaný JSON, limity požadavků. Jste na této stránce — kompletní SEO API přidává na stejný klíč endpointy pro pozice a AI viditelnost.
Server MCP
Pro AI agenty — Claude, ChatGPT a jakýkoli MCP klient se ptají vašich dat ze Search Console v přirozeném jazyce.
Prozkoumejte MCPTerminál a CLI
Pro skripty a CI/CD — řiďte svá data z GSC z jakéhokoli terminálového agenta s podporou MCP.
Podívejte se na CLIKdo staví na Search Console API
Týmy, které chtějí mít skutečná výkonnostní data z GSC ve vlastních systémech.
Agentury
Přeneste data ze Search Console od každého klienta do vlastního portálu, Looker Studia nebo své reportovací vrstvy — jeden klíč, všechny property, žádné ruční exporty z GSC.
SaaS a partneři
Vložte živé metriky ze Search Console přímo do UI svého produktu. Dejte uživatelům kliknutí, zobrazení a pozice, aniž byste sami zapojovali API od Google.
Datové týmy
Ukládejte kliknutí, zobrazení, CTR a pozice z GSC do svého skladu podle plánu. Spojte je s tržbami a postavte modely, které vaše dashboardy potřebují.
Vývojáři
Automatizujte sledování dotazů a stránek, upozorňujte na propady pozic a zapojte data ze Search Console do aplikací a workflow, které už vydáváte.
Často kladené otázky
Je tohle oficiální Search Console API od Google?
Ne. Je to vlastní REST API SEOcrawl AI s autentizací Bearer nad daty ze Search Console, která už máte připojená ke svému účtu. GSC připojíte jednou uvnitř SEOcrawl AI a pak čtete kliknutí, zobrazení, CTR a pozice jediným klíčem sca_live_ — bez zakládání projektu v Google Cloud, souhlasové obrazovky OAuth nebo vlastní obnovy tokenů. Čísla jsou vaše skutečná čísla ze Search Console; API a autentizace jsou naše.
Jaká data ze Search Console můžu stahovat dnes?
Souhrny za časový rozsah (kliknutí, zobrazení, CTR, průměrná pozice), srovnání období proti období, vaše nejlepší dotazy a stránky s metrikami a kompletní denní detail jednoho klíčového slova nebo jedné stránky — plus seznam vašich připojených property. Pokrytí indexace a živá kontrola URL jsou dostupné už teď přes MCP; jejich REST endpointy se zavádějí vzápětí. A pokud si účet radši necháte přečíst, než abyste ho dotazovali, audit Google Search Console pokryje stejná data jedním promptem.
Jak se autentizuji?
Tokenem Bearer. Vygenerujte klíč sca_live_ ze svého dashboardu a posílejte jej jako Authorization: Bearer <klíč> v každém požadavku. Pro vlastní účet žádný OAuth tanec neprobíhá — stačí hlavička.
Jaké časové rozsahy jsou podporované?
Každý endpoint GSC přijímá buď range (last_7_days, last_28_days, last_3_months nebo last_year), nebo explicitní dvojici from/to. Endpoint gsc/compare vrátí stejné okno porovnané s předchozím obdobím, takže změny máte bez druhého volání.
Jaké jsou limity požadavků?
60 požadavků za minutu a 1 000 za hodinu na token. Když je překročíte, dostanete 429 s hlavičkou Retry-After. Limity REST se sledují odděleně od využití MCP, takže spolu nikdy nesoupeří o stejný rozpočet.
Je to stejný klíč a stejná data jako u MCP?
Ano. Stejný token sca_live_ autentizuje jak REST API, tak server MCP, a oba čtou z jedné kanonické datové vrstvy — takže čísla ze Search Console, která stáhnete přes REST, jsou identická s tím, co vidí vaši AI agenti přes MCP. Jedny přihlašovací údaje, dvě rozhraní.
Připraveni stavět na svých datech ze Search Console?
Připojte GSC jednou, vygenerujte klíč Bearer z dashboardu a proveďte první REST volání na Search Console během pár minut — nebo prozkoumejte MCP pro AI agenty.
