Google tidak punya API peringkat langsung. Berikut yang sebenarnya dikembalikan Search Console API, mengapa Custom Search menyesatkan, dan kode Python yang berfungsi untuk setiap jalur.

Singkatnya
Google tidak menerbitkan API yang mengembalikan peringkat kata kunci secara langsung. Search Console API mengembalikan posisi rata-rata untuk kueri yang sudah diperingkatkan oleh situs Anda sendiri yang terverifikasi, gratis, data pihak pertama, tetapi terbatas pada properti Anda dan dirata-ratakan dari waktu ke waktu. Custom Search JSON API mengembalikan hasil dari mesin kustom, bukan dari google.com, sehingga posisinya tidak sama dengan yang dilihat pengguna. Untuk posisi SERP langsung yang sebenarnya, termasuk pesaing, Anda memerlukan SERP API pihak ketiga. Panduan ini menunjukkan kode yang berfungsi untuk masing-masing dan di mana masing-masing mengalami kegagalan.
Ingin tahu lebih banyak? Tanyakan kepada
Mencoba memeriksa posisi kata kunci menggunakan Google API adalah salah satu tugas yang tampak seperti masalah yang sudah terpecahkan sampai Anda benar-benar mencobanya. Tidak ada endpoint rankings.get(), dan dua Google API yang pertama kali dituju orang masing-masing menjawab pertanyaan yang sedikit berbeda dari yang diajukan. Dokumentasi Search Analytics Search Console adalah tempat yang tepat untuk memulai, asalkan Anda memahami arti "posisi" di sana.
Tidak. Google belum pernah merilis API yang menerima kata kunci dan mengembalikan posisi langsung Anda di google.com. Ini disengaja: kueri otomatis ke halaman hasil pencarian dilarang oleh ketentuan Google, dan perusahaan tidak punya kepentingan komersial untuk menyediakan infrastruktur pelacakan peringkat.
Yang ada adalah tiga jalur parsial, masing-masing dengan batas yang tegas:
| Jalur | Mengembalikan | Mencakup pesaing? | Biaya |
|---|---|---|---|
| Search Console API | Posisi rata-rata, hanya situs Anda | Tidak | Gratis |
| Custom Search JSON API | Hasil dari mesin kustom | Ya, tetapi bukan SERP asli | 100 kueri/hari gratis |
| SERP API pihak ketiga | Posisi SERP langsung dan tepat | Ya | Berbayar, per kueri |
Kueri endpoint searchAnalytics dengan dimensi query dan baca kolom position. Ini data pihak pertama langsung dari Google, gratis, dan tanpa batas kata kunci, Anda mendapatkan setiap kueri yang membuat situs Anda memperoleh impresi.
Permintaan yang berfungsi, dalam Python:
from google.oauth2 import service_account
from googleapiclient.discovery import build
creds = service_account.Credentials.from_service_account_file(
"service-account.json",
scopes=["https://www.googleapis.com/auth/webmasters.readonly"],
)
service = build("searchconsole", "v1", credentials=creds)
response = service.searchanalytics().query(
siteUrl="https://example.com/",
body={
"startDate": "2026-07-01",
"endDate": "2026-07-31",
"dimensions": ["query", "page"],
"rowLimit": 25000,
},
).execute()
for row in response.get("rows", []):
query, page = row["keys"]
print(f"{row['position']:.1f} {query} -> {page}")
Poin ketiga itulah yang diam-diam merusak pelaporan. Kata kunci yang belum berhasil Anda tembus ke halaman-halaman pertama sama sekali tidak ada di Search Console, sehingga mustahil mengukur kemajuan dari posisi 60 ke posisi 20 hanya dengan API ini.
Secara teknis bisa, secara bermakna tidak. Custom Search JSON API mengharuskan Anda membuat Programmable Search Engine terlebih dahulu. Bahkan ketika dikonfigurasi untuk mencari di seluruh web, ia menerapkan pemeringkatan dan batasannya sendiri, sehingga urutan yang dikembalikannya bukan urutan yang dikembalikan google.com.
API ini juga dibatasi 100 kueri per hari pada tingkat gratis, dengan penggunaan berbayar ditagih per seribu kueri dan batas harian. Untuk beberapa kata kunci yang diperiksa sesekali, cara ini masih dapat dipakai. Sebagai pelacak peringkat, ia menghasilkan angka yang tampak meyakinkan dan diam-diam salah, yang lebih buruk daripada tidak punya data.
Jangan. Kueri otomatis ke Google Search tanpa izin bertentangan dengan Ketentuan Layanan Google, dan pada volume berapa pun akan mengundang pemblokiran IP dan tembok CAPTCHA. Di luar soal kebijakan, kenyataan teknisnya tidak menyenangkan: hasil dipersonalisasi, dilokalkan, dan makin banyak disusun dengan fitur AI, sehingga "posisi" hasil scraping bervariasi menurut pusat data, lokasi, dan sesi bahkan ketika tidak ada yang berubah pada situs Anda.
Jika Anda membutuhkan posisi pesaing, SERP API komersial adalah jalur yang sah berdasarkan perjanjian penyedianya sendiri dan stabil secara operasional. Ini adalah pos biaya berbayar, dan biaya itu adalah harga jujur untuk data yang tidak dibagikan Google secara cuma-cuma. Bisnis yang membutuhkan pipeline ini dibangun dan dipantau tanpa merekrut tenaga internal biasanya menggunakan spesialis; perbandingan kami tentang 10 agensi analitik data terbaik di Prancis mencantumkan penyedia yang menyiapkan pelaporan semacam ini.

