Tokenem Bearer. Vygenerujte klíč `sca_live_` ze svého dashboardu a posílejte jej jako `Authorization: Bearer ` v každém požadavku. Pro vlastní účet žádný OAuth tanec neprobíhá — stačí hlavička.

REST API · v1 · Živá dokumentace

SEO API pro váš vlastní stack

Vaše SEO data a data o AI viditelnosti přes čistý REST endpoint.

Stahujte data z Google Search Console, o pozicích a z AI Tracker přímo do svého produktu, dashboardu nebo datového skladu. Autentizujte se klíčem Bearer z dashboardu, zavolejte REST `/v1` a získejte typovaný JSON — stejnou kanonickou datovou vrstvu, která pohání MCP SEOcrawl AI. GA4, plný export auditu webu a víceklientské partnerské OAuth se zavádějí jako další.

Získejte API klíč Prozkoumejte MCP

Autentizace Bearer · 60 req/min · Stejná datová vrstva jako MCP · Bez scrapingu

seocrawl — REST /v1

$ curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \

-H "Authorization: Bearer sca_live_…"

{ "data": {

"period": { "from": "2026-06-09", "to": "2026-07-06" },

"metrics": {

"clicks": 2388, "impressions": 811019,

"ctr": 0.00294, "position": 22.87

"metrics_diff": { "clicks": 584, … }

} }

Autentizujte se jednou. Volejte REST.

Vygenerujte token Bearer z dashboardu a předejte jej v hlavičce Authorization. Stejný klíč funguje jak v REST API, tak na serveru MCP.

Základní URL

https://api.seocrawl.ai/v1

Hlavička Authorization

Authorization: Bearer sca_live_your_token_here

Získejte API klíč Read the API docs

cURLJavaScriptPython

# cURL — resolve a property id, then query it
curl https://api.seocrawl.ai/v1/properties \
  -H "Authorization: Bearer sca_live_…"

curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \
  -H "Authorization: Bearer sca_live_…"

// JavaScript
const res = await fetch(
  "https://api.seocrawl.ai/v1/properties/" + id + "/gsc/summary?range=last_28_days",
  { headers: { Authorization: "Bearer sca_live_…" } }
);
const data = await res.json();

# Python
import requests
r = requests.get(
  f"https://api.seocrawl.ai/v1/properties/{id}/gsc/summary",
  params={"range": "last_28_days"},
  headers={"Authorization": "Bearer sca_live_…"},
)
print(r.json())

Endpointy

Jedna datová vrstva, dvě rozhraní

Každý REST endpoint čte ze stejné kanonické vrstvy jako nástroje MCP — takže váš dashboard a vaši AI agenti vždy vidí identická čísla. Tyto skupiny jsou v provozu ve v1; další pokrytí přibývá průběžně.

Properties

Vypište property Search Console, ke kterým máte přístup. Použijte `id` každé property v cestě každého datového endpointu.

GET/v1/propertiesŽivě

Google Search Console

Prokliky, imprese, CTR a průměrná pozice — podle dotazu, stránky, časového rozsahu a období proti období.

GET/v1/properties/{id}/gsc/summaryŽivě
GET/v1/properties/{id}/gsc/compareŽivě
GET/v1/properties/{id}/gsc/top-keywordsŽivě
GET/v1/properties/{id}/gsc/top-pagesŽivě
GET/v1/properties/{id}/gsc/keywords/detailŽivě
GET/v1/properties/{id}/gsc/pages/detailŽivě

AI Tracker

Čtěte prompty, které sledujete kvůli zmínkám o značce napříč ChatGPT, Claude, Gemini a Perplexity.

GET/v1/properties/{id}/ai-tracker/promptsŽivě

Úkoly

Čtěte a zapisujte SEO úkoly — propojte svou nástěnku úkolů s vlastním stackem pro řízení projektů.

GET/v1/properties/{id}/tasksŽivě
POST/v1/properties/{id}/tasksŽivě
GET/v1/properties/{id}/tasks/{ticketId}Živě
PATCH/v1/properties/{id}/tasks/{ticketId}Živě
POST/v1/properties/{id}/tasks/{ticketId}/commentsŽivě

GA4 a indexace

Návštěvnost, AI referrery a stav indexace. Napojení je připravené; REST endpointy se zavádějí.

GET/v1/properties/{id}/ga4/summaryBrzy
GET/v1/properties/{id}/indexation/summaryBrzy

Site Audit

Stav crawlu, on-page, technika a seznamy problémů — kompletní datová sada auditu, vystavená přes REST.

GET/v1/properties/{id}/audit/summaryBrzy
GET/v1/properties/{id}/audit/issuesBrzy

Proč toto API

Postaveno pro produkty, ne pro scrapery

Skutečné REST API s autentizací Bearer, scopy a limity požadavků — sdílející jednu kanonickou datovou vrstvu s MCP, takže čísla se nikdy nerozcházejí.

Čisté REST, typovaný JSON

Předvídatelné zdroje, standardní slovesa, typované JSON odpovědi a chyby v souladu s RFC (401 neautentizováno, 403 scope_required, 429 s Retry-After). Žádný scraping HTML, žádné křehké exporty.

Jedna kanonická datová vrstva

REST endpointy a nástroje MCP jsou sourozenci nad stejnými poskytovateli, s paritou testovanou v CI. Váš dashboard a vaši AI agenti vždy vidí identické prokliky, imprese a pozice.

Samoobslužné klíče

Vygenerujte a zrušte tokeny Bearer z dashboardu během několika sekund. Stejný klíč sca_live_ autentizuje jak REST API, tak server MCP — jedny přihlašovací údaje, dvě rozhraní.

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 samostatná zásoba oddělená od využití MCP — jedno nikdy nevyhladoví druhé.

Přístup se scopy

Hrubé scopy pro čtení a zápis hlídají každý endpoint, vynucené na firewallu se standardními step-up odpověďmi. Udělte klíči jen to, co potřebuje.

Víceklientské, připravuje se

Google OAuth tok pro každého klienta, aby partneři mohli připojit každou z GSC property svých zákazníků pod jedním účtem — s přísnou izolací dat. V aktivním vývoji; požádejte nás o předběžný přístup.

Začněte ve 3 krocích

Od nuly k prvnímu autentizovanému volání během pár minut.

Vygenerujte klíč

Otevřete API tokeny ve svém dashboardu a vygenerujte token Bearer. Zkopírujte jej jednou — začíná na `sca_live_`.

Pošlete hlavičku

Předávejte `Authorization: Bearer sca_live_…` v každém požadavku na `https://api.seocrawl.ai/v1`. Stejný klíč funguje i se serverem MCP.

Stahujte data

Zavolejte `GET /v1/properties`, abyste získali `id` property, poté volejte `/v1/properties/{id}/…` pro výkon GSC, prompty AI Tracker nebo úkoly — a přeneste JSON rovnou do svého produktu, dashboardu nebo skladu.

Tři způsoby, jak se dostat k vašim datům

Stejná čísla, 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.

Server MCP

Pro AI agenty — Claude, ChatGPT a jakýkoli MCP klient dotazují vaše data v přirozeném jazyce.

Prozkoumejte MCP

Terminál a CLI

Pro skripty a CI/CD — řiďte svá data z jakéhokoli terminálového agenta s podporou MCP.

Podívejte se na CLI

Porovnat všechny integrace

Kdo staví na API

Týmy, které chtějí mít SEO data a data o AI viditelnosti uvnitř vlastních systémů.

SaaS a partneři

Vložte živé SEO metriky do UI svého vlastního produktu. Poskytněte svým uživatelům data ze Search Console a o AI viditelnosti, aniž byste sami stavěli pipeline.

Agentury

Přeneste data každého klienta do vlastního portálu, Looker Studia nebo své reportovací vrstvy — jeden klíč, každá property, žádné ruční exporty.

Datové týmy

Ukládejte data z GSC, o pozicích a z AI Tracker 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 kontroly a upozornění, synchronizujte úkoly se svým PM nástrojem a zapojte monitoring AI viditelnosti do aplikací, které už vydáváte.

Často kladené otázky

Opravdu existuje veřejné SEO API?

Ano — REST `/v1` API s autentizací Bearer je v provozu, pokrývá výkon Search Console, property, prompty AI Tracker a úkoly, s plnou veřejnou dokumentací publikovanou na api.seocrawl.ai/docs. Širší pokrytí (GA4, plný export auditu webu) a víceklientské partnerské OAuth se zavádějí jako další. Potřebujete něco, co ještě není v provozu? Požádejte nás o předběžný přístup.

Jak se autentizuji?

Tokenem Bearer. Vygenerujte klíč `sca_live_` ze svého dashboardu a posílejte jej jako `Authorization: Bearer <key>` v každém požadavku. Pro vlastní účet žádný OAuth tanec neprobíhá — stačí hlavička.

Je to stejný klíč jako u MCP?

Ano. Stejný token autentizuje jak REST API, tak server MCP, protože oba čtou z jedné kanonické datové vrstvy. Jedny přihlašovací údaje, dvě rozhraní — a identická čísla napříč nimi.

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 jsou sledovány odděleně od využití MCP, takže spolu nikdy nesoupeří o stejný rozpočet.

Mohu připojit Search Console property svých zákazníků?

Tento víceklientský partnerský tok — Google OAuth pro každého klienta, abyste mohli připojit každou z GSC property svých zákazníků pod vlastním účtem, s přísnou izolací dat — je v aktivním vývoji. Pokud stavíte partnerskou integraci, ozvěte se nám kvůli předběžnému přístupu.

Jaká data mohu stahovat dnes?

Souhrn Search Console a srovnání období, nejlepší klíčová slova a stránky, detail jednoho klíčového slova/stránky, seznam vašich property, prompty AI Tracker a plné čtení/zápis úkolů. Zrcadlí to, co vystavuje MCP, přes REST.

Připraveni stavět na svých SEO datech?

Vygenerujte klíč Bearer z dashboardu a proveďte své první REST volání během pár minut — nebo se s námi domluvte na partnerském a víceklientském přístupu.

Získejte API klíč Objednat demo