Search Console API · REST v1 · Aktuāla dokumentācija

Google Search Console API jūsu pašu sistēmai

Jūsu Search Console veiktspējas dati caur tīru REST galapunktu.

Velciet klikšķus, parādīšanās reizes, CTR un vidējo pozīciju — pēc vaicājuma, lapas un datumu diapazona — tieši no Google Search Console savā produktā, panelī vai datu noliktavā. Pievienojiet GSC vienreiz SEOcrawl AI iekšienē, izveidojiet Bearer atslēgu savā panelī un izsauciet REST /v1 — Google OAuth jums nav jāveido pašiem. Tas ir tas pats kanoniskais datu slānis, kas darbina SEOcrawl AI MCP, tāpēc skaitļi vienmēr sakrīt. Indeksācijas pārklājums un URL pārbaude REST parādīsies drīzumā; caur MCP tie darbojas jau tagad.

Claude
Codex CLI
Cursor
SEOcrawl AI Google Search Console API — curl pieprasījums un tipizēta JSON atbilde ar klikšķiem, parādīšanās reizēm, CTR un pozīciju.
Google Search Console API pieprasījumu piemēri cURL, JavaScript un Python valodā.

Nosakiet property. Velciet GSC datus.

Izveidojiet Bearer marķieri savā panelī un nododiet to Authorization galvenē. Vienreiz nosakiet Search Console property id un pēc tam vaicājiet tās veiktspēju caur REST. 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

Visas Search Console metrikas, caur REST

Klikšķi, parādīšanās reizes, CTR un vidējā pozīcija — pēc vaicājuma, lapas, datumu diapazona un periodu salīdzinājuma. Katrs galapunkts ir piesaistīts property: vispirms nosakiet property id, pēc tam lasiet tās Search Console datus. Šīs GSC grupas jau ir aktīvas v1; indeksācijas pārklājumu un URL pārbaudi šodien atklāj MCP, bet REST galapunkti seko nākamie.

Properties

Uzskaitiet jūsu kontam pievienotās Search Console properties. Katras property id izmantojiet ikviena GSC galapunkta ceļā.

  • GET/v1/propertiesAktīvs

Veiktspēja

Kopējie klikšķi, parādīšanās reizes, CTR un vidējā pozīcija izvēlētajam datumu diapazonam — plus tā paša loga izmaiņas pret iepriekšējo periodu.

  • GET/v1/properties/{id}/gsc/summaryAktīvs
  • GET/v1/properties/{id}/gsc/compareAktīvs

Vaicājumi

Meklēšanas vaicājumi, pēc kuriem jūs atrod, ar metrikām katram vaicājumam — un pilna dienas vēsture jebkuram atslēgvārdam.

  • GET/v1/properties/{id}/gsc/top-keywordsAktīvs
  • GET/v1/properties/{id}/gsc/keywords/detailAktīvs

Lapas

Jūsu veiksmīgākie URL ar Search Console metrikām — un pilns dienas veiktspējas sadalījums jebkurai atsevišķai lapai.

  • GET/v1/properties/{id}/gsc/top-pagesAktīvs
  • GET/v1/properties/{id}/gsc/pages/detailAktīvs

Indeksācijas pārklājums

Ko Google patiesībā indeksē: pārklājuma statusi un indeksācijas vēsture. Šodien aktīvs MCP; REST galapunkti tiek ieviesti.

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

URL pārbaude

Pārbaude URL pa URL — atsevišķas lapas pārklājums, pēdējā pārmeklēšana un indeksācijas statuss. Jau pieejama caur MCP; REST seko nākamais.

  • GET/v1/properties/{id}/url-inspectionDrīzumā

Īsti Search Console dati, veidoti produktiem

Jūsu patiesā Google Search Console veiktspēja — nevis trešo pušu aplēses — caur tīru REST API ar Bearer autentifikāciju un pieprasījumu limitiem, daloties vienā kanoniskajā datu slānī ar MCP, lai skaitļi nekad nebūtu pretrunīgi.

Tieši no Search Console

Klikšķi, parādīšanās reizes, CTR un vidējā pozīcija, kas ņemti no jūsu pašu GSC property — īstie Google ziņotie skaitļi, nevis modelētas vai skrāpētas aplēses. Paredzami resursi, standarta darbības vārdi, tipizēts JSON un RFC atbilstošas kļūdas.

Nav jāveido Google OAuth

Pievienojiet Search Console vienreiz SEOcrawl AI iekšienē un lasiet to ar vienu sca_live_ Bearer atslēgu. Izlaidiet Google Cloud projektu, piekrišanas ekrānu un marķieru atjaunošanu — atslēgas izveidojat un atsaucat savā panelī dažu sekunžu laikā.

Viens kanoniskais datu slānis

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

Detalizācija līdz vaicājumam un lapai

