REST API · v1 · Elav dokumentatsioon

SEO API teie enda süsteemile

Teie SEO ja AI nähtavuse andmed puhta REST-lõpp-punkti kaudu.

Tõmmake Google Search Console'i, positsioonide ja AI Tracker'i andmed otse oma tootesse, töölauale või andmelattu. Autentige end Bearer-võtmega oma töölaualt, kutsuge REST `/v1` ja saage tagasi tüübitud JSON — sama kanooniline andmekiht, mis toidab SEOcrawl AI MCP-d. GA4, täielik saidiauditi eksport ja mitme rentniku partneri OAuth saabuvad peagi.

Hankige API võti Lugege API dokumentatsiooni Uurige MCP-d

Bearer-autentimine · 60 päringut/min · Sama andmekiht kui MCP · Ei mingit kraapimist

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

} }

Autentige end üks kord. Kutsuge REST.

Looge Bearer-luba oma töölaualt ja edastage see Authorization päises. Sama võti töötab nii REST API-l kui ka MCP-serveril.

Baas-URL

https://api.seocrawl.ai/v1

Authorization päis

Authorization: Bearer sca_live_your_token_here

Hankige API võti 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())

Lõpp-punktid

Üks andmekiht, kaks pinda

Iga REST lõpp-punkt loeb samast kanoonilisest kihist kui MCP tööriistad — nii et teie töölaud ja AI agendid näevad alati identseid arve. Need rühmad on v1-s aktiivsed; katvust laiendatakse pidevalt.

Properties

Loetlege Search Console'i properties, millele saate juurde pääseda. Kasutage iga property `id`-d iga andmelõpp-punkti teel.

GET/v1/propertiesAktiivne

Google Search Console

Klõpsud, näitamised, CTR ja keskmine positsioon — päringu, lehe, kuupäevavahemiku ja perioodivõrdluse järgi.

GET/v1/properties/{id}/gsc/summaryAktiivne
GET/v1/properties/{id}/gsc/compareAktiivne
GET/v1/properties/{id}/gsc/top-keywordsAktiivne
GET/v1/properties/{id}/gsc/top-pagesAktiivne
GET/v1/properties/{id}/gsc/keywords/detailAktiivne
GET/v1/properties/{id}/gsc/pages/detailAktiivne

AI Tracker

Lugege viipasid, mida jälgite brändimainimiste osas ChatGPT-s, Claude'is, Geminis ja Perplexitys.

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

Ülesanded

Lugege ja kirjutage SEO ülesandeid — ühendage oma ülesannete tahvel oma projektijuhtimise süsteemiga.

GET/v1/properties/{id}/tasksAktiivne
POST/v1/properties/{id}/tasksAktiivne
GET/v1/properties/{id}/tasks/{ticketId}Aktiivne
PATCH/v1/properties/{id}/tasks/{ticketId}Aktiivne
POST/v1/properties/{id}/tasks/{ticketId}/commentsAktiivne

GA4 ja indekseerimine

Liiklus, AI suunajad ja indekseerimise olek. Liides on valmis; REST lõpp-punktid on kasutusele võtmisel.

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

Saidiaudit

Roomamise tervis, lehe sisu, tehnika ja probleemide loendid — täielik auditi andmekogum, avaldatud REST-i kaudu.

GET/v1/properties/{id}/audit/summaryPeagi
GET/v1/properties/{id}/audit/issuesPeagi

Miks see API

Ehitatud toodetele, mitte kraapijatele

Päris REST API Bearer-autentimise, ulatuste ja päringulimiitidega — jagab MCP-ga üht kanoonilist andmekihti, nii et arvud ei lähe kunagi lahku.

Puhas REST, tüübitud JSON

