REST API · v1 · Gyva dokumentacija

SEO API jūsų pačių sistemai

Jūsų SEO ir AI matomumo duomenys per švarų REST galinį tašką.

Traukite Google Search Console, pozicijų ir AI Tracker duomenis tiesiai į savo produktą, skydelį ar duomenų saugyklą. Autentifikuokitės Bearer raktu iš savo skydelio, kvieskite REST `/v1` ir gaukite tipizuotą JSON — tą patį kanoninį duomenų sluoksnį, kuris maitina SEOcrawl AI MCP. GA4, visas svetainės audito eksportas ir kelių nuomininkų partnerių OAuth pasirodys netrukus.

Gaukite API raktą Skaitykite API dokumentaciją Tyrinėkite MCP

Bearer autentifikacija · 60 užklausų/min · Tas pats duomenų sluoksnis kaip MCP · Jokio nuskaitymo

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, … }

} }

Autentifikuokitės vieną kartą. Kvieskite REST.

Sukurkite Bearer tokeną iš savo skydelio ir perduokite jį Authorization antraštėje. Tas pats raktas veikia tiek REST API, tiek MCP serveryje.

Bazinis URL

https://api.seocrawl.ai/v1

Authorization antraštė

Authorization: Bearer sca_live_your_token_here

Gaukite API raktą 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())

Galiniai taškai

Vienas duomenų sluoksnis, du paviršiai

Kiekvienas REST galinis taškas skaito iš to paties kanoninio sluoksnio kaip MCP įrankiai — todėl jūsų skydelis ir AI agentai visada mato identiškus skaičius. Šios grupės veikia v1; aprėptis nuolat plečiama.

Properties

Išvardykite Search Console properties, prie kurių galite prieiti. Naudokite kiekvienos property `id` kiekvieno duomenų galinio taško kelyje.

GET/v1/propertiesAktyvu

Google Search Console

Paspaudimai, parodymai, CTR ir vidutinė pozicija — pagal užklausą, puslapį, datų intervalą ir laikotarpių palyginimą.

GET/v1/properties/{id}/gsc/summaryAktyvu
GET/v1/properties/{id}/gsc/compareAktyvu
GET/v1/properties/{id}/gsc/top-keywordsAktyvu
GET/v1/properties/{id}/gsc/top-pagesAktyvu
GET/v1/properties/{id}/gsc/keywords/detailAktyvu
GET/v1/properties/{id}/gsc/pages/detailAktyvu

AI Tracker

Skaitykite užklausas, kurias stebite dėl prekės ženklo paminėjimų ChatGPT, Claude, Gemini ir Perplexity.

GET/v1/properties/{id}/ai-tracker/promptsAktyvu

Užduotys

Skaitykite ir rašykite SEO užduotis — sujunkite savo užduočių lentą su savo projektų valdymo sistema.

GET/v1/properties/{id}/tasksAktyvu
POST/v1/properties/{id}/tasksAktyvu
GET/v1/properties/{id}/tasks/{ticketId}Aktyvu
PATCH/v1/properties/{id}/tasks/{ticketId}Aktyvu
POST/v1/properties/{id}/tasks/{ticketId}/commentsAktyvu

GA4 ir indeksavimas

Srautas, AI nukreipėjai ir indeksavimo būsena. Sąsaja paruošta; REST galiniai taškai diegiami.

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

Svetainės auditas

Nuskaitymo būklė, puslapio turinys, technika ir problemų sąrašai — visas audito duomenų rinkinys, pateiktas per REST.

GET/v1/properties/{id}/audit/summaryNetrukus
GET/v1/properties/{id}/audit/issuesNetrukus

Kodėl ši API

Sukurta produktams, ne nuskaitymams

Tikra REST API su Bearer autentifikacija, apimtimis ir užklausų limitais — dalijasi vienu kanoniniu duomenų sluoksniu su MCP, todėl skaičiai niekada nesiskiria.

Švarus REST, tipizuotas JSON

Nuspėjami ištekliai, standartiniai veiksmažodžiai, tipizuoti JSON atsakymai ir RFC atitinkančios klaidos (401 neautentifikuota, 403 scope_required, 429 su Retry-After). Jokio HTML nuskaitymo, jokių trapių eksportų.

Vienas kanoninis duomenų sluoksnis

REST galiniai taškai ir MCP įrankiai yra broliai virš tų pačių tiekėjų, su CI patikrintu suderinamumu. Jūsų skydelis ir AI agentai visada mato identiškus paspaudimus, parodymus ir pozicijas.

Savitarnos raktai

Kurkite ir atšaukite Bearer tokenus iš savo skydelio per kelias sekundes. Tas pats sca_live_ raktas autentifikuoja tiek REST API, tiek MCP serverį — vienas kredencialas, du paviršiai.

Dokumentuoti užklausų limitai

60 užklausų per minutę ir 1 000 per valandą vienam tokenui, su aiškiais 429 + Retry-After atsakymais. REST limitai yra atskiras baseinas nuo MCP naudojimo — vienas niekada neišsemia kito.

Apimtimis apribota prieiga

Bendros skaitymo ir rašymo apimtys saugo kiekvieną galinį tašką, įgyvendintos ugniasienėje su standartiniais step-up atsakymais. Suteikite raktui tik tai, ko jam reikia.

Kelių nuomininkų, netrukus