Lasiet property kopsummas vai ejiet dziļāk: populārākie vaicājumi, populārākās lapas, viena atslēgvārda dienas tendence vai viena URL vēsture — tie paši griezumi, ko redzat Search Console, pieejami caur HTTP.

Periodu salīdzinājums jau iekļauts

Norādiet range (last_7_days, last_28_days, last_3_months, last_year) vai skaidrus from/to datumus un saņemiet periodu salīdzinājumu uzreiz — bez otra izsaukuma un bez datumu rēķiniem klienta pusē, lai saskaņotu izmaiņas.

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.

Sāciet 3 soļos

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

1

Izveidojiet atslēgu

Pievienojiet Search Console SEOcrawl AI iekšienē, atveriet API marķierus un ģenerējiet Bearer marķieri. Nokopējiet to vienreiz — tas sākas ar sca_live_.

2

Nosakiet property

Izsauciet GET /v1/properties ar Authorization: Bearer sca_live_…, lai iegūtu tās Search Console property id (UUID), kuru vēlaties lasīt.

3

Velciet GSC datus

Vērsieties pie /v1/properties/{id}/gsc/summary?range=last_28_days pēc kopsummām vai pie /gsc/top-keywords, /gsc/top-pages un /detail galapunktiem — un novirziet JSON tieši savā produktā, panelī vai noliktavā.

Trīs veidi, kā sasniegt savus Search Console datus

Tie paši GSC 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ā — pilnā SEO API ar to pašu atslēgu pievieno pozīciju un AI redzamības galapunktus.

MCP serveris

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

Izpētiet MCP

Terminālis un CLI

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

Skatīt CLI

Kas veido uz Search Console API

Komandas, kas vēlas īstus GSC veiktspējas datus savās pašu sistēmās.

Aģentūras

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

SaaS un partneri

Iegultiet dzīvas Search Console metrikas sava produkta saskarnē. Sniedziet lietotājiem klikšķus, parādīšanās reizes un pozīcijas, paši neveidojot Google API integrāciju.

Datu komandas

Ievietojiet GSC klikšķus, parādīšanās reizes, CTR un pozīciju 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 vaicājumu un lapu uzraudzību, saņemiet brīdinājumus par pozīciju kritumiem un integrējiet Search Console datus lietotnēs un darbplūsmās, kuras jau piegādājat.

Bieži uzdotie jautājumi

Vai šī ir oficiālā Google Search Console API?

Nē. Šī ir SEOcrawl AI pašu Bearer autentificētā REST API virs tiem Search Console datiem, kurus jūs jau esat pievienojis savam kontam. GSC pievienojat vienreiz SEOcrawl AI iekšienē un pēc tam lasāt klikšķus, parādīšanās reizes, CTR un pozīciju ar vienu tīru sca_live_ atslēgu — paši neveidojot Google Cloud projektu, OAuth piekrišanas ekrānu vai marķieru atjaunošanu. Skaitļi ir jūsu īstie Search Console skaitļi; API un autentifikācija ir mūsu.

Kādus Search Console datus varu vilkt šodien?

Kopsummas par datumu diapazonu (klikšķi, parādīšanās reizes, CTR, vidējā pozīcija), periodu salīdzinājumus, jūsu populārākos vaicājumus un lapas ar metrikām, kā arī pilnas dienas detaļas atsevišķam atslēgvārdam vai lapai — plus jūsu pievienoto properties sarakstu. Indeksācijas pārklājums un dzīvā URL pārbaude jau ir pieejami caur MCP; to REST galapunkti seko nākamie. Bet, ja labprātāk kontu izlasītu, nevis vaicātu, Google Search Console audits aptver tos pašus datus vienā uzvednē.

Kā autentificēties?

Ar Bearer marķieri. Izveidojiet sca_live_ atslēgu savā panelī un sūtiet to kā Authorization: Bearer <key> katrā pieprasījumā. Savam kontam nav nekādas OAuth dejas — tikai galvene.

Kādi datumu diapazoni tiek atbalstīti?

Katrs GSC galapunkts pieņem vai nu range (last_7_days, last_28_days, last_3_months vai last_year), vai skaidru from/to pāri. Galapunkts gsc/compare atgriež to pašu logu, salīdzinātu ar iepriekšējo periodu, tāpēc izmaiņas saņemat bez otra izsaukuma.

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 tā ir tā pati atslēga un tie paši dati kā MCP?

Jā. Tas pats sca_live_ marķieris autentificē gan REST API, gan MCP serveri, un abi nolasa no viena kanoniskā datu slāņa — tāpēc Search Console skaitļi, ko velkat caur REST, ir identiski tiem, ko caur MCP redz jūsu AI aģenti. Viens akreditācijas dati, divas virsmas.

Gatavi veidot uz saviem Search Console datiem?

Pievienojiet GSC vienreiz, izveidojiet Bearer atslēgu savā panelī un veiciet savu pirmo REST izsaukumu uz Search Console dažu minūšu laikā — vai izpētiet MCP saviem AI aģentiem.