Sıralama takip API'si: iki kaynakla kendi Google sıralama takipçinizi kurun

Bir sıralama takip API'si tek bir şey değildir. "rank tracking API" arayan geliştirici genelde sıralamaları döndüren tek bir uç nokta ister, pazar ise satıcı listeleriyle karşılık verir. Dürüst yanıt şu: iki kaynağa ihtiyacınız var ve ikisi farklı soruları yanıtlıyor.

Search Console API ücretsizdir, resmîdir ve doğrulayabildiğiniz mülklerle kalıcı olarak sınırlıdır. Bir SERP API'si ücretlidir, resmî değildir ve herhangi bir anahtar kelimeyi herhangi bir yerde kontrol edebilir; hiç sıralamaya girmediğiniz kelimeler dâhil. İkisi tek başına bir sıralama takipçisi değildir. Birlikte, yaklaşık 120 satır Python ve bir cron satırıdır.

Bu, o kurulumun tarifi. Bir betiği çalıştırıp bir dosya saklayabildiğinizi varsayar. Bir ürün yapmak istediğinizi varsaymaz.

Sonunda ne elde edeceksiniz

Kimin için: Search Console erişimi zaten olan ve koltuk başına ödeme yapmadan belirli bir düzende sıralama isteyen bir geliştirici ya da teknik pazarlamacı.

Bitirdiğinizde elinizde ne olacak: çalışan iki çekme fonksiyonu, her çalıştırmada bir birleştirilmiş çıktı dosyası ve sayıların size yalan söylemesini engelleyen bir karşılaştırma kuralı.

Süre: ilk kurulum için yaklaşık 90 dakika, sonrasında her çalıştırma için kabaca 10 dakika gözden geçirme.

Bittiğinde ne görünür: sorgu ve cihaza göre kendi sıralamalarınızı içeren tarihli bir JSON dosyası, dondurulmuş bir anahtar kelime listesi için canlı SERP anlık görüntüleri ve bir önceki çalıştırmaya karşı kısa bir fark.

Başlamadan önce: her kaynak ne yapabilir, ne yapamaz

Bu ayrımı doğru yapın, kurulumun geri kalanı mekanik olur. Yanlış yapın, bir ayınızı ya işe yaramaz ya da pahalı bir şey inşa etmekle geçirirsiniz.

İki kaynak çelişecek ve bu çelişki hata değil, bilgidir. Search Console her gösterimi tarih aralığı boyunca ve tüm cihazlarda ortalar. Bir SERP çekimi, tek bir andaki tek bir sonuç sayfasıdır. İkisini doğrudan karşılaştırırsanız hayalet düşüşlerin peşine düşersiniz; beşinci adımın bir karşılaştırma kuralı tanımlamasının nedeni budur.

Kod yazmadan önce bilmeye değer üç sayı. Search Console API istek başına 1 ile 25.000 arasında satır sınırı kabul eder ve varsayılanı 1.000'dir; yani orta ölçekli bir site üç aylık sorgu ve cihaz verisini tek çağrıda çekebilir. Site başına ve kullanıcı başına dakikada 1.200 sorguya izin verir. Ve 10 dakikalık dilimlerle ölçülen yük kotaları uygular; uzun bir tarih aralığı kısa olandan pahalıya gelir — Google'ın kendi rehberinin aynı veriyi yeniden sorgulamaktan kaçının demesinin nedeni tam olarak budur.

İki kaynak, tek çıktı. Search Console "nerede görünüyorum"u, bir SERP API'si "sayfa nasıl görünüyor"u yanıtlar.

Adım 1: kod yazmadan önce anahtar kelime kümesini dondurun

Her çalıştırmada farklı bir anahtar kelime listesi çeken bir takipçi, bir şeyin değişip değişmediğini yanıtlayamaz. Önce listeyi seçin ve bir çeyrek boyunca koruyun.

Üç grup var ve farklı kaynaklardan gelirler.

