Search Console API · REST v1 · Dokumentasi live

Google Search Console API untuk stack Anda sendiri

Data performa Search Console Anda, lewat endpoint REST yang rapi.

Tarik klik, impresi, CTR, dan posisi rata-rata — per kueri, halaman, dan rentang tanggal — langsung dari Google Search Console ke produk, dasbor, atau data warehouse Anda. Hubungkan GSC sekali di dalam SEOcrawl AI, buat Bearer key dari dasbor Anda, lalu panggil REST /v1 — tanpa perlu membangun OAuth Google sendiri. Ini lapisan data kanonis yang sama yang menggerakkan SEOcrawl AI MCP, jadi angka Anda selalu cocok. Cakupan indeks dan URL Inspection menyusul di REST; lewat MCP keduanya sudah tersedia.

Claude
Codex CLI
Cursor
Google Search Console API dari SEOcrawl AI — sebuah permintaan curl dan respons JSON bertipe berisi klik, impresi, CTR, dan posisi.
Contoh permintaan Google Search Console API dalam cURL, JavaScript, dan Python.

Ambil satu properti. Tarik data GSC.

Buat token Bearer dari dasbor Anda dan sertakan di header Authorization. Ambil id properti Search Console sekali saja, lalu kueri performanya lewat REST. Key yang sama berlaku baik untuk REST API maupun server MCP.

Base URL

https://api.seocrawl.ai/v1

Header Authorization

Authorization: Bearer sca_live_your_token_here

Semua metrik Search Console, lewat REST

Klik, impresi, CTR, dan posisi rata-rata — per kueri, halaman, rentang tanggal, dan perbandingan antarperiode. Setiap endpoint terikat pada satu properti: ambil id properti dulu, baru baca data Search Console-nya. Grup GSC ini sudah live di v1; cakupan indeks dan URL Inspection hari ini tersedia lewat MCP dan menyusul di REST.

Properti

Cantumkan properti Search Console yang terhubung ke akun Anda. Gunakan id setiap properti di path semua endpoint GSC.

  • GET/v1/propertiesLive

Performa

Total klik, impresi, CTR, dan posisi rata-rata untuk satu rentang tanggal — plus selisih terhadap periode sebelumnya untuk jendela waktu yang sama.

  • GET/v1/properties/{id}/gsc/summaryLive
  • GET/v1/properties/{id}/gsc/compareLive

Kueri

Kueri penelusuran tempat Anda muncul, lengkap dengan metrik per kueri — dan riwayat harian penuh untuk satu keyword mana pun.

  • GET/v1/properties/{id}/gsc/top-keywordsLive
  • GET/v1/properties/{id}/gsc/keywords/detailLive

Halaman

URL dengan performa terbaik beserta metrik Search Console-nya — dan rincian performa harian penuh untuk satu halaman mana pun.

  • GET/v1/properties/{id}/gsc/top-pagesLive
  • GET/v1/properties/{id}/gsc/pages/detailLive

Cakupan indeks

Apa yang benar-benar diindeks Google: status cakupan dan riwayat indeksasi. Hari ini sudah live di MCP; endpoint REST sedang digulirkan.

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

URL Inspection

Inspeksi per URL — cakupan, perayapan terakhir, dan status indeks satu halaman. Sudah tersedia lewat MCP; REST menyusul.

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

Data Search Console asli, dibangun untuk produk

Performa Google Search Console Anda yang sebenarnya — bukan estimasi pihak ketiga — lewat REST API yang rapi dengan autentikasi Bearer dan batas permintaan, berbagi satu lapisan data kanonis dengan MCP supaya angkanya tidak pernah berbeda.

Langsung dari Search Console

Klik, impresi, CTR, dan posisi rata-rata ditarik dari properti GSC Anda sendiri — angka asli yang dilaporkan Google, bukan estimasi model atau hasil scraping. Resource yang mudah ditebak, verb standar, JSON bertipe, dan error yang patuh RFC.

Tanpa membangun OAuth Google

Hubungkan Search Console sekali di dalam SEOcrawl AI, lalu bacalah dengan satu Bearer key sca_live_. Lewati proyek Google Cloud, layar persetujuan, dan refresh token — buat dan cabut key dari dasbor Anda dalam hitungan detik.

Satu lapisan data kanonis

Endpoint REST GSC dan tool GSC di MCP adalah saudara kandung di atas provider yang sama, dengan paritas yang diuji di CI. Dasbor Anda dan agen AI Anda selalu melihat klik, impresi, dan posisi yang identik.

Granularitas per kueri dan per halaman

Baca total satu properti, atau turun ke detail: kueri teratas, halaman teratas, tren harian satu keyword, atau riwayat satu URL — dimensi yang sama seperti di Search Console, dapat diakses lewat HTTP.

Perbandingan antarperiode bawaan

Minta satu range (last_7_days, last_28_days, last_3_months, last_year) atau tanggal from/to eksplisit, dan perbandingan antarperiode langsung ikut — tanpa panggilan kedua dan tanpa hitung-hitungan tanggal di sisi klien untuk mencocokkan selisih.

Batas permintaan yang terdokumentasi

60 permintaan per menit dan 1.000 per jam per token, dengan respons 429 + Retry-After yang jelas. Kuota REST terpisah dari pemakaian MCP — yang satu tidak pernah menghabiskan jatah yang lain.

