API Google Search Console pentru propriul tău stack
Datele de performanță din Search Console, printr-un endpoint REST curat.
Adu clicuri, afișări, CTR și poziție medie — după interogare, pagină și interval de date — direct din Google Search Console în produsul, panoul sau depozitul tău de date. Conectează GSC o singură dată în SEOcrawl AI, generează o cheie Bearer din panoul tău și apelează REST /v1 — fără să construiești tu OAuth-ul Google. Este același strat de date canonic care alimentează MCP-ul SEOcrawl AI, așa că cifrele tale se potrivesc mereu. Acoperirea indexării și inspecția URL urmează pe REST; prin MCP sunt deja disponibile.
Identifică proprietatea. Preia datele GSC.
Generează un token Bearer din panoul tău și transmite-l în antetul Authorization. Identifică o singură dată id-ul proprietății Search Console, apoi interoghează-i performanța prin REST. Aceeași cheie funcționează atât pentru API-ul REST, cât și pentru serverul MCP.
URL de bază
https://api.seocrawl.ai/v1Antet Authorization
Authorization: Bearer sca_live_your_token_hereFiecare metrică din Search Console, prin REST
Clicuri, afișări, CTR și poziție medie — după interogare, pagină, interval de date și perioadă cu perioadă. Fiecare endpoint este legat de o proprietate: întâi îi afli id-ul, apoi îi citești datele din Search Console. Aceste grupuri GSC sunt live în v1; acoperirea indexării și inspecția URL sunt expuse azi de MCP și ajung pe REST imediat după.
Proprietăți
Listează proprietățile Search Console conectate la contul tău. Folosește id-ul fiecărei proprietăți în calea oricărui endpoint GSC.
- GET
/v1/propertiesLive
Performanță
Totalul de clicuri, afișări, CTR și poziție medie pentru un interval de date — plus variația față de perioada anterioară, pe aceeași fereastră.
- GET
/v1/properties/{id}/gsc/summaryLive - GET
/v1/properties/{id}/gsc/compareLive
Interogări
Interogările pe care apari, cu metrici pentru fiecare — și istoricul zilnic complet al oricărui cuvânt-cheie.
- GET
/v1/properties/{id}/gsc/top-keywordsLive - GET
/v1/properties/{id}/gsc/keywords/detailLive
Pagini
URL-urile tale cu cea mai bună performanță și metricile lor din Search Console — plus defalcarea zilnică completă pentru orice pagină.
- GET
/v1/properties/{id}/gsc/top-pagesLive - GET
/v1/properties/{id}/gsc/pages/detailLive
Acoperirea indexării
Ce indexează Google cu adevărat: stări de acoperire și istoric de indexare. Azi disponibil în MCP; endpointurile REST se lansează treptat.
- GET
/v1/properties/{id}/indexation/summaryÎn curând
Inspecție URL
Inspecție URL cu URL — acoperire, ultima accesare cu crawler și starea de indexare a unei singure pagini. Disponibilă acum prin MCP; REST urmează.
- GET
/v1/properties/{id}/url-inspectionÎn curând
Date reale din Search Console, construite pentru produse
Performanța ta reală din Google Search Console — nu estimări de la terți — printr-un API REST curat, cu autentificare Bearer și limite de rată, care împarte un singur strat de date canonic cu MCP-ul, ca cifrele să nu se contrazică niciodată.
Direct din Search Console
Clicuri, afișări, CTR și poziție medie preluate din propria ta proprietate GSC — cifrele reale raportate de Google, nu estimări modelate sau obținute prin scraping. Resurse previzibile, verbe standard, JSON tipizat și erori conforme cu RFC.
Fără OAuth Google de construit
Conectezi Search Console o singură dată în SEOcrawl AI, apoi îl citești cu o singură cheie Bearer sca_live_. Scapi de proiectul Google Cloud, de ecranul de consimțământ și de reîmprospătarea tokenurilor — generezi și revoci chei din panoul tău în câteva secunde.
Un singur strat de date canonic
Endpointurile REST pentru GSC și instrumentele GSC din MCP sunt frați peste același furnizor, 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.
Granularitate pe interogare și pe pagină
Citești totalurile unei proprietăți sau intri în detaliu: interogări de top, pagini de top, trendul zilnic al unui cuvânt-cheie sau istoricul unui singur URL — aceleași dimensiuni pe care le vezi în Search Console, accesibile prin HTTP.
Comparație între perioade inclusă
Ceri un interval (last_7_days, last_28_days, last_3_months, last_year) sau date from/to explicite și primești comparațiile între perioade din start — fără un al doilea apel și fără calcule de date pe client ca să reconciliezi variațiile.
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 — una nu o înfometează niciodată pe cealaltă.
Începe în 3 pași
De la zero la primul tău apel către Search Console în câteva minute.
Generează o cheie
Conectează Search Console în SEOcrawl AI, deschide tokenuri API și generează un token Bearer. Copiază-l o singură dată — începe cu sca_live_.
Identifică proprietatea
Apelează GET /v1/properties cu Authorization: Bearer sca_live_… ca să obții id-ul (un UUID) al proprietății Search Console pe care vrei să o citești.
Preia datele GSC
Apelează /v1/properties/{id}/gsc/summary?range=last_28_days pentru totaluri, sau /gsc/top-keywords, /gsc/top-pages și endpointurile /detail — și direcționează JSON-ul direct în produsul, panoul sau depozitul tău.
Trei moduri de a ajunge la datele tale din Search Console
Aceleași cifre GSC, 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ă — API-ul SEO complet adaugă endpointuri de poziții și vizibilitate AI pe aceeași cheie.
Server MCP
Pentru agenți AI — Claude, ChatGPT și orice client MCP îți interoghează datele din Search Console în limbaj natural.
Explorează MCP-ulTerminal și CLI
Pentru scripturi și CI/CD — controlează-ți datele GSC din orice agent de terminal compatibil cu MCP.
Vezi CLI-ulCine construiește pe API-ul Search Console
Echipe care vor date reale de performanță GSC în propriile sisteme.
Agenții
Direcționează datele Search Console ale 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 GSC manuale.
SaaS și parteneri
Integrează metrici Search Console live direct în UI-ul produsului tău. Oferă-le utilizatorilor clicuri, afișări și poziții fără să conectezi tu API-ul Google.
Echipe de date
Aduci clicurile, afișările, CTR-ul și poziția din GSC în depozitul tău după un program. Le combini cu veniturile și construiești modelele de care au nevoie panourile tale.
Dezvoltatori
Automatizează monitorizarea interogărilor și a paginilor, alertează la scăderi de poziții și conectează datele din Search Console în aplicațiile și fluxurile pe care deja le livrezi.
Întrebări frecvente
Este acesta API-ul oficial Search Console de la Google?
Nu. Este API-ul REST propriu al SEOcrawl AI, autentificat cu Bearer, peste datele Search Console pe care le-ai conectat deja la contul tău. Conectezi GSC o singură dată în SEOcrawl AI și de acolo citești clicuri, afișări, CTR și poziție cu o singură cheie sca_live_ — fără să construiești un proiect Google Cloud, un ecran de consimțământ OAuth sau o reîmprospătare de tokenuri. Cifrele sunt cifrele tale reale din Search Console; API-ul și autentificarea sunt ale noastre.
Ce date din Search Console pot prelua astăzi?
Totaluri pentru un interval de date (clicuri, afișări, CTR, poziție medie), comparații perioadă cu perioadă, interogările și paginile tale de top cu metrici și detaliul zilnic complet pentru un singur cuvânt-cheie sau o singură pagină — plus lista proprietăților tale conectate. Acoperirea indexării și inspecția URL live sunt disponibile acum prin MCP; endpointurile lor REST se lansează imediat după. Iar dacă preferi să citești contul în loc să-l interoghezi, auditul Google Search Console acoperă aceleași date într-un singur prompt.
Cum mă autentific?
Cu un token Bearer. Generează o cheie sca_live_ din panoul tău și trimite-o ca Authorization: Bearer <cheie> la fiecare cerere. Pentru propriul tău cont nu există niciun dans OAuth — doar antetul.
Ce intervale de date sunt acceptate?
Fiecare endpoint GSC acceptă fie un range (last_7_days, last_28_days, last_3_months sau last_year), fie o pereche from/to explicită. Endpointul gsc/compare returnează aceeași fereastră comparată cu perioada precedentă, așa că primești variațiile fără un al doilea apel.
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.
Este aceeași cheie și aceleași date ca la MCP?
Da. Același token sca_live_ autentifică atât API-ul REST, cât și serverul MCP, iar ambele citesc dintr-un singur strat de date canonic — așa că cifrele Search Console pe care le preiei prin REST sunt identice cu cele pe care le văd agenții tăi AI prin MCP. O singură credențială, două suprafețe.
Gata să construiești pe datele tale din Search Console?
Conectează GSC o singură dată, generează o cheie Bearer din panoul tău și fă primul tău apel REST către Search Console în câteva minute — sau explorează MCP-ul pentru agenți AI.