• Search Console'dan: son 90 günde en az 20 gösterim alan her sorgu. Bunları siz seçmezsiniz; gösterimleriniz seçer. Hareketin anlam taşıdığı grup budur, çünkü arkasında zaten talep vardır.
• İşten: gelire karşılık gelen on ilâ yirmi sorgu; sıralamaya girmiş olsanız da olmasanız da.
• Rakiplerden: bir rakibin sıralamaya girdiği, sizin girmediğiniz sorgular. Bunlar bir SERP API'si gerektirir, çünkü Search Console onları asla göstermez.

Listeyi bir dosyaya yazın, sürümleyin ve eklemeleri kayma değil bilinçli bir değişiklik olarak ele alın.

Adım 2: kendi sıralamalarınızı ücretsiz çekin

Bu yarı resmîdir, ücretsizdir ve hiçbir SERP API'sinde olmayan cihaz ayrımını ve tıklama verisini verir.

from google.oauth2 import service_account
from googleapiclient.discovery import build

service = build(
    "searchconsole", "v1",
    credentials=service_account.Credentials.from_service_account_file(
        "gsc-key.json",
        scopes=["https://www.googleapis.com/auth/webmasters.readonly"],
    ),
)

body = {
    "startDate": "2026-06-14",
    "endDate": "2026-09-11",
    "dimensions": ["query", "device"],
    "type": "web",
    "dataState": "final",
    "rowLimit": 25000,
}

rows = service.searchanalytics().query(
    siteUrl="sc-domain:example.com", body=body
).execute().get("rows", [])

Bu istekteki iki ayrıntı işin neredeyse tamamını yapar.

dataState: "final" Google'ın hâlâ düzenleyebileceği taze veriyi dışarıda bırakır. O olmadan en yeni iki üç gün çalıştırmalar arasında oynar ve farkınız hiç yaşanmamış hareketler gösterir.

dimensions: ["query", "device"] çıktıyı sonradan işe yarar kılan şeydir. Cihazı şimdi eklemek hiçbir şeye mal olmaz. Üç aylık geçmişi sonradan yeniden çekmek tam bir çalıştırmaya mal olur ve zaten atladığınız günler için size hiçbir şey vermez.

Beklenen çıktı: sorgu ve cihaz başına bir satır; tıklama, gösterim, CTR ve ortalama sıralama ile.

Kalite kontrolü: satır sayısı 25.000'in altında olmalı. Tam 25.000 çıkarsa kırpılmışsınız ve startRow: 25000 ile ikinci bir çağrı gerekir.

Başarısız olursa: 403 genelde servis hesabı e-postasının mülke kullanıcı olarak hiç eklenmediği anlamına gelir. Search Console'da ekleyin, birkaç dakika bekleyin, yeniden deneyin.

Adım 3: kendi verinizde göremediğiniz SERP'leri çekin

İkinci yarı, Search Console'un yapısal olarak yapamadığı her şeyi kapsar. Bu, çalışan en küçük çağrıdır.

import base64, json, urllib.request

LOGIN, PASSWORD = "your-login", "your-password"

def serp(keyword, depth=100):
    token = base64.b64encode(f"{LOGIN}:{PASSWORD}".encode()).decode()
    payload = json.dumps([{
        "keyword": keyword,
        "location_name": "United States",
        "language_name": "English",
        "depth": depth,
    }]).encode()
    request = urllib.request.Request(
        "https://api.dataforseo.com/v3/serp/google/organic/live/advanced",
        data=payload,
        headers={"Authorization": f"Basic {token}",
                 "Content-Type": "application/json"},
        method="POST",
    )
    return json.loads(urllib.request.urlopen(request, timeout=120).read())

`depth` değerini 200 değil 100 yapın. Bunu Eylül 2026'da altı sorguda 200 sonuç isteyerek test ettik. Google 83 ilâ 128 organik sonuç döndürüp durdu; testin tamamındaki en derin sıralama 142'ydi. Testin tamamı burada. 200 istemek size 200 sonuç vermez ve satıcıya bağlı olarak istediğiniz derinlik yine faturalandırılabilir. 100 isteyin, var olan her şeyi neredeyse her zaman alırsınız.

