Search Console'i API · REST v1 · Elav dokumentatsioon

Google Search Console'i API teie enda süsteemile

Teie Search Console'i tulemusandmed puhta REST-lõpp-punkti kaudu.

Tõmmake klõpsud, näitamised, CTR ja keskmine positsioon — päringu, lehe ja kuupäevavahemiku kaupa — otse Google Search Console'ist oma tootesse, töölauale või andmelattu. Ühendage GSC üks kord SEOcrawl AI sees, looge Bearer-võti oma töölaualt ja kutsuge REST /v1 — Google'i OAuth-i pole vaja ise ehitada. See on sama kanooniline andmekiht, mis toidab SEOcrawl AI MCP-d, nii et teie arvud klapivad alati. Indekseerimise katvus ja URL-i kontroll jõuavad REST-i järgmisena; MCP kaudu on need juba saadaval.

Hankige API võtiLugege API dokumentatsiooniUurige MCP-d
Claude
Codex CLI
Cursor
SEOcrawl AI Google Search Console'i API — curl-päring ja tüübitud JSON-vastus klõpsude, näitamiste, CTR-i ja positsiooniga.
Google Search Console'i API päringunäited cURL-is, JavaScriptis ja Pythonis.

Leidke property. Tõmmake GSC andmed.

Looge Bearer-luba oma töölaualt ja edastage see Authorization päises. Leidke Search Console'i property id üks kord üles ja pärige seejärel selle tulemusi REST-i kaudu. 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õtiRead the API docs

Kõik Search Console'i mõõdikud, REST-i kaudu

Klõpsud, näitamised, CTR ja keskmine positsioon — päringu, lehe, kuupäevavahemiku ja perioodivõrdluse järgi. Iga lõpp-punkt on seotud property'ga: leidke esmalt property id ja lugege siis selle Search Console'i andmeid. Need GSC rühmad on v1-s aktiivsed; indekseerimise katvust ja URL-i kontrolli pakub täna MCP ning need jõuavad REST-i järgmisena.

Properties

Loetlege teie kontoga ühendatud Search Console'i properties. Kasutage iga property id-d kõigi GSC lõpp-punktide teel.

  • GET/v1/propertiesAktiivne

Tulemused

Klõpsude, näitamiste, CTR-i ja keskmise positsiooni kogusummad kuupäevavahemiku kohta — pluss muutus eelmise perioodiga võrreldes sama akna kohta.

  • GET/v1/properties/{id}/gsc/summaryAktiivne
  • GET/v1/properties/{id}/gsc/compareAktiivne

Otsingupäringud

Otsingupäringud, millega te esile tulete, koos mõõdikutega päringu kaupa — ja iga üksiku märksõna täielik päevaajalugu.

  • GET/v1/properties/{id}/gsc/top-keywordsAktiivne
  • GET/v1/properties/{id}/gsc/keywords/detailAktiivne

Lehed

Teie parimad URL-id koos Search Console'i mõõdikutega — ja iga üksiku lehe täielik päevade lõikes jaotus.

  • GET/v1/properties/{id}/gsc/top-pagesAktiivne
  • GET/v1/properties/{id}/gsc/pages/detailAktiivne

Indekseerimise katvus

Mida Google tegelikult indekseerib: katvuse olekud ja indekseerimise ajalugu. Täna saadaval MCP-s; REST lõpp-punktid on väljatulekul.

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

URL-i kontroll

Kontroll URL-i kaupa — ühe lehe katvus, viimane roomamine ja indekseerimise olek. MCP kaudu juba saadaval; REST tuleb järgmisena.

  • GET/v1/properties/{id}/url-inspectionPeagi

Päris Search Console'i andmed, ehitatud toodetele

Teie tegelikud Google Search Console'i tulemused — mitte kolmandate osapoolte hinnangud — puhta REST API kaudu, Bearer-autentimise ja päringulimiitidega, jagades MCP-ga üht kanoonilist andmekihti, et arvud ei läheks kunagi lahku.

Otse Search Console'ist

Klõpsud, näitamised, CTR ja keskmine positsioon teie enda GSC property'st — päris arvud, mida Google raporteerib, mitte modelleeritud ega kraabitud hinnangud. Etteaimatavad ressursid, standardsed verbid, tüübitud JSON ja RFC-le vastavad vead.

Google'i OAuth-i pole vaja ehitada

Ühendage Search Console üks kord SEOcrawl AI sees ja lugege seda seejärel ühe sca_live_ Bearer-võtmega. Jätke vahele Google Cloud'i projekt, nõusolekuekraan ja loa uuendamine — võtmeid loote ja tühistate sekunditega oma töölaualt.

Üks kanooniline andmekiht

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

Täpsus päringu ja lehe tasemel

Lugege property kogusummasid või minge detaili: parimad päringud, parimad lehed, ühe märksõna päevatrend või ühe URL-i ajalugu — samad mõõtmed, mida näete Search Console'is, kättesaadavad HTTP kaudu.

Perioodivõrdlus on sisse ehitatud

