Preferensi

Privasi penting bagi kami, sehingga Anda dapat menonaktifkan jenis penyimpanan tertentu yang tidak diperlukan untuk fungsi dasar situs web. Memblokir kategori tertentu dapat memengaruhi pengalaman Anda di situs web. Informasi lebih lanjut (Kebijakan Cookie)

Terima semua cookie

Cara Memeriksa Posisi Kata Kunci Menggunakan Google API (Panduan 2026)

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.

Diterbitkan pada:
8/9/2026
-
Diperbarui pada:
8/9/2026
Baris kode pemrograman di layar pengembang saat mengkueri API pencarian

Alat

Thibault Besson-Magdelain, pendiri Sorank

Tentang Penulis

Thibault Besson-Magdelain

Pendiri Sorank, pengalaman 7+ tahun di bidang SEO, penggemar GEO.
Di halaman ini

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.

Apakah Google punya API peringkat kata kunci resmi?

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:

JalurMengembalikanMencakup pesaing?Biaya
Search Console APIPosisi rata-rata, hanya situs AndaTidakGratis
Custom Search JSON APIHasil dari mesin kustomYa, tetapi bukan SERP asli100 kueri/hari gratis
SERP API pihak ketigaPosisi SERP langsung dan tepatYaBerbayar, per kueri

Bagaimana cara mendapatkan posisi kata kunci dari Search Console API?

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}")
Dasbor analitik dengan grafik performa yang ditampilkan di monitor komputer
Search Console mengembalikan data posisi rata-rata, bukan cuplikan peringkat langsung.

Tiga keterbatasan yang sering menjebak

  • Posisi adalah rata-rata, bukan peringkat. Nilai 7,4 tidak berarti Anda berada di posisi 7; artinya impresi tersebar di berbagai posisi dengan rata-rata 7,4, yang mungkin berkisar dari 3 hingga 15 di berbagai perangkat dan lokasi.
  • Hanya situs Anda. Tidak ada cara untuk melihat posisi pesaing. Search Console memang API yang dibatasi pada properti.
  • Kata kunci tanpa impresi tidak terlihat. Jika Anda berada di posisi 60 dan tidak ada yang menggulir sejauh itu, kueri tersebut sama sekali tidak muncul dalam data.

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.

Bisakah saya memakai Custom Search JSON API untuk memeriksa peringkat?

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.

Bagaimana dengan scraping Google secara langsung?

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.

Seorang pengembang perangkat lunak menulis kode di stasiun kerja komputer
Pelacakan peringkat dalam skala besar lebih merupakan masalah integrasi daripada masalah scraping.

Apa yang sebenarnya sebaiknya Anda bangun?

Bagi sebagian besar tim, arsitektur yang pragmatis adalah hibrida, dan bentuknya seperti ini:

  • Search Console API sebagai tulang punggung. Gratis, kata kunci tanpa batas, data pihak pertama, dan satu-satunya sumber yang memberi tahu Anda untuk apa Anda benar-benar mendapat impresi.
  • SERP API untuk kumpulan kata kunci kecil yang dikurasi. Dua puluh atau tiga puluh istilah Anda yang kritis secara komersial, diperiksa setiap hari, termasuk posisi pesaing.
  • Lapisan visibilitas AI. Semakin sering, pertanyaannya bukan hanya "di posisi berapa saya" tetapi "apakah saya dikutip ketika seseorang bertanya kepada asisten". API peringkat klasik tidak menjawab satu pun dari itu.

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.

Kesimpulan

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.

Pertanyaan yang sering diajukan

Apakah Google punya API peringkat kata kunci?

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.

Apakah posisi di Search Console sama dengan peringkat?

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.

Bisakah saya melakukan scraping Google untuk memeriksa peringkat saya?

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.

Blog Kami untuk Perusahaan Ambisius

Tool SEO gratis kami

Lihat semua tool gratis kami

MEREKA MENCOBA SORANK SEBELUM ANDA

Testimoni dari para pendiri yang ambisius

Pertumbuhan organikE-commerce

Dari 0 menjadi 10000 pengunjung dalam 5 bulan

Celio Fabianomonrobotlavevitre.fr
Pertumbuhan organikSoftware

Dari 0 menjadi 5000 klien dalam 8 bulan

Thibault BMsorank.com
Pertumbuhan organikHiburan dan penerbangan

0 menjadi 1104 klik dalam 4 bulan

Dominiqueflight-sensations-idf.com
Pertumbuhan organikSoftware musik

Klik x30 dalam 4 bulan

Valentin Cordiertiger-sounds.com
Pertumbuhan organikKesehatan dan kebugaran

Klik x30 dalam 4 bulan

Rodrigue Bretonalthevia.com