API Peringkat Google: Apa yang Sebenarnya Dikembalikan dan Apa yang Ditolak

Poin utama

Google tidak menerbitkan endpoint yang mengembalikan peringkat Anda. Kami mengukur apa yang sebenarnya dikembalikan API-nya: data yang berumur tiga hari, posisi rata-rata yang berbeda dari hasil SERP langsung sebesar 7,4 posisi pada median, dan vonis yang menyatakan NEUTRAL untuk URL yang belum pernah dilihat Google.

Tim yang mencari API peringkat Google biasanya menginginkan satu hal spesifik: panggilan yang mengembalikan di posisi berapa sebuah halaman berada untuk sebuah kata kunci. Google tidak menerbitkan itu.

Yang diterbitkan Google adalah sekumpulan API yang mendeskripsikan performa Anda sendiri, status indeks Anda sendiri, dan situasi perayapan Anda sendiri. Semuanya benar-benar berguna, dan semuanya gratis. Semuanya juga secara struktural tidak mampu menjawab pertanyaan yang dibawa sebagian besar orang ke pencarian ini.

Kami menghabiskan satu hari mengukur apa yang sebenarnya dikembalikan API tersebut pada properti yang aktif, termasuk bagian yang mudah salah dibaca. Tiga temuan menonjol: datanya datang terlambat tiga hari, angka posisinya adalah rata-rata yang tidak dapat direproduksi terhadap hasil langsung, dan satu API yang paling terdengar seperti pemeriksaan peringkat mengembalikan vonis yang tidak mengatakan apa pun yang berguna jika berdiri sendiri.

Apa yang sebenarnya diterbitkan Google

Empat permukaan sering tertukar dengan API peringkat. Berikut kegunaan masing-masing, menurut dokumentasi Google sendiri.

Search Analytics API mengembalikan klik, tayangan, CTR, dan posisi rata-rata untuk properti yang terverifikasi. Ini hal terdekat dengan data peringkat yang ditawarkan Google, dan ini sumber setiap angka "posisi rata-rata" di Search Console.

URL Inspection API mengembalikan status indeks untuk satu URL: apakah Google mengetahuinya, apakah sudah terindeks, dan jika belum, mengapa.

Indexing API terdengar seperti mengirimkan halaman untuk diindeks. Dokumentasi Google membatasi tipe yang didukung pada data terstruktur JobPosting dan BroadcastEvent, yang merupakan kasus penggunaan sempit, bukan pengiriman indeks secara umum.

Custom Search JSON API mengembalikan hasil web untuk sebuah kueri. Ia menelusuri indeks yang Anda konfigurasikan sendiri, dan tidak memberi tahu Anda di posisi berapa situs Anda berada di hasil utama Google.

Tidak satu pun mengembalikan "peringkat Anda untuk kata kunci ini". Pekerjaan itu tidak ada dalam lini produk Google, dan ketiadaannya disengaja, bukan kelalaian. Google tidak punya alasan komersial untuk membagikan data peringkat pesaing dalam skala besar.

Yang kami ukur: datanya berumur tiga hari

Kami menarik rincian harian untuk properti kami sendiri pada 12 September 2026. Tanggal terbaru yang masih memiliki data adalah 9 September.

Tanggal tersedia

Baris yang dikembalikan

2026-09-02

ada

2026-09-03

ada

2026-09-04

ada

2026-09-05

ada

2026-09-06

ada

2026-09-07

ada

2026-09-08

ada

2026-09-09

ada, terbaru

Keterlambatan tiga hari, secara konsisten. Parameter window menghitung mundur dari tanggal tersedia terbaru, bukan dari hari ini, dan itu jebakan kecil: permintaan tujuh hari mengembalikan delapan tanggal yang berakhir pada 9 September, bukan 12 September.

Untuk laporan bulanan ini tidak relevan. Untuk pertanyaan "apakah perubahan halaman saya kemarin merusak sesuatu", ini mendiskualifikasi. Tidak ada konfigurasi yang memperbaikinya. Keterlambatannya ada di sisi Google.

Yang kami ukur: posisi rata-rata bukan peringkat

Ini temuan yang lebih penting, dan inilah yang membuat orang percaya bahwa API peringkat Google itu ada dan hanya bersikap evasif.

Posisi rata-rata adalah posisi rata-rata URL Anda di seluruh tayangan pada periode itu, ditimbang menurut negara, perangkat, dan varian kueri. Pemeriksaan peringkat langsung mengembalikan satu angka, dari satu lokasi, pada satu perangkat, pada satu momen. Keduanya adalah pengukuran berbeda yang berbagi satu nama.