Mulai dalam 3 langkah

Dari nol sampai panggilan Search Console pertama Anda dalam beberapa menit.

1

Buat key

Hubungkan Search Console di SEOcrawl AI, buka Token API dan buat token Bearer. Salin sekali saja — token itu diawali sca_live_.

2

Ambil satu properti

Panggil GET /v1/properties dengan Authorization: Bearer sca_live_… untuk mendapatkan id (berupa UUID) properti Search Console yang ingin Anda baca.

3

Tarik data GSC

Panggil /v1/properties/{id}/gsc/summary?range=last_28_days untuk total, atau /gsc/top-keywords, /gsc/top-pages, dan endpoint /detail — lalu alirkan JSON-nya langsung ke produk, dasbor, atau warehouse Anda.

Tiga cara menjangkau data Search Console Anda

Angka GSC yang sama, permukaan berbeda — pilih yang paling cocok dengan cara Anda membangun.

REST API

Untuk produk, dasbor, dan pipeline data. Autentikasi Bearer, JSON bertipe, batas permintaan. Anda sedang di halaman ini — SEO API lengkap menambahkan endpoint peringkat dan visibilitas AI dengan key yang sama.

Server MCP

Untuk agen AI — Claude, ChatGPT, dan klien MCP mana pun bisa menanyai data Search Console Anda dalam bahasa alami.

Jelajahi MCP

Terminal & CLI

Untuk skrip dan CI/CD — kendalikan data GSC Anda dari agen terminal mana pun yang mendukung MCP.

Lihat CLI

Siapa yang membangun dengan Search Console API

Tim yang ingin data performa GSC asli ada di dalam sistem mereka sendiri.

Agensi

Alirkan data Search Console setiap klien ke portal buatan sendiri, Looker Studio, atau lapisan reporting Anda — satu key, semua properti, tanpa ekspor GSC manual.

SaaS & mitra

Tanamkan metrik Search Console live ke dalam UI produk Anda sendiri. Beri pengguna Anda klik, impresi, dan posisi tanpa perlu merangkai API Google sendiri.

Tim data

Daratkan klik, impresi, CTR, dan posisi GSC ke warehouse Anda secara terjadwal. Gabungkan dengan data pendapatan dan bangun model yang dibutuhkan dasbor Anda.

Developer

Otomatiskan pemantauan kueri dan halaman, beri peringatan saat peringkat turun, dan sambungkan data Search Console ke aplikasi serta alur kerja yang sudah Anda jalankan.

Pertanyaan yang sering diajukan

Apakah ini API Search Console resmi dari Google?

Bukan. Ini REST API milik SEOcrawl AI sendiri, dengan autentikasi Bearer, di atas data Search Console yang sudah Anda hubungkan ke akun Anda. Anda menghubungkan GSC sekali di dalam SEOcrawl AI, lalu membaca klik, impresi, CTR, dan posisi lewat satu key sca_live_ — tanpa membuat proyek Google Cloud, layar persetujuan OAuth, atau mekanisme refresh token sendiri. Angkanya adalah angka Search Console Anda yang sebenarnya; API dan autentikasinya milik kami.

Data Search Console apa saja yang bisa saya tarik hari ini?

Total untuk satu rentang tanggal (klik, impresi, CTR, posisi rata-rata), perbandingan antarperiode, kueri teratas dan halaman teratas beserta metriknya, serta detail harian penuh untuk satu keyword atau satu halaman — plus daftar properti yang terhubung. Cakupan indeks dan URL Inspection langsung sudah tersedia lewat MCP; endpoint REST-nya menyusul. Kalau Anda lebih suka membaca akunnya ketimbang mengueri, audit Google Search Console mencakup data yang sama dalam satu prompt.

Bagaimana cara autentikasinya?

Dengan token Bearer. Buat key sca_live_ dari dasbor Anda dan kirim sebagai Authorization: Bearer <key> di setiap permintaan. Untuk akun Anda sendiri tidak ada ritual OAuth — cukup header itu.

Rentang tanggal apa saja yang didukung?

Setiap endpoint GSC menerima salah satu dari range (last_7_days, last_28_days, last_3_months, atau last_year) atau pasangan from/to eksplisit. Endpoint gsc/compare mengembalikan jendela waktu yang sama dibandingkan dengan periode sebelumnya, jadi Anda mendapat selisihnya tanpa panggilan kedua.

Berapa batas permintaannya?

60 permintaan per menit dan 1.000 per jam per token. Jika terlampaui, Anda menerima 429 dengan header Retry-After. Batas REST dihitung terpisah dari pemakaian MCP, jadi keduanya tidak pernah berebut kuota yang sama.

Apakah key dan datanya sama dengan MCP?

Ya. Token sca_live_ yang sama mengautentikasi REST API dan server MCP, dan keduanya membaca dari satu lapisan data kanonis — jadi angka Search Console yang Anda tarik lewat REST identik dengan yang dilihat agen AI Anda lewat MCP. Satu kredensial, dua permukaan.

Siap membangun di atas data Search Console Anda?

Hubungkan GSC sekali, buat Bearer key dari dasbor Anda, dan lakukan panggilan REST Search Console pertama Anda dalam hitungan menit — atau jelajahi MCP untuk agen AI.