REST API · v1 · Aktuāla dokumentācija

SEO API jūsu pašu sistēmai

Jūsu SEO un AI redzamības dati caur tīru REST galapunktu.

Velciet Google Search Console, pozīciju un AI Tracker datus tieši savā produktā, panelī vai datu noliktavā. Autentificējieties ar Bearer atslēgu no sava paneļa, izsauciet REST `/v1` un saņemiet tipizētu JSON — to pašu kanonisko datu slāni, kas darbina SEOcrawl AI MCP. GA4, pilns vietnes audita eksports un vairāku nomnieku partneru OAuth tiek ieviesti drīzumā.

Iegūstiet API atslēgu Lasiet API dokumentāciju Izpētiet MCP

Bearer autentifikācija · 60 pieprasījumi/min · Tas pats datu slānis kā MCP · Bez skrāpēšanas

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

} }

Autentificējieties vienreiz. Izsauciet REST.

Izveidojiet Bearer marķieri no sava paneļa un nododiet to Authorization galvenē. Tā pati atslēga darbojas gan REST API, gan MCP serverī.

Bāzes URL

https://api.seocrawl.ai/v1

Authorization galvene

Authorization: Bearer sca_live_your_token_here

Iegūstiet API atslēgu 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())

Galapunkti

Viens datu slānis, divas virsmas

Katrs REST galapunkts nolasa no tā paša kanoniskā slāņa kā MCP rīki — tāpēc jūsu panelis un AI aģenti vienmēr redz identiskus skaitļus. Šīs grupas ir aktīvas v1; pārklājums tiek nepārtraukti paplašināts.

Properties

Uzskaitiet Search Console properties, kurām varat piekļūt. Izmantojiet katras property `id` katra datu galapunkta ceļā.

GET/v1/propertiesAktīvs

Google Search Console

Klikšķi, parādīšanās, CTR un vidējā pozīcija — pēc vaicājuma, lapas, datumu diapazona un periodu salīdzinājuma.

GET/v1/properties/{id}/gsc/summaryAktīvs
GET/v1/properties/{id}/gsc/compareAktīvs
GET/v1/properties/{id}/gsc/top-keywordsAktīvs
GET/v1/properties/{id}/gsc/top-pagesAktīvs
GET/v1/properties/{id}/gsc/keywords/detailAktīvs
GET/v1/properties/{id}/gsc/pages/detailAktīvs

AI Tracker

Lasiet uzvednes, kuras uzraugāt zīmola pieminējumiem ChatGPT, Claude, Gemini un Perplexity.

GET/v1/properties/{id}/ai-tracker/promptsAktīvs

Uzdevumi

Lasiet un rakstiet SEO uzdevumus — savienojiet savu uzdevumu dēli ar savu projektu vadības sistēmu.

GET/v1/properties/{id}/tasksAktīvs
POST/v1/properties/{id}/tasksAktīvs
GET/v1/properties/{id}/tasks/{ticketId}Aktīvs
PATCH/v1/properties/{id}/tasks/{ticketId}Aktīvs
POST/v1/properties/{id}/tasks/{ticketId}/commentsAktīvs

GA4 un indeksēšana

Datplūsma, AI novirzītāji un indeksēšanas statuss. Saskarne ir gatava; REST galapunkti tiek ieviesti.

GET/v1/properties/{id}/ga4/summaryDrīzumā
GET/v1/properties/{id}/indexation/summaryDrīzumā

Vietnes audits

Pārmeklēšanas veselība, lapas saturs, tehnika un problēmu saraksti — pilns audita datu kopums, pieejams caur REST.

GET/v1/properties/{id}/audit/summaryDrīzumā
GET/v1/properties/{id}/audit/issuesDrīzumā

Kāpēc šī API

Veidota produktiem, ne skrāpjiem

Īsta REST API ar Bearer autentifikāciju, apjomiem un pieprasījumu limitiem — dala vienu kanonisko datu slāni ar MCP, tāpēc skaitļi nekad neatšķiras.

Tīrs REST, tipizēts JSON

Paredzami resursi, standarta darbības vārdi, tipizētas JSON atbildes un RFC atbilstošas kļūdas (401 neautentificēts, 403 scope_required, 429 ar Retry-After). Bez HTML skrāpēšanas, bez trausliem eksportiem.

Viens kanoniskais datu slānis

REST galapunkti un MCP rīki ir brāļi virs tiem pašiem nodrošinātājiem, ar CI pārbaudītu paritāti. Jūsu panelis un AI aģenti vienmēr redz identiskus klikšķus, parādīšanās un pozīcijas.

Pašapkalpošanās atslēgas

Izveidojiet un atsauciet Bearer marķierus no sava paneļa dažu sekunžu laikā. Tā pati sca_live_ atslēga autentificē gan REST API, gan MCP serveri — viens akreditācijas dati, divas virsmas.

Dokumentēti pieprasījumu limiti

60 pieprasījumi minūtē un 1 000 stundā vienam marķierim, ar skaidrām 429 + Retry-After atbildēm. REST limiti ir atsevišķs baseins no MCP lietojuma — viens nekad neizsmeļ otru.

Apjomos ierobežota piekļuve

Vispārīgi lasīšanas un rakstīšanas apjomi aizsargā katru galapunktu, tiek ieviesti ugunsmūrī ar standarta step-up atbildēm. Piešķiriet atslēgai tikai to, kas tai nepieciešams.