200 sonuç isteyip 83 ilâ 128 almak. Kabaca 140'ın üzerindeki derinlik çoğu ticari sorguda hiçbir şey satın almaz.

Beklenen çıktı: sıralama, URL, başlık ve alan adı içeren organik öğeler barındıran bir JSON yükü.

Kalite kontrolü: yükün, varsa bir ai_overview öğe türü içerdiğini doğrulayın. Yalnızca organic öğelerini çıkarırsanız, bir sayfanın sıralamasını korurken neden tıklama kaybettiğini kaçırırsınız.

Başarısız olursa: 401 bir base64 ya da kimlik bilgisi hatasıdır. 40200 tarzı bir kod hesap bakiyenizin boş olduğu anlamına gelir ve ilk ayda en sık görülen başarısızlıktır.

Adım 4: özeti değil ham yükü saklayın

İnsanların atladıklarına pişman olduğu karar budur.

Bir sıralama tablosu saklamak, öngörmediğiniz bir soruyu sormanız gerekene kadar işe yarar: SERP uzadı mı, video ele mi geçti, bir rakip girdi mi, katlanma çizgisinin üstünde bir AI Overview çıktı mı. Bir özet bunları yanıtlayamaz. Ham yük yanıtlar, sıfır ek maliyetle.

Pratik sürüm şu: her çalıştırma için tarih ve saatle adlandırılmış, birleştirilmiş çıktıyı içeren bir dosya yazın. Son 90 günü saklayın. Bir depoda yaşayacak kadar küçük, eski soruları yeniden yanıtlayacak kadar eksiksiz.

Adım 5: herhangi bir şeyi zamanlamadan önce karşılaştırma kuralını yazın

Son çalıştırmayı bununla karşılaştıran bir takipçi çoğu gün yanlış alarm üretir. Kendi sayılarımız nedenini gösteriyor: en az 30 gösterim alan 124 sorguda ortalama sorgu bir günden diğerine 4,57 sıralama hareket etti. Dört sıralamalık düşüş bir salı günüdür.

Yani kuralın bir eşiğe ve bir yöne ihtiyacı var.

Bir sorguyu yalnızca şu durumlarda bildir:
  - önceki çalıştırmaya göre mutlak sıralama değişimi 5 veya daha fazlaysa, VE
  - sorgunun karşılaştırma penceresinde en az 20 gösterimi varsa, VE
  - değişim bir cihaz karışımı kaymasıyla açıklanmıyorsa

Çıktıyı sorgu sınıfına göre grupla: money, comparison, brand, informational.
Düzeltme önerme.

Cihaz maddesi süs değil. Aynı sorgu mobilde ve masaüstünde 11 sıralama ayrı durabilir ve cihaz karışımı çalıştırmalar arasında kayarsa harmanlanmış sayı da kayar. Bunu ayrıca ölçtük ve bir eğilimi uydurmaya yetecek kadar büyük.

Maliyeti ne kadar

Satıcı fiyatları değişir, o yüzden teklif kovalamak yerine modeli kurun.

• Bir anahtar kelimenin 30 gün boyunca günde bir kez kontrolü ayda 30 istektir.
• 200 anahtar kelimelik bir kümenin günlük kontrolü ayda 6.000 istektir.
• Aynı kümenin haftalık kontrolü ayda yaklaşık 860 istektir.
• Search Console yarısı ücretsizdir ve içinde kaç anahtar kelime olursa olsun görünüm başına bir istektir.

Bütün karar bu çarpmadır. "Bir araç almalı mıyım" sorusu neredeyse her zaman buna indirgenir: aylık istek sayısını hesaplayın, istek başına fiyatınızla çarpın ve koltuk lisansıyla karşılaştırın. Büyük bir anahtar kelime kümesinin günlük takibi genelde abonelik olarak daha ucuzdur. Küçük bir kümenin haftalık takibi genelde API olarak daha ucuzdur. Dondurulmuş bir listeyi takip edin, API tarafı küçük kalır.