Küsige vahemikku (last_7_days, last_28_days, last_3_months, last_year) või selgeid from/to kuupäevi ja saate perioodivõrdluse kohe kaasa — ilma teise päringuta ja ilma kuupäevaarvutusteta kliendi poolel, et muutusi kokku viia.

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.

Alustage 3 sammuga

Nullist esimese Search Console'i päringuni paari minutiga.

1

Looge võti

Ühendage Search Console SEOcrawl AI-s, avage API load ja looge Bearer-luba. Kopeerige see kohe — see algab eesliitega sca_live_.

2

Leidke property

Kutsuge GET /v1/properties päisega Authorization: Bearer sca_live_…, et saada selle Search Console'i property id (UUID), mida soovite lugeda.

3

Tõmmake GSC andmed

Kasutage kogusummade jaoks /v1/properties/{id}/gsc/summary?range=last_28_days või lõpp-punkte /gsc/top-keywords, /gsc/top-pages ja /detail — ning suunake JSON otse oma tootesse, töölauale või lattu.

Kolm viisi oma Search Console'i andmeteni jõuda

Samad GSC arvud, erinev pind — valige see, mis sobib teie ehitusviisiga.

REST API

Toodetele, töölaudadele ja andmetorudele. Bearer-autentimine, tüübitud JSON, päringulimiidid. Olete praegu siin — täielik SEO API lisab sama võtmega positsioonide ja AI nähtavuse lõpp-punktid.

MCP-server

AI agentidele — Claude, ChatGPT ja iga MCP klient küsivad teie Search Console'i andmetelt vastuseid loomulikus keeles.

Uurige MCP-d

Terminal ja CLI

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

Vaadake CLI-d
Võrrelge kõiki integratsioone

Kes Search Console'i API peale ehitab

Meeskonnad, kes tahavad päris GSC tulemusandmeid oma süsteemidesse.

Agentuurid

Suunake iga kliendi Search Console'i andmed oma portaali, Looker Studiosse või raportluskihti — üks võti, kõik properties, ilma käsitsi GSC eksportideta.

SaaS ja partnerid

Põimige elavad Search Console'i mõõdikud oma toote liidesesse. Andke kasutajatele klõpsud, näitamised ja positsioonid, ilma et peaksite ise Google'i API-d ühendama.

Andmemeeskonnad

Tooge GSC klõpsud, näitamised, CTR ja positsioon ajakava alusel oma lattu. Ühendage need tuluga ja ehitage mudelid, mida teie töölauad vajavad.

Arendajad

Automatiseerige päringute ja lehtede jälgimist, saatke hoiatusi positsioonide langusel ning ühendage Search Console'i andmed rakenduste ja töövoogudega, mida te juba käitate.

Korduma kippuvad küsimused

Kas see on Google'i ametlik Search Console'i API?

Ei. See on SEOcrawl AI enda Bearer-autentimisega REST API nende Search Console'i andmete peal, mille olete juba oma kontoga ühendanud. Ühendate GSC üks kord SEOcrawl AI sees ja loete seejärel klõpse, näitamisi, CTR-i ja positsiooni ühe sca_live_ võtmega — ilma Google Cloud'i projekti, OAuth nõusolekuekraani või loa uuendamiseta. Arvud on teie päris Search Console'i arvud; API ja autentimine on meie omad.

Milliseid Search Console'i andmeid saan täna tõmmata?

Kuupäevavahemiku kogusummad (klõpsud, näitamised, CTR, keskmine positsioon), perioodivõrdlused, parimad päringud ja parimad lehed koos mõõdikutega ning ühe märksõna või ühe lehe täielikud päevadetailid — pluss teie ühendatud properties'te loend. Indekseerimise katvus ja elav URL-i kontroll on juba saadaval MCP kaudu; nende REST lõpp-punktid tulevad järgmisena. Kui eelistate kontot pigem lugeda kui pärida, katab Google Search Console'i audit samad andmed ühe viibaga.

Kuidas ma end autendin?

Bearer-loaga. Looge sca_live_ võti oma töölaualt ja saatke see igas päringus kujul Authorization: Bearer <võti>. Teie enda konto puhul OAuth-tantsu ei ole — ainult päis.

Milliseid kuupäevavahemikke toetatakse?

Iga GSC lõpp-punkt võtab vastu kas range (last_7_days, last_28_days, last_3_months või last_year) või selge from/to paari. Lõpp-punkt gsc/compare tagastab sama akna võrrelduna eelneva perioodiga, nii et saate muutused ilma teise päringuta.

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 see on sama võti ja samad andmed mis MCP-l?

Jah. Sama sca_live_ luba autendib nii REST API kui ka MCP-serveri ning mõlemad loevad ühest kanoonilisest andmekihist — seega on Search Console'i arvud, mille REST-i kaudu saate, identsed nendega, mida teie AI agendid MCP kaudu näevad. Üks mandaat, kaks pinda.

Valmis oma Search Console'i andmete peale ehitama?

Ühendage GSC üks kord, looge töölaualt Bearer-võti ja tehke minutitega esimene Search Console'i REST päring — või uurige MCP-d AI agentide jaoks.

Hankige API võtiLugege API dokumentatsiooniBroneerige demo