Vairāku nomnieku, drīzumā

Google OAuth plūsma katram nomniekam, lai partneri varētu savienot katru savu klientu GSC property zem vienas konta — ar stingru datu izolāciju. Aktīvā izstrādē; jautājiet mums par agrīnu piekļuvi.

Sāciet 3 soļos

No nulles līdz jūsu pirmajam autentificētajam izsaukumam pāris minūtēs.

Izveidojiet atslēgu

Atveriet API marķierus savā panelī un ģenerējiet Bearer marķieri. Nokopējiet to vienreiz — tas sākas ar `sca_live_`.

Sūtiet galveni

Nododiet `Authorization: Bearer sca_live_…` katrā pieprasījumā uz `https://api.seocrawl.ai/v1`. Tā pati atslēga darbojas arī ar MCP serveri.

Velciet datus

Izsauciet `GET /v1/properties`, lai iegūtu property `id`, pēc tam vērsieties pie `/v1/properties/{id}/…` par GSC veiktspēju, AI Tracker uzvednēm vai uzdevumiem — un novirziet JSON tieši savā produktā, panelī vai noliktavā.

Trīs veidi, kā sasniegt savus datus

Tie paši skaitļi, cita virsma — izvēlieties to, kas atbilst jūsu izstrādes veidam.

REST API

Produktiem, paneļiem un datu cauruļvadiem. Bearer autentifikācija, tipizēts JSON, pieprasījumu limiti. Jūs esat šajā lapā.

MCP serveris

AI aģentiem — Claude, ChatGPT un jebkurš MCP klients vaicā jūsu datus dabiskā valodā.

Izpētiet MCP

Terminālis un CLI

Skriptiem un CI/CD — vadiet savus datus no jebkura MCP spējīga termināļa aģenta.

Skatīt CLI

Salīdzināt visas integrācijas

Kas veido uz API

Komandas, kas vēlas SEO un AI redzamības datus savās pašu sistēmās.

SaaS un partneri

Iegultiet dzīvas SEO metrikas sava produkta saskarnē. Sniedziet saviem lietotājiem Search Console un AI redzamības datus, neveidojot cauruļvadus pašiem.

Aģentūras

Novirziet katra klienta datus uz pielāgotu portālu, Looker Studio vai savu atskaišu slāni — viena atslēga, katra property, bez manuāliem eksportiem.

Datu komandas

Ievietojiet GSC, pozīciju un AI Tracker datus savā noliktavā pēc grafika. Savienojiet tos ar ieņēmumiem un veidojiet modeļus, kas nepieciešami jūsu paneļiem.

Izstrādātāji

Automatizējiet pārbaudes un brīdinājumus, sinhronizējiet uzdevumus ar savu PM rīku un integrējiet AI redzamības uzraudzību lietotnēs, kuras jau piegādājat.

Bieži uzdotie jautājumi

Vai tiešām ir publiska SEO API?

Jā — Bearer autentificēta REST `/v1` API ir aktīva un aptver Search Console veiktspēju, properties, AI Tracker uzvednes un uzdevumus, ar pilnu publisko dokumentāciju vietnē api.seocrawl.ai/docs. Plašāks pārklājums (GA4, pilns vietnes audita eksports) un vairāku nomnieku partneru OAuth tiek ieviesti drīzumā. Nepieciešams kaut kas, kas vēl nav aktīvs? Jautājiet mums par agrīnu piekļuvi.

Kā autentificēties?

Ar Bearer marķieri. Izveidojiet `sca_live_` atslēgu no sava paneļa un sūtiet to kā `Authorization: Bearer <key>` katrā pieprasījumā. Savam kontam nav OAuth dejas — tikai galvene.

Vai tā ir tā pati atslēga kā MCP?

Jā. Tas pats marķieris autentificē gan REST API, gan MCP serveri, jo abi nolasa no viena kanoniskā datu slāņa. Viens akreditācijas dati, divas virsmas — un identiski skaitļi abās.

Kādi ir pieprasījumu limiti?

60 pieprasījumi minūtē un 1 000 stundā vienam marķierim. Pārsniedzot tos, saņemsiet `429` ar `Retry-After` galveni. REST limiti tiek uzskaitīti atsevišķi no MCP lietojuma, tāpēc abi nekad nekonkurē par vienu budžetu.

Vai varu savienot savu klientu Search Console properties?

Šī vairāku nomnieku partneru plūsma — Google OAuth katram nomniekam, lai jūs varētu savienot katru savu klientu GSC property zem sava konta, ar stingru datu izolāciju — ir aktīvā izstrādē. Ja veidojat partneru integrāciju, sazinieties par agrīnu piekļuvi.

Kādus datus varu vilkt šodien?

Search Console kopsavilkumu un periodu salīdzinājumus, populārākos atslēgvārdus un lapas, viena atslēgvārda/lapas detaļas, jūsu properties sarakstu, AI Tracker uzvednes un pilnu lasīšanu/rakstīšanu uzdevumiem. Tas atspoguļo to, ko atklāj MCP, caur REST.

Gatavi veidot uz saviem SEO datiem?

Izveidojiet Bearer atslēgu no sava paneļa un veiciet savu pirmo REST izsaukumu dažu minūšu laikā — vai runājiet ar mums par partneru un vairāku nomnieku piekļuvi.

Iegūstiet API atslēgu Lasiet API dokumentāciju Pieteikt demonstrāciju