11 Ekim 2026
num=100, Google arama URL’sine eklenerek bir sonuç sayfasında daha fazla sonuç göstermeyi denemek için SEO araçları ve otomatik sorgu sistemleri tarafından kullanılmıştır. Ancak bu URL parametresi, Google’ın belgelenmiş bir Search API’si veya kararlı sıra takip arayüzü değildir. Bir sorguda kaç sonuç döneceğini, sonuçların aynı sırada kalacağını ya da tekrar edilebilir olacağını varsaymayın. Otomatik olarak Google sonuçlarını almak, Google’ın hizmet koşulları ve erişim kontrolleriyle de uyumlu olmalıdır.
Önemli ayrım şudur: SERP sıra takibi, tanımlı ülke, dil, cihaz, tarih ve sorgu setinde sonuç sayfasından alınan örneklemdir. Search Console, sitenizin Google Arama’da aldığı gösterim ve tıklama verilerinin performans raporudur. Bu iki veri kümesi farklı soruları yanıtlar; Search Console API’si sabit bir SERP çekimi ya da ilk 100 sonucun sıralı listesi değildir.
num=100’e dayalı ölçüm neden kırılgan?
Google’ın resmi geliştirici belgeleri num=100 parametresini garantili bir veri API’si olarak sunmuyor. Sonuç sayfasındaki istek davranışı, erişim kontrolleri veya HTML yapısı değişirse, parametreye dayanan bir scraper az sayıda sonuç alabilir, farklı biçimli yanıt görebilir ya da isteği tamamlayamayabilir. Bu nedenle tek bir isteğin 100 sonucu döndüreceğini varsayan iş akışları önce gerçek yanıtla sınanmalı ve arıza halinde sessizce eksik veri üretmemelidir.
Sıra izleme aracının kapsama derinliği, istek maliyeti ve Google yönergelerine uygunluğu sağlayıcıya göre değişir. “Herkes Top 20 veya Top 30 izlemeli” gibi tek bir evrensel eşik yoktur. Takip edilecek derinliği iş hedefi, karar ihtiyacı, bütçe ve aracın izin verilen veri toplama yöntemi belirlemelidir.
Search Console API ne verir, ne vermez?
Search Console Search Analytics API, mülkün performansını tarih aralığı ve sorgu, sayfa, ülke, cihaz gibi boyutlarda incelemeye yarar. position alanı ortalama konumdur. API satırları tıklama sayısına göre sıralanır; dahili sınırlar nedeniyle bütün satırların dönmesi garanti edilmez ve çoğunlukla üst satırlar verilir. rowLimit tek çağrıda en fazla 25.000 satır ister; sayfalama veya daha yüksek limit tanımlamak, Search Console’da bulunmayan ya da API’nin dahili sınırlamalarından ötürü verilmeyen bütün satırları garanti etmez. Google’ın Search Analytics API dokümantasyonu bu sınırları ve alan anlamlarını açıklar.
Search Console’daki ortalama konum tek bir sorguda her kullanıcının gördüğü anlık sıra değildir. Google bunu bağlantının gösterimlerdeki konumlarına dayalı ortalama olarak tanımlar; sonuç sayfasının yapısına ve mülk/sayfa toplamaya göre yorum değişebilir. Position metriği açıklamasını okuyun. Query verisi de bütün aramaların eksiksiz günlüğü değildir; hassasiyet nedeniyle bazı sorgular rapordan çıkarılabilir.
Özetle:
| Araç/veri | Uygun kullanım | Tek başına göstermediği şey |
|---|---|---|
| Search Console raporu/API | Gerçek Search gösterim, tıklama, sorgu ve ortalama konum eğilimleri | Her anahtar kelime için canlı, sabit ve eksiksiz sıralama listesi |
| SERP izleme aracı | Tanımlı lokasyon/cihaz/zaman örnekleminde görülen sonuçlar | Her kullanıcının gördüğü evrensel sıra veya Search Console’daki tıklama verisi |
num=100 URL parametresi | Yalnızca yanıt davranışı test edilerek örneklemeyi kolaylaştırabilir | Desteklenen API, 100 sonuç garantisi veya kalıcı metodoloji |
Search Console API ile ortalama konum alma
Aşağıdaki gövde, daha önce tamamlanmış bir dönem için sorgu ve sayfa kırılımındaki performans satırlarını ister. service, mülk erişimi olan ve Google OAuth ile yetkilendirilmiş API istemcisidir. Örnek, canlı SERP sırasını değil Search Console ortalama konumunu gösterir:
response = service.searchanalytics().query(
siteUrl="https://seobify.com/",
body={
"startDate": "2026-09-01",
"endDate": "2026-09-30",
"dimensions": ["query", "page"],
"type": "web",
"rowLimit": 25000,
"startRow": 0,
},
).execute()
for row in response.get("rows", []):
query, page = row["keys"]
print(query, page, row["clicks"], row["impressions"], row["position"])Bu çağrı için mülk doğrulaması ve uygun OAuth kapsamı gerekir. Veri zaman dilimi Google dokümanında Pacific Time olarak tanımlanır. API dokümantasyonundaki 25.000 satır tek istek sınırıdır; sorgu türü, tarih, filtreler ve sayfalama stratejisi raporlanan veri miktarını etkiler. Sonuç listesini “tüm sorgular” diye adlandırmadan önce API’nin eksiksizlik notunu ve Search Console raporundaki kapsamı hesaba katın.
Tutarlı bir sıra izleme örneklemi kurma
- Ölçüm amacını yazın: görünürlük değişimi, yerel paket, organik bağlantı veya belirli bir SERP özelliği.
- Sorgu listesini ve eşleşen açılış sayfasını kaydedin; marka ve marka dışı kümeleri ayrı değerlendirin.
- Ülke/şehir, dil, cihaz, ölçüm tarihi ve aracın sonuç alma yöntemini sabitleyin.
- Kaç sıra derinliğine ihtiyaç olduğunu karar sorusuna göre seçin; ilk 100 sonucunun varlığını araçta test edin.
- Başarısız istekleri, eksik sonuç sayılarını, CAPTCHA/erişim hatalarını ve metodoloji değişikliklerini kaydedin. Eksik veriyi önceki sıralamayla doldurmayın.
- Search Console ortalama konumunu SERP sırası gibi kullanmayın. Dönemsel görünürlük, tıklama ve gösterim eğilimlerini ayrı okuyun.
AI agent ölçüm checklist’i
num=100parametresini çalıştırmadan önce araç, kaynak URL, HTTP durum kodu ve dönen sonuç adedini kaydet.- Google’ın geliştirici belgelerinde desteklenen API veya parametre olduğuna dair kaynak bulamazsan, “garantili” diye etiketleme.
- Search Console API kullanılıyorsa OAuth/mülk erişimini, tarih aralığını (PT), boyutları, filtreleri, satır limitini ve pagination’ı kaydet.
- Çıktıda
positionalanını “Search Console ortalama konum” diye adlandır; anlık sıra olarak yeniden yazma. - Satır eksikliği, gizlilik eşiği veya API limitleri olasılığını belirt; boş hücreleri sıfır veya sıralama düşüşü sayma.
- SERP örneklemi raporunu API performans raporundan ayrı tut ve aralarında doğrulanmamış nedensellik kurma.
Sık sorulan sorular
Search Console konum verisi sıra takip aracından neden farklı?
Search Console gerçek gösterimlerden türetilmiş ortalama konum sunar; takip aracı ise tanımlı bir konum, cihaz, zaman ve sağlayıcı yöntemiyle SERP örneği alır. Metrikler farklı hesaplandığından bire bir aynı değeri vermeleri beklenmez.
Search Console API ilk 100 sırayı verir mi?
Hayır. API, sitenizin Search performans raporunu boyutlara göre döndürür; her sorgu için tam SERP sonuç listesini vermez. Sonuçların kapsamı API’nin veri ve satır limitlerine tabidir.
100. sıraya kadar takip etmek gerekli mi?
Her site ve amaç için aynı derinlik gerekli değildir. Takip seviyesini karar ihtiyacına, araç kapsamına ve maliyete göre belirleyin; 20/30/100 gibi sayıları evrensel SEO kuralı olarak sunmayın.
Daha gelişmiş organik performans ölçümü ve SEO analizleri için SEO danışmanlığı hizmetimizi inceleyin.