Cu un token Bearer. Generează o cheie `sca_live_` din panoul tău și trimite-o ca `Authorization: Bearer ` la fiecare cerere. Nu există niciun dans OAuth pentru propriul tău cont — doar antetul.

REST API · v1 · Documentație live

SEO API pentru propriul tău stack

Datele tale SEO și de vizibilitate AI, printr-un endpoint REST curat.

Preia datele din Google Search Console, pozițiile și datele AI Tracker direct în produsul, panoul sau depozitul tău de date. Autentifică-te cu o cheie Bearer din panoul tău, apelează REST `/v1` și primești JSON tipizat — același strat de date canonic care alimentează MCP-ul SEOcrawl AI. GA4, exportul complet al auditului de site și OAuth pentru parteneri multi-tenant urmează în curând.

Obține cheia ta API Citește documentația API Explorează MCP-ul

Autentificare Bearer · 60 cereri/min · Același strat de date ca MCP-ul · Fără scraping

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ă-te o singură dată. Apelează REST.

Generează un token Bearer din panoul tău și transmite-l în antetul Authorization. Aceeași cheie funcționează atât pentru API-ul REST, cât și pentru serverul MCP.

URL de bază

https://api.seocrawl.ai/v1

Antet Authorization

Authorization: Bearer sca_live_your_token_here

Obține cheia ta API 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())

Endpointuri

Un singur strat de date, două suprafețe

Fiecare endpoint REST citește din același strat canonic ca instrumentele MCP — astfel încât panoul tău și agenții tăi AI văd mereu aceleași cifre. Grupurile de mai jos sunt live în v1, iar acoperirea se extinde continuu.

Proprietăți

Listează proprietățile Search Console la care ai acces. Folosește `id`-ul fiecărei proprietăți în calea oricărui endpoint de date.

GET/v1/propertiesLive

Google Search Console

Clicuri, afișări, CTR și poziție medie — după interogare, pagină, interval de timp și comparație perioadă cu perioadă.

GET/v1/properties/{id}/gsc/summaryLive
GET/v1/properties/{id}/gsc/compareLive
GET/v1/properties/{id}/gsc/top-keywordsLive
GET/v1/properties/{id}/gsc/top-pagesLive
GET/v1/properties/{id}/gsc/keywords/detailLive
GET/v1/properties/{id}/gsc/pages/detailLive

AI Tracker

Citește prompturile pe care le monitorizezi pentru mențiuni de brand în ChatGPT, Claude, Gemini și Perplexity.

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

Sarcini

Citește și scrie sarcini SEO — conectează panoul tău de sarcini la propriul stack de management de proiect.

GET/v1/properties/{id}/tasksLive
POST/v1/properties/{id}/tasksLive
GET/v1/properties/{id}/tasks/{ticketId}Live
PATCH/v1/properties/{id}/tasks/{ticketId}Live
POST/v1/properties/{id}/tasks/{ticketId}/commentsLive

GA4 și indexare

Trafic, referreri AI și starea indexării. Îmbinarea este pregătită, iar endpointurile REST sunt în curs de lansare.

GET/v1/properties/{id}/ga4/summaryÎn curând
GET/v1/properties/{id}/indexation/summaryÎn curând

Audit de site

Sănătatea crawl-ului, on-page, elemente tehnice și liste de probleme — întregul set de date al auditului, expus prin REST.

GET/v1/properties/{id}/audit/summaryÎn curând
GET/v1/properties/{id}/audit/issuesÎn curând

De ce acest API

Construit pentru produse, nu pentru scrapere

Un API REST veritabil, cu autentificare Bearer, scopuri și limite de rată — care împarte un singur strat de date canonic cu MCP-ul, astfel încât cifrele nu se contrazic niciodată.

REST curat, JSON tipizat

Resurse previzibile, verbe HTTP standard, răspunsuri JSON tipizate și erori conforme RFC (401 unauthenticated, 403 scope_required, 429 cu Retry-After). Fără scraping HTML, fără exporturi fragile.

Un singur strat de date canonic

Endpointurile REST și instrumentele MCP sunt frați peste aceiași furnizori, cu paritate testată în CI. Panoul tău și agenții tăi AI văd mereu aceleași clicuri, afișări și poziții.

Chei self-service

Generează și revocă tokenuri Bearer din panoul tău în câteva secunde. Aceeași cheie sca_live_ autentifică atât API-ul REST, cât și serverul MCP — o singură credențială, două suprafețe.

Limite de rată documentate

60 de cereri pe minut și 1.000 pe oră per token, cu răspunsuri clare 429 + Retry-After. Limitele REST sunt un pool separat de utilizarea MCP — niciuna nu o înfometează pe cealaltă.

Acces pe bază de scopuri

Scopuri brute de citire și scriere controlează fiecare endpoint, aplicate la firewall cu răspunsuri standard de step-up. Acordă unei chei doar ceea ce are nevoie.