Ne zaman inşa etmek yerine satın almalı

Kendi iş akışınızda sıralama istiyorsanız, hâlihazırda bir SERP API kimlik bilgisine sahipseniz ya da ham sonuç sayfasına sıralamanın ötesinde nedenlerle ihtiyaç duyuyorsanız bunu inşa edin.

Bunun yerine satın alın: bugünden önceki geçmiş sıralamalar gerekiyorsa, aynı anahtar kelimeler için on konum ve beş cihaz gerekiyorsa ya da ekipte cron işini kimse sürdürmeyecekse. Satıcı listeleri tam da bu nedenle okumaya değer ve onu kuran kişi ekip değiştirdiğinde duran bir altyapıya sahip olmanın gerçek bir maliyeti vardır.

Gerçekten ihtiyacınız olan çıktı JSON dosyası değil de yazılı bir haftalık rapor ise, Codex'teki raporlama iş akışı aynı iki kaynaktan başlar ve bir belgede biter. Dosyanın üstüne uyarı koymak için izleme tasarımı rehberi eşikleri ele alır.

Auspia görüşü: sıralama takip API'si sorusu aslında bir veri sahipliği sorusudur. Search Console kendi mülkünüz hakkında resmî veriyi ücretsiz verir ve bunu her zaman yapacaktır. Geri kalan her şey parasını ödediğiniz bir anlık görüntüdür. Önce ücretsiz yarıyı kurun, ücretli yarıyı yalnızca gerçekten sahip olduğunuz bir soruyu yanıtladığı yere ekleyin.

Sık sorulan sorular

Google bir sıralama takip API'si sunuyor mu? Herkese açık olanı yok. Search Console API zaten göründüğünüz sorgular için ortalama sıralamanızı döndürür; bu yakındır ama aynı şey değildir. Sıralamaya girmediğiniz bir anahtar kelimeyi kontrol edemez ve bir rakibi kontrol edemez.

Bir SERP API'si ne kadar derine inebilir? Satıcılar 200'ün çok üzerinde derinlik değerlerini kabul eder, ama Google çoğu ticari sorguda 100 ilâ 140 arasında bir yerde sonuç sunmayı bırakır. Daha fazlasını istemek daha fazla sonuç üretmez.

Günlük mü haftalık mı kontrol etmeliyim? Normal bir anahtar kelime kümesi için haftalık. Günlük yalnızca kısa bir para sorgusu listesi için. Büyük bir kümede günlük kontrol maliyeti yediye katlar ve çoğunlukla gürültüyü ölçer; verimizdeki ortalama günlük hareket 4,57 sıralamaydı.

API'den gelen sayım neden sıralama takip aracımdan farklı? Farklı cihazlar, farklı konumlar, farklı anlar ve çoğu zaman farklı veri kaynakları. Sayı bir örneklemdir. Bir şeyin değiştiği sonucuna varmadan önce isteğinizde konumu ve cihazı sabitleyip yeniden çekin.

Bir ajan bunu benim için çalıştırabilir mi? Evet ve iyi uyar, çünkü görevin her çalıştırmada şekli aynıdır. Bir ajanın sıralama işinde neleri üstlenebileceğinin daha geniş tablosu için SEO ajanı saha rehberine bakın. Karşılaştırma kuralını yazılı bir talimat dosyasında tutun ve farkı ajan üretsin; inşa et ya da satın al kararını bir insanda tutun.

Yazar: Rowan Blake, Auspia'da 100'den fazla yayın iş akışını yürüten içerik otomasyonu analisti. Otomatik veri iş akışları, zamanlanmış raporlama ve siz olmadan çalışan sistemlerin bakım maliyeti üzerine yazıyor.