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íčPřečíst dokumentaci APIProzkoumejte MCP
Claude
Codex CLI
Cursor
SEOcrawl AI REST API — curl request and typed JSON response
SEOcrawl AI REST API examples in cURL, JavaScript and Python

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

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í. Všechny podrobnosti na samostatné stránce API Google Search Console.

  • 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

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.

1

Vygenerujte klíč

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

2

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.

3

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íčPřečíst dokumentaci APIObjednat demo