Google Sıralama API'si: Gerçekte Ne Döndürüyor ve Ne Vermeyi Reddediyor

Google sıralama API'si arayan ekipler genellikle tek ve belirli bir şey ister: bir sayfanın bir anahtar kelime için kaçıncı sırada olduğunu döndüren bir çağrı. Google bunu yayımlamıyor.

Google'ın yayımladığı şey, kendi performansınızı, kendi dizin durumunuzu ve kendi tarama durumunuzu tanımlayan bir API kümesi. Gerçekten faydalılar ve hepsi ücretsiz. Ayrıca yapısal olarak, çoğu insanın bu aramaya getirdiği soruyu yanıtlayamıyorlar.

Bir günümüzü bu API'lerin canlı bir mülkte gerçekte ne döndürdüğünü ölçmeye harcadık; yanlış okunması kolay kısımlar dahil. Üç bulgu öne çıktı: veriler üç gün gecikmeli geliyor, konum sayısı canlı bir sonuç karşısında yeniden üretilemeyen bir ortalama ve en çok sıralama kontrolüne benzeyen API, tek başına hiçbir işe yarar şey söylemeyen bir karar döndürüyor.

Google gerçekte ne yayımlıyor

Dört yüzey bir sıralama API'siyle karıştırılıyor. Google'ın kendi belgelerine göre her birinin ne için olduğu şöyle.

Search Analytics API, doğrulanmış bir mülk için tıklamaları, gösterimleri, CTR'ı ve ortalama konumu döndürür. Google'ın sunduğu sıralama verisine en yakın şeydir ve Search Console'daki her "ortalama konum" sayısının kaynağıdır.

URL Inspection API, tek bir URL için dizin durumunu döndürür: Google onu biliyor mu, dizine eklenmiş mi, eklenmemişse neden.

Indexing API, sayfaları dizine gönderiyormuş gibi kulağa gelir. Google'ın belgeleri desteklenen türleri JobPosting ve BroadcastEvent yapılandırılmış verileriyle sınırlar; bu dar bir kullanım durumudur, genel bir dizin gönderimi değil.

Custom Search JSON API, bir sorgu için web sonuçlarını döndürür. Sizin yapılandırdığınız bir dizinde arama yapar ve sitenizin Google'ın ana sonuçlarında kaçıncı sırada olduğunu söylemez.

Hiçbiri "bu anahtar kelimedeki sıralamanız" bilgisini döndürmez. Bu iş Google'ın ürün hattında yok ve bu eksiklik bir gözden kaçırma değil, kasıtlı. Google'ın rakip sıralama verisini geniş ölçekte dağıtmak için ticari bir nedeni yok.

Ölçtüğümüz şey: veriler üç günlük

12 Eylül 2026'da kendi mülkümüzün günlük dökümünü çektik. Herhangi bir veri içeren en yeni tarih 9 Eylül'dü.

Üç günlük gecikme, tutarlı biçimde. window parametresi bugünden değil, en yeni kullanılabilir tarihten geriye doğru sayar ve bu küçük bir tuzaktır: yedi günlük bir istek, 12 Eylül'de değil, 9 Eylül'de biten sekiz tarih döndürür.

Aylık bir rapor için bu önemsiz. "Dünkü sayfa değişikliğim bir şeyi bozdu mu" sorusu içinse bu, aracı diskalifiye eder. Hiçbir yapılandırma bunu düzeltmez. Gecikme hattın Google tarafında.

Ölçtüğümüz şey: ortalama konum sıralama değildir

Bu daha önemli bulgu ve insanların Google'ın bir sıralama API'si olduğuna, sadece kaçamak davrandığına inanmasına yol açan şey de bu.

Ortalama konum, URL'nizin dönemdeki tüm gösterimler boyunca ortalama konumudur; ülkeler, cihazlar ve sorgu varyantları arasında ağırlıklandırılır. Canlı bir sıralama kontrolü ise tek bir sayı döndürür: tek bir konumdan, tek bir cihazda, tek bir anda. İkisi aynı adı paylaşan farklı ölçümlerdir.

