Google Search Console API jūsų pačių sistemai
Jūsų Search Console našumo duomenys per švarų REST galinį tašką.
Traukite paspaudimus, parodymus, CTR ir vidutinę poziciją — pagal užklausą, puslapį ir datų intervalą — tiesiai iš Google Search Console į savo produktą, skydelį ar duomenų saugyklą. Prijunkite GSC vieną kartą SEOcrawl AI viduje, sukurkite Bearer raktą savo skydelyje ir kvieskite REST /v1 — Google OAuth kurti patiems nereikia. Tai tas pats kanoninis duomenų sluoksnis, kuris maitina SEOcrawl AI MCP, todėl skaičiai visada sutampa. Indeksavimo aprėptis ir URL patikrinimas REST pasirodys netrukus; per MCP jie veikia jau dabar.
Nustatykite property. Traukite GSC duomenis.
Sukurkite Bearer tokeną savo skydelyje ir perduokite jį Authorization antraštėje. Vieną kartą nustatykite Search Console property id, o tada užklauskite jos našumo per REST. Tas pats raktas veikia ir REST API, ir MCP serveryje.
Bazinis URL
https://api.seocrawl.ai/v1Authorization antraštė
Authorization: Bearer sca_live_your_token_hereVisos Search Console metrikos, per REST
Paspaudimai, parodymai, CTR ir vidutinė pozicija — pagal užklausą, puslapį, datų intervalą ir laikotarpių palyginimą. Kiekvienas galinis taškas susietas su property: pirma nustatykite property id, tada skaitykite jos Search Console duomenis. Šios GSC grupės jau veikia v1; indeksavimo aprėptį ir URL patikrinimą šiandien atskleidžia MCP, o REST galiniai taškai pasirodys iškart po to.
Properties
Išvardykite prie jūsų paskyros prijungtas Search Console properties. Kiekvienos property id naudokite kiekvieno GSC galinio taško kelyje.
- GET
/v1/propertiesAktyvu
Našumas
Bendri paspaudimai, parodymai, CTR ir vidutinė pozicija pasirinktam datų intervalui — plius to paties lango pokytis, palyginti su ankstesniu laikotarpiu.
- GET
/v1/properties/{id}/gsc/summaryAktyvu - GET
/v1/properties/{id}/gsc/compareAktyvu
Užklausos
Paieškos užklausos, pagal kurias esate randami, su metrikomis kiekvienai užklausai — ir visa vieno raktažodžio dienos istorija.
- GET
/v1/properties/{id}/gsc/top-keywordsAktyvu - GET
/v1/properties/{id}/gsc/keywords/detailAktyvu
Puslapiai
Geriausiai veikiantys jūsų URL su Search Console metrikomis — ir visas bet kurio puslapio dienos našumo išskaidymas.
- GET
/v1/properties/{id}/gsc/top-pagesAktyvu - GET
/v1/properties/{id}/gsc/pages/detailAktyvu
Indeksavimo aprėptis
Ką Google iš tikrųjų indeksuoja: aprėpties būsenos ir indeksavimo istorija. Šiandien veikia MCP; REST galiniai taškai diegiami.
- GET
/v1/properties/{id}/indexation/summaryNetrukus
URL patikrinimas
Patikra URL po URL — vieno puslapio aprėptis, paskutinis nuskaitymas ir indeksavimo būsena. Jau pasiekiama per MCP; REST eina po to.
- GET
/v1/properties/{id}/url-inspectionNetrukus
Tikri Search Console duomenys, sukurti produktams
Jūsų tikrasis Google Search Console našumas — ne trečiųjų šalių įverčiai — per švarią REST API su Bearer autentifikacija ir užklausų limitais, dalijantis vienu kanoniniu duomenų sluoksniu su MCP, kad skaičiai niekada nesiskirtų.
Tiesiai iš Search Console
Paspaudimai, parodymai, CTR ir vidutinė pozicija, paimti iš jūsų pačių GSC property — tikri Google pateikiami skaičiai, o ne modeliuoti ar nuskaityti įverčiai. Nuspėjami ištekliai, standartiniai veiksmažodžiai, tipizuotas JSON ir RFC atitinkančios klaidos.
Nereikia kurti Google OAuth
Prijunkite Search Console vieną kartą SEOcrawl AI viduje ir skaitykite ją vienu sca_live_ Bearer raktu. Praleiskite Google Cloud projektą, sutikimo ekraną ir tokenų atnaujinimą — raktus sukursite ir atšauksite savo skydelyje per kelias sekundes.
Vienas kanoninis duomenų sluoksnis
REST GSC galiniai taškai ir MCP GSC įrankiai yra broliai virš to paties tiekėjo, su CI patikrintu suderinamumu. Jūsų skydelis ir AI agentai visada mato identiškus paspaudimus, parodymus ir pozicijas.
Detalumas iki užklausos ir puslapio
Skaitykite property sumas arba gilinkitės: populiariausios užklausos, populiariausi puslapiai, vieno raktažodžio dienos tendencija ar vieno URL istorija — tie patys pjūviai, kuriuos matote Search Console, pasiekiami per HTTP.
Laikotarpių palyginimas iš karto
Nurodykite range (last_7_days, last_28_days, last_3_months, last_year) arba aiškias from/to datas ir gaukite laikotarpių palyginimą iš dėžutės — be antros užklausos ir be datų skaičiavimų kliente pokyčiams suvesti.
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.
Pradėkite per 3 žingsnius
Nuo nulio iki pirmojo kvietimo į Search Console per porą minučių.
Sukurkite raktą
Prijunkite Search Console SEOcrawl AI viduje, atverkite API tokenus ir sugeneruokite Bearer tokeną. Nukopijuokite jį vieną kartą — jis prasideda sca_live_.
Nustatykite property
Kvieskite GET /v1/properties su Authorization: Bearer sca_live_…, kad gautumėte norimos skaityti Search Console property id (UUID).
Traukite GSC duomenis
Kreipkitės į /v1/properties/{id}/gsc/summary?range=last_28_days dėl sumų arba į /gsc/top-keywords, /gsc/top-pages ir /detail galinius taškus — ir nukreipkite JSON tiesiai į savo produktą, skydelį ar saugyklą.
Trys būdai pasiekti savo Search Console duomenis
Tie patys GSC 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 — visa SEO API su tuo pačiu raktu prideda pozicijų ir AI matomumo galinius taškus.
MCP serveris
AI agentams — Claude, ChatGPT ir bet kuris MCP klientas užklausia jūsų Search Console duomenų natūralia kalba.
Tyrinėkite MCPTerminalas ir CLI
Scenarijams ir CI/CD — valdykite savo GSC duomenis iš bet kurio MCP palaikančio terminalo agento.
Peržiūrėti CLIKas kuria ant Search Console API
Komandos, norinčios tikrų GSC našumo duomenų savo pačių sistemose.
Agentūros
Nukreipkite kiekvieno kliento Search Console duomenis į individualų portalą, Looker Studio ar savo ataskaitų sluoksnį — vienas raktas, visos properties, jokių rankinių GSC eksportų.
SaaS ir partneriai
Įterpkite gyvas Search Console metrikas į savo produkto sąsają. Suteikite naudotojams paspaudimus, parodymus ir pozicijas patys nekurdami Google API integracijos.
Duomenų komandos
Perkelkite GSC paspaudimus, parodymus, CTR ir poziciją į savo saugyklą pagal tvarkaraštį. Sujunkite juos su pajamomis ir kurkite modelius, kurių reikia jūsų skydeliams.
Kūrėjai
Automatizuokite užklausų ir puslapių stebėjimą, gaukite perspėjimus apie pozicijų kritimus ir įpinkite Search Console duomenis į programas bei darbo srautus, kuriuos jau leidžiate.
Dažnai užduodami klausimai
Ar tai oficiali Google Search Console API?
Ne. Tai SEOcrawl AI nuosava, Bearer autentifikuojama REST API virš Search Console duomenų, kuriuos jau prijungėte prie savo paskyros. GSC prijungiate vieną kartą SEOcrawl AI viduje, o tada skaitote paspaudimus, parodymus, CTR ir poziciją per vieną švarų sca_live_ raktą — patiems nekuriant Google Cloud projekto, OAuth sutikimo ekrano ar tokenų atnaujinimo. Skaičiai yra jūsų tikri Search Console skaičiai; API ir autentifikacija — mūsų.
Kokius Search Console duomenis galiu traukti šiandien?
Sumas už datų intervalą (paspaudimai, parodymai, CTR, vidutinė pozicija), laikotarpių palyginimus, populiariausias užklausas ir puslapius su metrikomis bei visas vieno raktažodžio ar vieno puslapio dienos detales — plius jūsų prijungtų properties sąrašą. Indeksavimo aprėptis ir gyvas URL patikrinimas jau pasiekiami per MCP; jų REST galiniai taškai pasirodys iškart po to. O jei paskyrą labiau norite perskaityti nei užklausinėti, Google Search Console auditas apima tuos pačius duomenis viename prompte.
Kaip autentifikuotis?
Su Bearer tokenu. Sukurkite sca_live_ raktą savo skydelyje ir siųskite jį kaip Authorization: Bearer <key> su kiekviena užklausa. Savo paskyrai jokio OAuth šokio nėra — tik antraštė.
Kokie datų intervalai palaikomi?
Kiekvienas GSC galinis taškas priima arba range (last_7_days, last_28_days, last_3_months ar last_year), arba aiškią from/to porą. Galinis taškas gsc/compare grąžina tą patį langą, palygintą su ankstesniu laikotarpiu, todėl pokyčius gaunate be antros užklausos.
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 tai tas pats raktas ir tie patys duomenys kaip MCP?
Taip. Tas pats sca_live_ tokenas autentifikuoja ir REST API, ir MCP serverį, o abu skaito iš vieno kanoninio duomenų sluoksnio — todėl per REST traukiami Search Console skaičiai yra identiški tiems, kuriuos per MCP mato jūsų AI agentai. Vienas kredencialas, du paviršiai.
Pasiruošę kurti ant savo Search Console duomenų?
Prijunkite GSC vieną kartą, sukurkite Bearer raktą savo skydelyje ir atlikite pirmąjį REST kvietimą į Search Console per kelias minutes — arba tyrinėkite MCP savo AI agentams.