Etteaimatavad ressursid, standardsed verbid, tüübitud JSON-vastused ja RFC-le vastavad vead (401 autentimata, 403 scope_required, 429 koos Retry-After'iga). Ei mingit HTML-kraapimist ega hapraid eksporte.

Üks kanooniline andmekiht

REST lõpp-punktid ja MCP tööriistad on õed-vennad samade pakkujate peal, CI-s testitud võrdsusega. Teie töölaud ja AI agendid näevad alati identseid klõpse, näitamisi ja positsioone.

Iseteenindusvõtmed

Looge ja tühistage Bearer-lubasid oma töölaualt sekunditega. Sama sca_live_ võti autendib nii REST API kui ka MCP-serveri — üks mandaat, kaks pinda.

Dokumenteeritud päringulimiidid

60 päringut minutis ja 1000 tunnis loa kohta, selgete 429 + Retry-After vastustega. REST-limiidid on MCP kasutusest eraldi bassein — üks ei näljuta kunagi teist.

Ulatustega piiratud juurdepääs

Üldised lugemis- ja kirjutamisulatused kaitsevad iga lõpp-punkti, jõustatud tulemüüris standardsete step-up vastustega. Andke võtmele ainult see, mida ta vajab.

Mitme rentniku, peagi

Rentnikupõhine Google OAuth voog, et partnerid saaksid ühendada iga oma klientide GSC property ühe konto alla — range andmete isoleerimisega. Aktiivses arenduses; küsige meilt varajast juurdepääsu.

Alustage 3 sammuga

Nullist esimese autenditud kutseni paari minutiga.

Looge võti

Avage API-lubad oma töölaual ja genereerige Bearer-luba. Kopeerige see üks kord — see algab `sca_live_`-ga.

Saatke päis

Edastage `Authorization: Bearer sca_live_…` iga päringuga aadressile `https://api.seocrawl.ai/v1`. Sama võti töötab ka MCP-serveriga.

Tõmmake andmeid

Kutsuge `GET /v1/properties`, et saada property `id`, seejärel pöörduge `/v1/properties/{id}/…` poole GSC jõudluse, AI Tracker'i viipade või ülesannete jaoks — ja suunake JSON otse oma tootesse, töölauale või lattu.

Kolm viisi oma andmeteni jõudmiseks

Samad arvud, erinev pind — valige see, mis sobib teie ehitamise viisiga.

REST API

Toodetele, töölaudadele ja andmetorustikele. Bearer-autentimine, tüübitud JSON, päringulimiidid. Te olete sellel lehel.

MCP-server

AI agentidele — Claude, ChatGPT ja iga MCP-klient päring teie andmeid loomulikus keeles.

Uurige MCP-d

Terminal ja CLI

Skriptidele ja CI/CD-le — juhtige oma andmeid igast MCP-võimelisest terminaliagendist.

Vaata CLI-d

Võrdle kõiki integratsioone

Kes ehitab API-le

Meeskonnad, kes soovivad SEO ja AI nähtavuse andmeid oma süsteemidesse.

SaaS ja partnerid

Manustage elavad SEO mõõdikud oma toote kasutajaliidesesse. Andke oma kasutajatele Search Console'i ja AI nähtavuse andmed ise torustikke ehitamata.

Agentuurid

Suunake iga kliendi andmed kohandatud portaali, Looker Studiosse või oma aruandluskihti — üks võti, iga property, ei mingeid käsitsi eksporte.

Andmemeeskonnad

Tooge GSC, positsioonide ja AI Tracker'i andmed oma lattu ajakava alusel. Ühendage need tuluga ja ehitage mudelid, mida teie töölauad vajavad.

Arendajad

Automatiseerige kontrolle ja hoiatusi, sünkroonige ülesanded oma PM-tööriistaga ja ühendage AI nähtavuse jälgimine rakendustesse, mida juba tarnite.

Korduma kippuvad küsimused

Kas tõesti on avalik SEO API?

Jah — Bearer-autenditud REST `/v1` API on aktiivne ja katab Search Console'i jõudluse, properties, AI Tracker'i viibad ja ülesanded, koos täieliku avaliku dokumentatsiooniga aadressil api.seocrawl.ai/docs. Laiem katvus (GA4, täielik saidiauditi eksport) ja mitme rentniku partneri OAuth saabuvad peagi. Vajate midagi, mis pole veel aktiivne? Küsige meilt varajast juurdepääsu.

Kuidas end autentida?

Bearer-loaga. Looge `sca_live_` võti oma töölaualt ja saatke see kui `Authorization: Bearer <key>` iga päringuga. Teie enda konto jaoks pole OAuth-tantsu — ainult päis.

Kas see on sama võti kui MCP?

Jah. Sama luba autendib nii REST API kui ka MCP-serveri, sest mõlemad loevad ühest kanoonilisest andmekihist. Üks mandaat, kaks pinda — ja identsed arvud mõlemas.

Millised on päringulimiidid?

60 päringut minutis ja 1000 tunnis loa kohta. Nende ületamisel saate `429` koos `Retry-After` päisega. REST-limiite jälgitakse MCP kasutusest eraldi, nii et need kaks ei võistle kunagi sama eelarve pärast.

Kas saan ühendada oma klientide Search Console'i properties?

See mitme rentniku partnerivoog — rentnikupõhine Google OAuth, et saaksite ühendada iga oma klientide GSC property oma konto alla, range andmete isoleerimisega — on aktiivses arenduses. Kui ehitate partneriintegratsiooni, võtke ühendust varajase juurdepääsu jaoks.

Milliseid andmeid saan täna tõmmata?

Search Console'i kokkuvõtte ja perioodivõrdlused, parimad märksõnad ja lehed, üksiku märksõna/lehe detailid, teie properties loendi, AI Tracker'i viibad ja täieliku lugemise/kirjutamise ülesannete jaoks. See peegeldab seda, mida MCP avaldab, REST-i kaudu.

Valmis oma SEO andmetele ehitama?

Looge Bearer-võti oma töölaualt ja tehke oma esimene REST-kutse mõne minutiga — või rääkige meiega partneri ja mitme rentniku juurdepääsust.

Hankige API võti Lugege API dokumentatsiooni Broneeri demo