Kami menguji selisihnya pada 25 kueri yang diambil dari data Search Console kami sendiri, lalu memeriksa 25 kata kunci yang sama terhadap SERP langsung Amerika Serikat, bahasa Inggris, desktop, pada kedalaman 100.

Hasil

Jumlah

Kueri yang bisa dipakai di kedua himpunan

23

Muncul di 100 teratas langsung

14 (61%)

Punya tayangan Search Console tetapi tidak ada hasil langsung yang dapat direproduksi

9 (39%)

Median selisih absolut saat keduanya ada

7,4 posisi

Rata-rata selisih absolut

8,5 posisi

Selisih terbesar

36,6 posisi

Berada dalam 3 posisi satu sama lain

4 dari 14

Berselisih lebih dari 10 posisi

4 dari 14

Perbandingan posisi rata-rata di Search Console dengan posisi di SERP langsung untuk 14 kueri, dengan median selisih 7,4 posisi

Di tempat kedua pengukuran itu ada, keduanya berselisih pada median 7,4 posisi.

Ada dua detail yang lebih penting daripada nilai rata-ratanya.

Pertama, sembilan dari 23 kueri menghasilkan posisi Search Console tetapi sama sekali tidak ada hasil langsung dalam pemeriksaan Amerika Serikat, bahasa Inggris, desktop. Ini bukan bug. Tayangan menumpuk dari negara lain, bahasa lain, perangkat lain, serta permukaan gambar dan video. Satu pemeriksaan yang terkunci pada satu geografi tidak akan mereproduksinya, dan tim yang memperlakukan kedua angka itu sebagai pengukuran yang sama akan menghabiskan sepekan mengejar selisih yang sebenarnya artefak dari metodenya.

Kedua, arahnya tidak konsisten. Sebagian besar posisi langsung berada di bawah rata-rata Search Console, yang memang diharapkan ketika rata-rata mencakup permukaan berperforma lebih baik. Tetapi satu kueri bergerak 36,6 posisi ke arah sebaliknya, dari 73,6 menjadi 37. Tidak ada faktor koreksi yang bisa diterapkan.

Selisih per kueri antara posisi di SERP langsung dan posisi rata-rata di Search Console untuk 14 kueri, dari 36,6 posisi di atas hingga 13,8 di bawah

Selisihnya bergerak ke dua arah, jadi tidak ada faktor koreksi yang bisa diterapkan.

Konsekuensi praktisnya bagi siapa pun yang sedang memilih API peringkat Google: data gratis tidak akan memberi tahu peringkat, dan data berbayar tidak akan sepakat dengannya. Keduanya mengukur hal berbeda dengan benar. Memperlakukan salah satunya sebagai pengganti yang lain adalah titik tempat pelaporan mulai salah.

Tempat sisi data pihak pertama benar-benar tak tergantikan adalah cakupan, yang kami ukur secara terpisah di perbandingan alternatif API SERP.

Apa yang dikembalikan URL Inspection API sebagai gantinya

URL Inspection API adalah satu-satunya permukaan Google yang terasa seperti pemeriksaan peringkat, karena Anda memberinya URL tanpa kata kunci dan menerima status kembali. Kami menguji dua URL.

Keadaan URL

Vonis

Status cakupan

Waktu perayapan terakhir

Diterbitkan sekitar satu jam sebelumnya

NEUTRAL

URL tidak dikenal Google

Tidak diketahui

Diterbitkan sekitar sembilan jam sebelumnya

NEUTRAL

Ditemukan, saat ini tidak terindeks

Tidak diketahui

Keduanya mengembalikan vonis yang sama. Bidang yang benar-benar membedakan kedua kasus itu adalah string status cakupan, yang berupa kalimat, bukan enum. Bidang vonis menyatakan NEUTRAL baik untuk URL yang belum pernah dilihat Google maupun untuk URL yang sudah ditemukan tetapi belum diindeks.

Ini API yang bisa dipakai dan sinyal pemantauan yang buruk jika berdiri sendiri. Jika Anda ingin peringatan ketika sebuah halaman tidak terindeks, uraikan status cakupan, bukan vonisnya, dan perkirakan waktu perayapan terakhir akan absen justru pada URL yang paling Anda pedulikan.

Empat permukaan, dan pekerjaan yang tidak dilakukan satu pun

Pertanyaan

Permukaan Google

Jawaban

Bagaimana performa saya untuk kueri ini pekan lalu

Search Analytics API

Ya, terlambat tiga hari, dirata-ratakan

Apakah URL ini terindeks

URL Inspection API

Ya, per URL, atas permintaan

Di posisi berapa saya sekarang untuk kata kunci apa pun

tidak ada

Tidak

Di posisi berapa pesaing saya

tidak ada

Tidak

Seperti apa SERP untuk kata kunci yang belum saya peringkat

tidak ada

