Sıralama takip API: ülke ve cihaza göre canlı Google ilk 10 sırası

Neden sıralama takip SaaS'ı yerine SERP API

Bir sıralama takip hizmeti size kendi zamanlamasını, anahtar kelime sınırlarını ve raporlarını satar. Bir SERP API ise ham maddeyi satar: her anahtar kelime için canlı ilk 10 ya da ilk 100; zamanlama, depolama ve raporlama sizin elinizdedir.

Bu, Serper.live'ı sahibi olduğunuz bir takip aracının arka ucu yapar: bir ajans paneli, SEO ürününüzdeki bir modül, sıraları veritabanınıza yazan gecelik bir iş. Kullanıcı başına ücret yok, anahtar kelime kotası yok, proje başına plan yok; fatura, arama sayısının pazar fiyatıyla çarpımıdır.

Bunun bedeli de açık: zamanlayıcıyı ve depolamayı siz yazarsınız ve her kontrol, birkaç saniye süren gerçek bir Google aramasıdır. Buna karşılık kaydedilen her sıra bilinen bir zamanda, bilinen bir ülke ve cihaz için çekilmiştir; asla önbellekten değil.

Bir anahtar kelimenin sırası nasıl alınır

Her anahtar kelime, ülke ve cihaz için bir istek. Tam başvuru dokümantasyonda; kodunuzdaki mantık dört adımdır ve aşağıdaki örnek, aynı isteğin curl, JavaScript ve Python halidir:

1. query, country ve device ile, isteğe bağlı olarak language ve limit ile POST /v1/search gönderin. Canlı bir arama genellikle 2–3 saniyede yanıt verir, bir pazara aradan sonra gönderilen ilk arama daha uzun sürer: istemci zaman aşımını en az 100 saniye yapın ve kontrolleri bir kuyruktan çalıştırın.
2. organic[] dizisini okuyun. Her kayıtta Google'ın gösterdiği sırayla position, title, url, domain ve snippet bulunur.
3. domain değeri izlediğiniz siteyle eşleşen kaydı bulun ve position değerini fetchedAt ve requestId ile birlikte kaydedin. Bir alt alan adının kök alan adı için sayılıp sayılmayacağına önceden karar verin ve baştaki www. kısmını yok sayın.
4. Eşleşme olmaması, o kontrol için istenen aralığın, varsayılan olarak ilk 10'un, dışında demektir. Bunu da kaydedin: ilk 10'dan düşen bir anahtar kelime, tam da bir takip aracının yakalamak için var olduğu şeydir.

curl -s -X POST https://api.serper.live/v1/search \
  -H "Authorization: Bearer sl_live_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"best coffee shops","country":"DE","device":"desktop"}' \
  | jq '.organic[] | select(.domain == "example.com") | .position'

const response = await fetch('https://api.serper.live/v1/search', {
    method: 'POST',
    headers: {
        Authorization: 'Bearer sl_live_YOUR_TOKEN',
        'Content-Type': 'application/json',
    },
    body: JSON.stringify({ query: 'best coffee shops', country: 'DE', device: 'desktop' }),
    signal: AbortSignal.timeout(100000),
});
const { organic } = await response.json();
const hit = organic.find(row => row.domain === 'example.com');

console.log(hit ? hit.position : 'outside the top 10');

import requests

response = requests.post(
    "https://api.serper.live/v1/search",
    headers={"Authorization": "Bearer sl_live_YOUR_TOKEN"},
    json={"query": "best coffee shops", "country": "DE", "device": "desktop"},
    timeout=100,
)
organic = response.json()["organic"]
position = next((row["position"] for row in organic if row["domain"] == "example.com"), None)
print(position or "outside the top 10")

Pazarlar ve cihazlar

Şu anda açık pazarlar: Almanya, Fransa, Birleşik Krallık, Türkiye, Ukrayna ve Amerika Birleşik Devletleri. Her pazarın country olarak gönderdiğiniz iki harfli bir kodu, language ile değiştirebileceğiniz varsayılan bir Google arayüz dili ve aynı fiyata hem masaüstü hem mobil seçeneği vardır.

Yeni pazarlar açıldıkça GET /v1/countries yanıtında ve fiyat sayfasında görünür; entegrasyonunuz değişmez.

Maliyeti nedir

Bir kontrol, bir istektir: anahtar kelime, ülke ve cihaz başına en düşük $0.01; bu da 1.000 kontrol için $10.00 eder. Abonelik yoktur ve bakiye $5'dan itibaren USDT veya USDC ile ön ödemelidir; süresi asla dolmaz.

Örnek: günde bir kez, tek cihazda kontrol edilen 500 anahtar kelime ayda yaklaşık 15.000 istek eder. Bunu pazarınızın fiyatıyla çarpın ya da sayıyı fiyat sayfasındaki hesaplayıcıya yazın. Masaüstü ve mobil sayıyı ikiye katlar; günde iki kontrol bir daha ikiye katlar.

Bilmeniz gereken sınırlar

• Canlı bir arama genellikle 2–3 saniye sürer, bir pazar için aradan sonraki ilk arama daha uzun. Verimi planlayın: kontrolleri bir kuyruktan eşzamanlı çalıştırın ve istemci zaman aşımını en az 100 saniye yapın.
• Sıralar istediğiniz kadar derine iner: limit 1–100, varsayılan 10. Başlanan her 10'luk blok bir pazar fiyatına mal olur; ilk 30 kontrolü üç fiyat ayırır ve yalnızca sonuç alan blokların ücretini tutar. İstenen aralığın dışındaki bir site bir sıra olarak değil, yok olarak raporlanır.
• Hiçbir şey önbelleğe alınmaz. İki özdeş istek iki canlı arama ve iki ücrettir; sonuçları kendi tarafınızda saklayın.
• Sonuçlar gönderdiğiniz ülke, cihaz ve dile özgüdür. Bir sırayı yalnızca aynı üç değerle yapılmış önceki kontrollerle karşılaştırın.
• Google, sonuçları kontroller arasında ve zaman içinde değiştirir. Tek bir canlı kontrol bir örneklemdir; raporlanacak sinyal, günler içindeki eğilimdir.

Tek bir anahtar kelimeyle başlayın

Kod yazmadan önce deneyin: deneme alanı, hesap gerekmeden IP adresi başına günde üç canlı arama çalıştırır ve alan adı kutusu sırayı hemen gösterir. Sonra hesap oluşturun, $5'dan itibaren bakiye yükleyin ve ilk isteği hızlı başlangıçtan gönderin.