Google OAuth srautas kiekvienam nuomininkui, kad partneriai galėtų prijungti kiekvieną savo klientų GSC property po viena paskyra — su griežtu duomenų izoliavimu. Aktyviai kuriama; klauskite mūsų ankstyvos prieigos.

Pradėkite per 3 žingsnius

Nuo nulio iki pirmojo autentifikuoto kvietimo per porą minučių.

Sukurkite raktą

Atverkite API tokenus savo skydelyje ir sugeneruokite Bearer tokeną. Nukopijuokite jį vieną kartą — jis prasideda `sca_live_`.

Siųskite antraštę

Perduokite `Authorization: Bearer sca_live_…` su kiekviena užklausa į `https://api.seocrawl.ai/v1`. Tas pats raktas taip pat veikia su MCP serveriu.

Traukite duomenis

Kvieskite `GET /v1/properties`, kad gautumėte property `id`, tada kreipkitės į `/v1/properties/{id}/…` dėl GSC našumo, AI Tracker užklausų ar užduočių — ir nukreipkite JSON tiesiai į savo produktą, skydelį ar saugyklą.

Trys būdai pasiekti savo duomenis

Tie patys skaičiai, kitas paviršius — pasirinkite tą, kuris tinka jūsų kūrimo būdui.

REST API

Produktams, skydeliams ir duomenų srautams. Bearer autentifikacija, tipizuotas JSON, užklausų limitai. Jūs esate šiame puslapyje.

MCP serveris

AI agentams — Claude, ChatGPT ir bet kuris MCP klientas užklausia jūsų duomenų natūralia kalba.

Tyrinėkite MCP

Terminalas ir CLI

Scenarijams ir CI/CD — valdykite savo duomenis iš bet kurio MCP palaikančio terminalo agento.

Peržiūrėti CLI

Palyginti visas integracijas

Kas kuria ant API

Komandos, norinčios SEO ir AI matomumo duomenų savo pačių sistemose.

SaaS ir partneriai

Įterpkite gyvas SEO metrikas į savo produkto sąsają. Suteikite savo naudotojams Search Console ir AI matomumo duomenis nekuriant srautų patiems.

Agentūros

Nukreipkite kiekvieno kliento duomenis į individualų portalą, Looker Studio ar savo ataskaitų sluoksnį — vienas raktas, kiekviena property, jokių rankinių eksportų.

Duomenų komandos

Perkelkite GSC, pozicijų ir AI Tracker duomenis į savo saugyklą pagal tvarkaraštį. Sujunkite juos su pajamomis ir kurkite modelius, kurių reikia jūsų skydeliams.

Kūrėjai

Automatizuokite patikras ir perspėjimus, sinchronizuokite užduotis su savo PM įrankiu ir įpinkite AI matomumo stebėjimą į programas, kurias jau leidžiate.

Dažnai užduodami klausimai

Ar tikrai yra vieša SEO API?

Taip — Bearer autentifikuojama REST `/v1` API veikia ir apima Search Console našumą, properties, AI Tracker užklausas ir užduotis, su visa vieša dokumentacija adresu api.seocrawl.ai/docs. Platesnė aprėptis (GA4, visas svetainės audito eksportas) ir kelių nuomininkų partnerių OAuth pasirodys netrukus. Reikia kažko, ko dar nėra? Klauskite mūsų ankstyvos prieigos.

Kaip autentifikuotis?

Su Bearer tokenu. Sukurkite `sca_live_` raktą iš savo skydelio ir siųskite jį kaip `Authorization: Bearer <key>` su kiekviena užklausa. Savo paskyrai nėra OAuth šokio — tik antraštė.

Ar tai tas pats raktas kaip MCP?

Taip. Tas pats tokenas autentifikuoja tiek REST API, tiek MCP serverį, nes abu skaito iš vieno kanoninio duomenų sluoksnio. Vienas kredencialas, du paviršiai — ir identiški skaičiai abiejuose.

Kokie yra užklausų limitai?

60 užklausų per minutę ir 1 000 per valandą vienam tokenui. Viršijus juos gausite `429` su `Retry-After` antrašte. REST limitai stebimi atskirai nuo MCP naudojimo, todėl abu niekada nekonkuruoja dėl to paties biudžeto.

Ar galiu prijungti savo klientų Search Console properties?

Tas kelių nuomininkų partnerių srautas — Google OAuth kiekvienam nuomininkui, kad galėtumėte prijungti kiekvieną savo klientų GSC property po sava paskyra, su griežtu duomenų izoliavimu — yra aktyviai kuriamas. Jei kuriate partnerių integraciją, susisiekite dėl ankstyvos prieigos.

Kokius duomenis galiu traukti šiandien?

Search Console suvestinę ir laikotarpių palyginimus, populiariausius raktažodžius ir puslapius, vieno raktažodžio/puslapio detales, jūsų properties sąrašą, AI Tracker užklausas ir visišką skaitymą/rašymą užduotims. Tai atspindi tai, ką atskleidžia MCP, per REST.

Pasiruošę kurti ant savo SEO duomenų?

Sukurkite Bearer raktą iš savo skydelio ir atlikite pirmąjį REST kvietimą per kelias minutes — arba pasikalbėkite su mumis apie partnerių ir kelių nuomininkų prieigą.

Gaukite API raktą Skaitykite API dokumentaciją Užsisakyti demonstraciją