Bagi sebagian besar tim, arsitektur yang pragmatis adalah hibrida, dan bentuknya seperti ini:
Tim yang tidak ingin merancang ini sendiri biasanya menyerahkannya kepada spesialis; perbandingan kami tentang 10 agensi SEO terbaik di Prancis memprofilkan penyedia yang mengelola tumpukan pelaporan ini untuk klien.
Poin terakhir itu bukan kekhawatiran masa depan. Ketika jawaban AI menyelesaikan kueri di dalam antarmuka, posisi sepuluh dan posisi tiga bertemu pada hasil yang sama, tanpa klik. Melacak kutipan bersama posisi adalah tujuan server MCP Search Console dan platform visibilitas AI kami, dan dokumentasi membahas pengaturannya dari awal hingga akhir.
Tidak ada API Google resmi untuk posisi kata kunci langsung: gunakan Search Console API untuk data rata-rata milik Anda sendiri, SERP API pihak ketiga untuk posisi yang tepat dan kompetitif, dan lewati Custom Search JSON API sepenuhnya untuk pekerjaan peringkat. Membangun di atas yang salah adalah kesalahan paling umum di sini, dan menghasilkan dasbor yang tidak akurat dengan penuh percaya diri.
Jika Anda tidak ingin membangun dan memelihara pipeline itu sendiri, Sorank menghubungkan Search Console Anda dan melacak kutipan AI di satu tempat.
Tidak. Google belum pernah menerbitkan API yang menerima kata kunci dan mengembalikan posisi langsung Anda di google.com. Search Console API mengembalikan posisi rata-rata hanya untuk properti Anda sendiri yang terverifikasi, dan Custom Search JSON API mengkueri mesin kustom yang urutannya tidak sama dengan google.com.
Tidak. Search Console melaporkan posisi rata-rata dari setiap impresi, yang dicampur dari berbagai perangkat, lokasi, dan tanggal. Nilai 7,4 tidak berarti posisi 7; impresi mungkin berkisar dari posisi 3 hingga posisi 15 selama periode tersebut.
Kueri otomatis ke Google Search tanpa izin bertentangan dengan Ketentuan Layanan Google, dan pada volume berapa pun akan memicu pemblokiran IP dan CAPTCHA. SERP API komersial adalah jalur yang diizinkan berdasarkan perjanjian penyedianya dan stabil secara operasional.
MEREKA MENCOBA SORANK SEBELUM ANDA