Multi-tenant, în curând

Un flux Google OAuth per tenant, astfel încât partenerii să poată conecta fiecare dintre proprietățile GSC ale clienților lor sub un singur cont — cu izolare strictă a datelor. În dezvoltare activă; cere-ne acces timpuriu.

Începe în 3 pași

De la zero la primul tău apel autentificat în câteva minute.

Generează o cheie

Deschide tokenuri API în panoul tău și generează un token Bearer. Copiază-l o singură dată — începe cu `sca_live_`.

Trimite antetul

Transmite `Authorization: Bearer sca_live_…` la fiecare cerere către `https://api.seocrawl.ai/v1`. Aceeași cheie funcționează și cu serverul MCP.

Preia datele

Apelează `GET /v1/properties` pentru a obține un `id` de proprietate, apoi accesează `/v1/properties/{id}/…` pentru performanța GSC, prompturile AI Tracker sau sarcini — și direcționează JSON-ul direct în produsul, panoul sau depozitul tău.

Trei moduri de a ajunge la datele tale

Aceleași cifre, suprafață diferită — alege-o pe cea care se potrivește modului în care construiești.

REST API

Pentru produse, panouri și pipeline-uri de date. Autentificare Bearer, JSON tipizat, limite de rată. Ești pe această pagină.

Server MCP

Pentru agenți AI — Claude, ChatGPT și orice client MCP îți interoghează datele în limbaj natural.

Explorează MCP-ul

Terminal și CLI

Pentru scripturi și CI/CD — controlează-ți datele din orice agent de terminal compatibil cu MCP.

Vezi CLI-ul

Compară toate integrările

Cine construiește pe API

Echipe care vor date SEO și de vizibilitate AI în propriile sisteme.

SaaS și parteneri

Integrează metrici SEO live în propriul UI al produsului tău. Oferă utilizatorilor tăi date din Search Console și de vizibilitate AI fără să construiești tu însuți pipeline-urile.

Agenții

Direcționează datele fiecărui client către un portal personalizat, Looker Studio sau stratul tău de raportare — o singură cheie, toate proprietățile, fără exporturi manuale.

Echipe de date

Aduci datele GSC, de poziții și AI Tracker în depozitul tău după un program. Le combini cu veniturile și construiești modelele de care au nevoie panourile tale.

Dezvoltatori

Automatizează verificări și alerte, sincronizează sarcinile cu instrumentul tău de PM și conectează monitorizarea vizibilității AI în aplicațiile pe care deja le livrezi.

Întrebări frecvente

Chiar există un SEO API public?

Da — un API REST `/v1` autentificat cu Bearer este live, acoperind performanța Search Console, proprietățile, prompturile AI Tracker și sarcinile, cu referința publică completă publicată la api.seocrawl.ai/docs. Acoperire mai largă (GA4, export complet al auditului de site) și OAuth pentru parteneri multi-tenant urmează în curând. Ai nevoie de ceva care nu este încă live? Cere-ne acces timpuriu.

Cum mă autentific?

Cu un token Bearer. Generează o cheie `sca_live_` din panoul tău și trimite-o ca `Authorization: Bearer <key>` la fiecare cerere. Nu există niciun dans OAuth pentru propriul tău cont — doar antetul.

Este aceeași cheie ca la MCP?

Da. Același token autentifică atât API-ul REST, cât și serverul MCP, deoarece ambele citesc dintr-un singur strat de date canonic. O singură credențială, două suprafețe — și cifre identice pe amândouă.

Care sunt limitele de rată?

60 de cereri pe minut și 1.000 pe oră per token. Dacă le depășești, primești un `429` cu un antet `Retry-After`. Limitele REST sunt urmărite separat de utilizarea MCP, așa că cele două nu concurează niciodată pentru același buget.

Pot conecta proprietățile Search Console ale clienților mei?

Acel flux pentru parteneri multi-tenant — un Google OAuth per tenant, astfel încât să poți conecta fiecare dintre proprietățile GSC ale clienților tăi sub propriul tău cont, cu izolare strictă a datelor — este în dezvoltare activă. Dacă construiești o integrare de partener, ia legătura cu noi pentru acces timpuriu.

Ce date pot prelua astăzi?

Rezumatul Search Console și comparațiile pe perioade, cuvintele-cheie și paginile de top, detaliul pentru un singur cuvânt-cheie/pagină, lista ta de proprietăți, prompturile AI Tracker și citire/scriere completă pe sarcini. Reflectă ceea ce expune MCP-ul, prin REST.

Ești gata să construiești pe datele tale SEO?

Generează o cheie Bearer din panoul tău și fă primul tău apel REST în câteva minute — sau vorbește cu noi despre accesul pentru parteneri și multi-tenant.

Obține cheia ta API Citește documentația API Rezervă un demo