Tidak

Polanya konsisten. API Google mendeskripsikan properti Anda dari dalam. Pertanyaan peringkat diajukan dari luar, tentang halaman hasil, dan Google tidak menyediakan itu.

Cara menutup celah tanpa membayar berlebih

Susunan praktisnya adalah dua sumber dengan tugas berbeda, bukan satu sumber yang diminta melakukan keduanya.

Gunakan API Google sebagai kebenaran dasar tentang properti Anda sendiri. Klik, tayangan, dan status indeks adalah fakta pihak pertama yang tidak bisa Anda dapatkan di tempat lain, dan gratis. Tarik sesuai jadwal dan perlakukan keterlambatan tiga hari sebagai sifat alat ukurnya.

Gunakan sumber SERP untuk pandangan dari luar. Posisi langsung, posisi pesaing, dan kata kunci yang belum Anda peringkat. Ini bagian yang berbayar, dan lebih murah daripada yang diasumsikan sebagian besar tim: dalam pengujian kami, memeriksa 23 kata kunci pada kedalaman 100 memakan biaya $0,2975, yaitu $0,0129 per pemeriksaan.

Jangan mencoba menyelaraskan kedua angka itu. Keduanya mengukur hal yang berbeda. Langkah yang berguna adalah membacanya bersama: Search Console memberi tahu apa yang terjadi, dan pemeriksaan langsung memberi tahu apa yang sedang terjadi. Ketika keduanya berselisih, lihat komposisi negara dan perangkat untuk kueri itu sebelum menyimpulkan apa pun.

Mekanisme menjalankan keduanya dari satu skrip ada di pembuatan pelacak dua sumber kami, dan sisi biaya dari separuh langsungnya dihitung di uji pemeriksaan massal.

Pertanyaan umum

Apakah Google punya API peringkat resmi? Tidak. Google menerbitkan API untuk performa pencarian Anda sendiri (Search Analytics), status indeks (URL Inspection), dan dua tipe pengiriman yang sempit (Indexing). Tidak satu pun mengembalikan peringkat untuk sebuah kata kunci.

Mengapa Search Console menampilkan posisi kalau tidak ada API peringkat? Karena posisi rata-rata adalah metrik performa yang dihitung dari tayangan Anda, bukan pencarian peringkat. Itu posisi rata-rata di seluruh tayangan pada periode tersebut, dirata-ratakan lintas negara, perangkat, dan permukaan.

Seberapa jauh data Search Console tertinggal? Tiga hari dalam pengukuran kami pada 12 September 2026, dengan tanggal tersedia terbaru adalah 9 September. Parameter window menghitung mundur dari tanggal itu, jadi permintaan tujuh hari mengembalikan delapan tanggal yang berakhir pada hari tersedia terbaru.

Bisakah URL Inspection API memberi tahu apakah sebuah halaman terindeks? Bisa, dan itu alat yang tepat untuk pekerjaan tersebut. Bacalah string status cakupan, bukan bidang vonis, karena vonis mengembalikan NEUTRAL baik untuk URL yang tidak dikenal maupun URL yang sudah ditemukan tetapi belum terindeks.

Apakah Custom Search JSON API adalah API peringkat? Bukan. Ia mengembalikan hasil dari mesin pencari yang Anda konfigurasikan sendiri, bukan posisi Anda di hasil utama Google.

Apa cara termurah mendapatkan data peringkat yang nyata? Periksa kumpulan kata kunci terkecil yang benar-benar Anda tindak lanjuti, pada kedalaman yang sesuai dengan posisi Anda. Pemeriksaan kedalaman 10 memakan biaya $0,002 per kata kunci dalam pengujian kami dan kedalaman 100 memakan biaya $0,014, jadi pengaturan kedalaman menggerakkan tagihan tujuh kali lebih besar daripada jumlah kata kunci.

Pandangan Auspia: jawaban jujur atas "apakah ada API peringkat Google" adalah tidak, dan langkah lanjutan yang berguna adalah berhenti mencarinya. API Google menjawab pertanyaan pihak pertama dengan baik dan sama sekali tidak bisa menjawab pertanyaan peringkat. Sisihkan anggaran kecil untuk pandangan dari luar, dan gunakan sisa upayanya pada bagian yang tidak akan Google lakukan untuk Anda, yaitu memutuskan apa yang harus diubah ketika kedua angka itu berselisih.

Penulis: Gabriel Finch, peneliti pengambilan pencarian, dengan peninjauan lebih dari 1.200 jawaban AI di Auspia. Menulis tentang infrastruktur pencarian, sistem pengambilan, dan apa yang sebenarnya bisa dilihat setiap sumber data.

Jelajahi topik ini

Lanjutkan alur pertumbuhan yang sama