Farkı kendi Search Console verimizden çektiğimiz 25 sorgu üzerinde test ettik, sonra aynı 25 anahtar kelimeyi Amerika Birleşik Devletleri, İngilizce, masaüstü canlı bir SERP'te 100 derinlikte kontrol ettik.

Her iki ölçümün de bulunduğu yerde, medyanda 7,4 pozisyon ayrışıyorlar.

Ortalamalardan daha önemli iki ayrıntı var.

Birincisi, 23 sorgunun dokuzu Search Console'da bir konum üretti ama Amerika Birleşik Devletleri, İngilizce, masaüstü kontrolünde hiç canlı sonuç çıkmadı. Bu bir hata değil. Gösterimler başka ülkelerden, başka dillerden, başka cihazlardan ve görsel ya da video yüzeylerinden birikir. Tek bir coğrafyaya kilitlenmiş bir kontrol bunları yeniden üretemez ve iki sayıyı aynı ölçüm gibi ele alan bir ekip, yöntemin ürünü olan bir tutarsızlığın peşinde bütün bir hafta harcar.

İkincisi, yön tutarlı değil. Canlı konumların çoğu Search Console ortalamasının altında kaldı; ortalama daha iyi performans gösteren yüzeyleri içerdiğinde beklenen budur. Ama bir sorgu ters yönde 36,6 pozisyon hareket etti: 73,6'dan 37'ye. Uygulanabilecek bir düzeltme katsayısı yok.

Fark iki yönde de gidiyor, dolayısıyla uygulanabilecek bir düzeltme katsayısı yok.

Google sıralama API'si seçen herkes için pratik sonuç şu: ücretsiz veri size bir sıralama söylemeyecek, ücretli veri de onunla uyuşmayacak. İkisi de farklı şeyleri doğru biçimde ölçüyor. Birini diğerinin yerine koymak, raporlamanın bozulmaya başladığı nokta.

Birinci taraf verisinin gerçekten yeri doldurulamaz olduğu yer kapsama ve bunu SERP API alternatifleri karşılaştırmasında ayrıca ölçtük.

URL Inspection API bunun yerine ne döndürüyor

URL Inspection API, anahtar kelimesiz bir URL verip karşılığında bir durum aldığınız için kendini sıralama kontrolü gibi hissettiren tek Google yüzeyidir. İki URL test ettik.

İkisi de aynı kararı döndürdü. İki durumu gerçekten ayıran alan, bir cümle olan ve enum olmayan kapsama durumu dizesidir. Karar alanı, Google'ın hiç görmediği bir URL için de keşfedip dizine eklemediği bir URL için de NEUTRAL der.

Bu kullanılabilir bir API ve tek başına zayıf bir izleme sinyali. Bir sayfa dizine eklenmediğinde uyarı almak istiyorsanız kararı değil kapsama durumunu ayrıştırın ve son tarama zamanının tam da en çok önemsediğiniz URL'lerde eksik olmasını bekleyin.

Dört yüzey ve hiçbirinin yapmadığı iş

Örüntü tutarlı. Google'ın API'leri mülkünüzü içeriden tanımlar. Sıralama sorusu ise dışarıdan, bir sonuç sayfası hakkında sorulur ve Google bunu sunmuyor.

Fazla ödemeden boşluğu nasıl kapatırsınız

İşleyen kurulum, tek bir kaynaktan iki işi birden istemek değil, işleri farklı iki kaynak kullanmaktır.

Kendi mülkünüzle ilgili temel gerçek için Google'ın API'lerini kullanın. Tıklamalar, gösterimler ve dizin durumu başka hiçbir yerden edinemeyeceğiniz birinci taraf olgulardır ve ücretsizdir. Bunları bir takvime göre çekin ve üç günlük gecikmeyi ölçüm aletinin bir özelliği olarak kabul edin.

