Pasukan yang mencari API kedudukan Google biasanya mahukan satu perkara khusus: panggilan yang memulangkan di kedudukan mana sesuatu halaman berada untuk sesuatu kata kunci. Google tidak menerbitkan perkara itu.
Yang diterbitkan Google ialah satu set API yang menerangkan prestasi anda sendiri, status indeks anda sendiri dan keadaan crawl anda sendiri. Semuanya benar-benar berguna, dan semuanya percuma. Ia juga secara struktur tidak mampu menjawab soalan yang dibawa kebanyakan orang ke carian ini.
Kami meluangkan sehari untuk mengukur apa yang sebenarnya dipulangkan API tersebut pada hartanah yang aktif, termasuk bahagian yang mudah disalah baca. Tiga penemuan menonjol: data tiba lewat tiga hari, angka kedudukan itu purata yang tidak dapat dihasilkan semula berbanding hasil langsung, dan satu API yang paling kedengaran seperti pemeriksaan kedudukan memulangkan keputusan yang berdiri sendiri tidak mengatakan apa-apa yang berguna.
Apa yang sebenarnya diterbitkan Google
Empat permukaan dikelirukan dengan API kedudukan. Inilah kegunaan setiap satu, menurut dokumentasi Google sendiri.
Search Analytics API memulangkan klik, tera, CTR dan kedudukan purata untuk hartanah yang disahkan. Ia perkara paling hampir dengan data kedudukan yang ditawarkan Google, dan ia punca setiap angka "kedudukan purata" dalam Search Console.
URL Inspection API memulangkan status indeks untuk satu URL: sama ada Google mengetahuinya, sama ada ia diindeks, dan jika tidak, mengapa.
Indexing API kedengaran seperti menghantar halaman untuk pengindeksan. Dokumentasi Google mengehadkan jenis yang disokong kepada data berstruktur JobPosting dan BroadcastEvent, iaitu kes penggunaan yang sempit, bukan penghantaran indeks secara umum.
Custom Search JSON API memulangkan hasil web untuk sesuatu pertanyaan. Ia mencari dalam indeks yang anda konfigurasikan sendiri, dan ia tidak memberitahu anda di kedudukan mana laman anda berada dalam hasil utama Google.
Tiada satu pun memulangkan "kedudukan anda untuk kata kunci ini". Kerja itu tidak wujud dalam barisan produk Google, dan ketiadaannya disengajakan, bukan terlepas pandang. Google tiada sebab komersial untuk mengagihkan data kedudukan pesaing secara besar-besaran.
Apa yang kami ukur: data berusia tiga hari
Kami menarik pecahan harian untuk hartanah kami sendiri pada 12 September 2026. Tarikh terbaharu yang mempunyai sebarang data ialah 9 September.
Tarikh tersedia | Baris dipulangkan |
|---|---|
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, terbaharu |
Kelewatan tiga hari, secara konsisten. Parameter window mengira ke belakang dari tarikh tersedia terbaharu dan bukan dari hari ini, dan itu perangkap kecil: permintaan tujuh hari memulangkan lapan tarikh yang berakhir pada 9 September, bukan 12 September.
Untuk laporan bulanan ini tidak relevan. Untuk soalan "adakah perubahan halaman saya semalam merosakkan sesuatu", ini menggugurkannya. Tiada konfigurasi boleh membaikinya. Kelewatan itu di pihak Google.
Apa yang kami ukur: kedudukan purata bukan kedudukan
Ini penemuan yang lebih penting, dan inilah yang membuat orang percaya API kedudukan Google wujud dan hanya bersikap mengelak.
Kedudukan purata ialah kedudukan purata URL anda merentas setiap tera dalam tempoh itu, diberatkan merentas negara, peranti dan varian pertanyaan. Pemeriksaan kedudukan langsung memulangkan satu angka, dari satu lokasi, pada satu peranti, pada satu ketika. Kedua-duanya pengukuran berbeza yang berkongsi satu nama.
Kami menguji jurang itu pada 25 pertanyaan yang diambil daripada data Search Console kami sendiri, kemudian memeriksa 25 kata kunci yang sama terhadap SERP langsung Amerika Syarikat, bahasa Inggeris, desktop pada kedalaman 100.
Hasil | Bilangan |
|---|---|
Pertanyaan yang boleh digunakan dalam kedua-dua set | 23 |
Muncul dalam 100 teratas langsung | 14 (61%) |
Mempunyai tera Search Console tetapi tiada hasil langsung yang boleh dihasilkan semula | 9 (39%) |
Median jurang mutlak apabila kedua-duanya wujud | 7,4 kedudukan |
Purata jurang mutlak | 8,5 kedudukan |
Jurang terbesar | 36,6 kedudukan |
Dalam lingkungan 3 kedudukan antara satu sama lain | 4 daripada 14 |
Terpesong lebih daripada 10 kedudukan | 4 daripada 14 |
Di tempat kedua-dua pengukuran wujud, keduanya berbeza pada median 7,4 kedudukan.
Ada dua perincian yang lebih penting daripada purata.
Pertama, sembilan daripada 23 pertanyaan menghasilkan kedudukan Search Console tetapi tiada hasil langsung sama sekali dalam pemeriksaan Amerika Syarikat, bahasa Inggeris, desktop. Ini bukan pepijat. Tera terkumpul dari negara lain, bahasa lain, peranti lain serta permukaan imej dan video. Satu pemeriksaan yang terikat pada satu geografi tidak akan menghasilkan semulanya, dan pasukan yang menganggap kedua-dua angka itu sebagai pengukuran yang sama akan menghabiskan seminggu mengejar jurang yang sebenarnya artifak kaedah.
Kedua, arahnya tidak konsisten. Kebanyakan kedudukan langsung berada di bawah purata Search Console, yang memang dijangka apabila purata merangkumi permukaan yang berprestasi lebih baik. Tetapi satu pertanyaan bergerak 36,6 kedudukan ke arah bertentangan, dari 73,6 ke 37. Tiada faktor pembetulan yang boleh digunakan.
Jurang itu bergerak ke dua arah, jadi tiada faktor pembetulan yang boleh digunakan.
Kesimpulan praktikal bagi sesiapa yang sedang memilih API kedudukan Google: data percuma tidak akan memberitahu kedudukan, dan data berbayar tidak akan bersetuju dengannya. Kedua-duanya mengukur perkara berbeza dengan betul. Menganggap salah satu sebagai pengganti yang lain ialah titik laporan mula jadi kacau.
Tempat pihak data pertama benar-benar tidak boleh diganti ialah liputan, yang kami ukur secara berasingan dalam perbandingan alternatif API SERP.
Apa yang dipulangkan URL Inspection API sebagai gantinya
URL Inspection API ialah satu-satunya permukaan Google yang terasa seperti pemeriksaan kedudukan, kerana anda memberinya URL tanpa kata kunci dan menerima status kembali. Kami menguji dua URL.
Keadaan URL | Keputusan | Status liputan | Masa crawl terakhir |
|---|---|---|---|
Diterbitkan kira-kira sejam sebelumnya | NEUTRAL | URL tidak dikenali Google | Tidak diketahui |
Diterbitkan kira-kira sembilan jam sebelumnya | NEUTRAL | Ditemui, kini tidak diindeks | Tidak diketahui |
Kedua-duanya memulangkan keputusan yang sama. Medan yang benar-benar membezakan kedua-dua kes itu ialah rentetan status liputan, yang merupakan ayat, bukan enum. Medan keputusan berkata NEUTRAL bagi URL yang tidak pernah dilihat Google dan bagi URL yang telah ditemuinya tetapi tidak diindeks.
Ini API yang boleh digunakan dan isyarat pemantauan yang lemah jika berdiri sendiri. Jika anda mahu amaran apabila sesuatu halaman tidak diindeks, huraikan status liputan dan bukan keputusan, dan jangkakan masa crawl terakhir akan tiada tepat pada URL yang paling anda ambil berat.
Empat permukaan, dan kerja yang tidak dilakukan mana-mana
Soalan | Permukaan Google | Jawapan |
|---|---|---|
Bagaimana prestasi saya untuk pertanyaan ini minggu lalu | Search Analytics API | Ya, lewat tiga hari, sebagai purata |
Adakah URL ini diindeks | URL Inspection API | Ya, bagi setiap URL, atas permintaan |
Di kedudukan mana saya sekarang untuk mana-mana kata kunci | tiada | Tidak |
Di kedudukan mana pesaing saya | tiada | Tidak |
Bagaimana rupa SERP bagi kata kunci yang saya tidak kedudukan | tiada | Tidak |
Polanya konsisten. API Google menerangkan hartanah anda dari dalam. Soalan kedudukan ditanya dari luar, tentang halaman hasil, dan Google tidak menyediakannya.
Cara menutup jurang tanpa membayar berlebihan
Susunan praktikalnya ialah dua sumber dengan tugas berbeza, bukan satu sumber yang diminta melakukan kedua-duanya.
Gunakan API Google sebagai kebenaran asas tentang hartanah anda sendiri. Klik, tera dan status indeks ialah fakta pihak pertama yang tidak boleh anda peroleh di tempat lain, dan ia percuma. Tariknya mengikut jadual dan anggap kelewatan tiga hari sebagai sifat alat pengukur itu sendiri.
Gunakan sumber SERP untuk pandangan dari luar. Kedudukan langsung, kedudukan pesaing dan kata kunci yang anda belum kedudukan. Ini bahagian berbayar, dan ia lebih murah daripada yang disangka kebanyakan pasukan: dalam ujian kami, memeriksa 23 kata kunci pada kedalaman 100 berharga $0,2975, iaitu $0,0129 setiap pemeriksaan.
Jangan cuba menyelaraskan kedua-dua angka itu. Kedua-duanya mengukur perkara berbeza. Langkah yang berguna ialah membacanya bersama: Search Console memberitahu apa yang berlaku, dan pemeriksaan langsung memberitahu apa yang sedang berlaku. Apabila keduanya tidak sepadan, lihat komposisi negara dan peranti bagi pertanyaan itu sebelum membuat sebarang kesimpulan.
Mekanisme menjalankan kedua-duanya dari satu skrip ada dalam binaan penjejak dua sumber kami, dan sisi kos bagi separuh langsung dinilai dalam ujian pemeriksaan pukal.
Soalan lazim
Adakah Google mempunyai API kedudukan rasmi? Tidak. Google menerbitkan API untuk prestasi carian anda sendiri (Search Analytics), status indeks (URL Inspection) dan dua jenis penghantaran yang sempit (Indexing). Tiada satu pun memulangkan kedudukan untuk sesuatu kata kunci.
Mengapa Search Console menunjukkan kedudukan jika tiada API kedudukan? Kerana kedudukan purata ialah metrik prestasi yang dikira daripada tera anda, bukan pertanyaan kedudukan. Ia kedudukan purata merentas semua tera dalam tempoh itu, dipuratakan merentas negara, peranti dan permukaan.
Berapa jauh data Search Console ketinggalan? Tiga hari dalam pengukuran kami pada 12 September 2026, dengan tarikh tersedia terbaharu ialah 9 September. Parameter window mengira ke belakang dari tarikh itu, jadi permintaan tujuh hari memulangkan lapan tarikh yang berakhir pada hari tersedia terbaharu.
Bolehkah URL Inspection API memberitahu saya sama ada sesuatu halaman diindeks? Boleh, dan ia alat yang betul untuk kerja itu. Baca rentetan status liputan dan bukan medan keputusan, kerana keputusan memulangkan NEUTRAL bagi URL yang tidak dikenali dan URL yang ditemui tetapi tidak diindeks.
Adakah Custom Search JSON API ialah API kedudukan? Bukan. Ia memulangkan hasil daripada enjin carian yang anda konfigurasikan sendiri, bukan kedudukan anda dalam hasil utama Google.
Apakah cara termurah untuk mendapatkan data kedudukan sebenar? Periksa set kata kunci terkecil yang benar-benar anda tindak lanjuti, pada kedalaman yang sepadan dengan kedudukan anda. Pemeriksaan pada kedalaman 10 berharga $0,002 setiap kata kunci dalam ujian kami dan kedalaman 100 berharga $0,014, jadi tetapan kedalaman menggerakkan bil tujuh kali lebih besar daripada bilangan kata kunci.
Pandangan Auspia: jawapan jujur bagi "adakah API kedudukan Google wujud" ialah tidak, dan langkah susulan yang berguna ialah berhenti mencarinya. API Google menjawab soalan pihak pertama dengan baik dan langsung tidak mampu menjawab soalan kedudukan. Peruntukkan jumlah kecil untuk pandangan dari luar, dan gunakan baki usaha pada bahagian yang tidak akan Google lakukan untuk anda, iaitu memutuskan apa yang perlu diubah apabila kedua-dua angka itu tidak sepadan.
Penulis: Gabriel Finch, penyelidik pengambilan carian, dengan semakan lebih daripada 1.200 jawapan AI di Auspia. Menulis tentang infrastruktur carian, sistem pengambilan dan apa yang sebenarnya boleh dilihat oleh setiap sumber data.
