Bagaimana cara menggunakan Google Search Console API?

Buat proyek di Google Cloud console, aktifkan Google Search Console API, buat kredensial OAuth 2.0, lalu masuk dengan akun Google yang memiliki akses ke properti tersebut. Setelah itu, Anda dapat mengirim permintaan ke empat resource: Search Analytics untuk klik, impresi, CTR, dan posisi; URL Inspection untuk status indeks; Sitemaps; dan Sites. API key saja tidak cukup: setiap panggilan memerlukan token OAuth, dan kuota membatasi seberapa banyak data yang dapat Anda minta.

Cakupan API dan hal yang tidak tercakup

Hanya itu cakupan API-nya. Tautan, statistik Crawl, laporan Page indexing, dan laporan Core Web Vitals tidak memiliki endpoint, sehingga hanya tersedia di antarmuka Search Console. URL Inspection melaporkan apa yang ada di indeks Google, bukan hasil uji langsung pada halaman.

Menyiapkan akses

1. Di Google Cloud console, buat atau pilih proyek.
2. Aktifkan Google Search Console API untuk proyek tersebut.
3. Konfigurasikan layar persetujuan OAuth dan buat OAuth client ID.
4. Minta scope: https://www.googleapis.com/auth/webmasters.readonly untuk membaca, atau https://www.googleapis.com/auth/webmasters untuk juga dapat mengirim atau menghapus sitemap.
5. Masuk dengan akun yang memiliki izin pada properti tersebut. Membaca data performa memerlukan setidaknya akses baca; API melihat persis apa yang dilihat oleh akun tersebut.

Kueri Search Analytics pertama Anda

POST https://www.googleapis.com/webmasters/v3/sites/sc-domain%3Aexample.com/searchAnalytics/query
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{
  "startDate": "2026-09-01",
  "endDate": "2026-09-30",
  "dimensions": ["query", "page"],
  "type": "web",
  "rowLimit": 25000,
  "startRow": 0
}

Situs ditulis di path dengan encoding URL: sc-domain:example.com untuk properti Domain, atau prefiks persis beserta garis miring di akhir, seperti https://www.example.com/, untuk properti awalan URL. Kolom yang paling penting:

• Tanggal bersifat inklusif dan menggunakan Waktu Pasifik.
• type secara default adalah web; yang lainnya adalah image, video, news, googleNews, dan discover. Masing-masing memerlukan permintaan tersendiri.
• Filter ditulis di dimensionFilterGroups, dengan operator mulai dari equals dan contains hingga includingRegex dan excludingRegex (sintaks RE2).
• rowLimit berkisar dari 1 hingga 25,000 (default 1,000); startRow digunakan untuk menelusuri sisanya.
• dataState secara default adalah final; all menambahkan hari terbaru yang belum final, dan hourly_all berfungsi dengan dimensi hour.

Setiap baris mengembalikan keys, clicks, impressions, ctr (0 hingga 1), dan position, diurutkan berdasarkan klik kecuali jika Anda mengelompokkan berdasarkan tanggal.

Batasan yang memengaruhi kode Anda

• 50,000 baris per hari per jenis penelusuran. Telusuri dengan startRow dalam kelipatan 25,000 dan berhenti saat respons kosong. Untuk mendapatkan data sebanyak mungkin, kueri satu hari sekali jalan.
• Kuota beban. Pengelompokan atau pemfilteran berdasarkan halaman sekaligus kueri adalah permintaan yang paling mahal, dan rentang tanggal yang panjang lebih mahal daripada yang pendek. Jika kuota jangka pendek terlampaui, Google meminta Anda menunggu 15 menit.
• Laju permintaan. 1,200 kueri per menit per situs dan per pengguna; 40,000 per menit dan 30,000,000 per hari per proyek.
• Kuota URL Inspection. 2,000 inspeksi per hari dan 600 per menit untuk setiap properti.
• Riwayat 16 bulan, dan data biasanya tersedia dua hingga tiga hari setelah hari tersebut berakhir.
• Jumlah baris tidak sama dengan total. Kueri yang jarang muncul tidak disertakan dalam baris tingkat kueri, dan pengelompokan berdasarkan halaman menghitung impresi secara berbeda dari pengelompokan berdasarkan properti, jadi ambil total dari permintaan tanpa dimensi kueri.

Kesalahan umum

• Menggunakan http:// padahal propertinya https://, atau tidak menyertakan garis miring di akhir, akan menimbulkan error izin meskipun akun tersebut memiliki akses.
• Meminta URL di luar properti pada URL Inspection akan ditolak: URL harus berada di bawah siteUrl yang Anda kirimkan.
• Data satu bulan yang dikelompokkan berdasarkan kueri dan halaman dalam satu panggilan hanya mengembalikan baris teratas. Permintaan harian mengembalikan lebih banyak.

Bantuan dari AutoPSEO

Jika Anda tidak ingin mengelola OAuth dan paginasi sendiri, AutoPSEO terhubung melalui login Google dan menyediakan data yang sama melalui REST API miliknya di /v1 (dengan dokumen OpenAPI 3.1) dan server MCP, yang diotorisasi dengan API key dari Account → API keys. Tersedia key read-only, endpoint search analytics mengembalikan hingga 5,000 baris per panggilan, dan alat URL Inspection di aplikasi ikut menghitung kuota 2,000 per hari dari Google untuk Anda. Lihat MCP dan API key. Untuk menyimpan data lebih dari 16 bulan tanpa membuat pipeline sendiri, lihat berapa lama Search Console menyimpan data.

Sumber: referensi API Google, metode kueri Search Analytics, batas penggunaan, mengambil semua data Anda, dan panduan otorisasi.