Dışarıdan bakış için bir SERP kaynağı kullanın. Canlı konumlar, rakip konumları ve henüz sıralamada olmadığınız anahtar kelimeler. Ücretli kısım burası ve çoğu ekibin varsaydığından daha ucuz: testimizde 23 anahtar kelimeyi 100 derinlikte kontrol etmek $0,2975 tuttu, yani kontrol başına $0,0129.

İki sayıyı uzlaştırmaya çalışmayın. Farklı şeyleri ölçüyorlar. İşe yarayan hamle ikisini birlikte okumak: Search Console ne olduğunu söyler, canlı kontrol ne olmakta olduğunu söyler. Ayrıştıklarında herhangi bir sonuca varmadan önce o sorgunun ülke ve cihaz bileşimine bakın.

İkisini tek bir betikten çalıştırmanın mekaniği iki kaynaklı izleyici kurulumumuzda, canlı yarının maliyet tarafı ise toplu kontrol testinde fiyatlandırıldı.

Sık sorulan sorular

Google'ın resmi bir sıralama API'si var mı? Hayır. Google kendi arama performansınız (Search Analytics), dizin durumunuz (URL Inspection) ve iki dar gönderim türü (Indexing) için API yayımlıyor. Hiçbiri bir anahtar kelime için sıralama döndürmüyor.

Sıralama API'si yoksa Search Console neden konum gösteriyor? Çünkü ortalama konum, gösterimlerinizden hesaplanan bir performans metriğidir, sıralama sorgusu değil. Dönemdeki tüm gösterimler boyunca ortalama konumdur; ülkeler, cihazlar ve yüzeyler arasında ortalanır.

Search Console verileri ne kadar geride? 12 Eylül 2026'daki ölçümümüzde üç gün; en yeni kullanılabilir tarih 9 Eylül'dü. window parametresi o tarihten geriye sayar, dolayısıyla yedi günlük bir istek en yeni kullanılabilir günde biten sekiz tarih döndürür.

URL Inspection API bir sayfanın dizine eklenip eklenmediğini söyleyebilir mi? Evet ve bu iş için doğru araç. Karar alanı yerine kapsama durumu dizesini okuyun, çünkü karar hem bilinmeyen bir URL hem de keşfedilmiş ama dizine eklenmemiş bir URL için NEUTRAL döndürür.

Custom Search JSON API bir sıralama API'si mi? Hayır. Sizin yapılandırdığınız bir arama motorundan sonuç döndürür, Google'ın ana sonuçlarındaki konumunuzu değil.

Gerçek sıralama verisini elde etmenin en ucuz yolu ne? Gerçekten harekete geçtiğiniz en küçük anahtar kelime kümesini, sıralamanıza uygun derinlikte kontrol edin. Testimizde 10 derinlik kontrolü anahtar kelime başına $0,002, 100 derinlik ise $0,014 tuttu; yani derinlik ayarı faturayı anahtar kelime sayısından yedi kat daha fazla oynatıyor.

Auspia görüşü: "Google sıralama API'si var mı" sorusunun dürüst yanıtı hayır ve işe yarar devamı da aramayı bırakmaktır. Google'ın API'leri birinci taraf sorularını iyi yanıtlıyor ve sıralama sorularını hiç yanıtlayamıyor. Dışarıdan bakış için küçük bir bütçe ayırın ve emeğin geri kalanını Google'ın sizin için yapmayacağı kısma, yani iki sayı ayrıştığında neyi değiştireceğinize karar vermeye harcayın.

Yazan: Gabriel Finch, arama erişimi araştırmacısı, Auspia'da 1.200'den fazla AI yanıtının incelenmesi. Arama altyapısı, erişim sistemleri ve her veri kaynağının gerçekte ne görebildiği üzerine yazıyor.