Canlı organik sonuçlar için Google Custom Search JSON API alternatifi

Ne değişiyor

Google dokümantasyonuna göre Custom Search JSON API yeni müşterilere kapalı ve mevcut müşterilerin alternatif bir çözüme geçmek için 1 Ocak 2027'ye kadar süresi var. Aynı sayfa API'yi, sizin yapılandırdığınız ve cx ile tanımladığınız motor olan Programmable Search Engine'den web ve görsel sonuçları alan bir API olarak tanımlar.

Tarihler ve koşullar Google'a aittir ve değişebilir; bir son tarih belirlemeden önce Google'ın sayfasından doğrulayın.

Serper.live bunun yerine ne döndürür

Serper.live canlı bir Google SERP API'dir: her istek, seçtiğiniz ülke ve cihaz için gerçek bir Google araması yapar ve o anda gösterilen organik sonuçları, istek başına en fazla 100 tane (varsayılan 10), JSON olarak döndürür.

Kendi başına bir arama motoru değildir, site içi arama da değildir: yapılandırılacak motor yok, sayfalarınızın dizini yok. Bir istek Google'ı canlı yüklediği için genellikle 2–3 saniye sürer ve ön ödemeli bakiyeden istek başına ücretlendirilir.

Custom Search entegrasyonunuz size Google'ın bir sorgu için neyi sıraladığını gösteriyorduysa, daha yakın seçenek budur. Kendi sitenizin içinde ya da sabit bir alan adı listesinde aramayı çalıştırıyorduysa, bunun yerine bir site içi arama ürününe ihtiyacınız var: Google dokümantasyonu bu durum için Vertex AI Search'ü işaret ediyor.

Parametre eşlemesi

Solda Custom Search JSON API, sağda Serper.live:

• q → query: anahtar kelime, 2–120 karakter.
• gl → country: GET /v1/countries listesindeki açık bir pazarın iki harfli kodu (şu anda Almanya, Fransa, Birleşik Krallık, Türkiye, Ukrayna ve Amerika Birleşik Devletleri).
• hl → language: Google'ın arayüz dili; isteğe bağlı, varsayılan olarak ülkenin dili.
• num → limit: istek başına organik sonuç sayısı, 1–100 (varsayılan 10; başlanan her 10'luk blok bir pazar fiyatına mal olur).
• start → karşılığı yok: sayfalama yerine limit değerini yükseltin; tek çağrı en fazla 100 organik sonuç döndürür.
• cx → gerekmez: yapılandırılacak motor yoktur, istek pazar için Google'da arama yapar.
• key → sl_live_ anahtarınızı taşıyan bir Authorization: Bearer başlığı.
• items[] → organic[]: link, url olur; displayLink kabaca domain olur; title ve snippet adlarını korur ve snippet değeri null olabilir.

Geçiş adımları

Aşağıdaki istek entegrasyonun tamamıdır; çevresindeki adımlar:

1. Hesap oluşturun, bir anahtar alın ve $5'dan itibaren USDT veya USDC ile bakiye yükleyin.
2. Custom Search uç noktasına yapılan GET isteğini POST https://api.serper.live/v1/search, bir JSON gövdesi ve Authorization başlığıyla değiştirin.
3. Parametreleri yukarıdaki gibi eşleyin; cx ve start parametrelerini kaldırın.
4. items[] yerine organic[] okuyun, link alanını url olarak yeniden adlandırın ve null olabilen snippet değerini ele alın.
5. HTTP zaman aşımını en az 100 saniyeye çıkarın ve çağrıyı kullanıcının isteği içinde çalıştırmak yerine kuyruğa alın: canlı bir arama genellikle 2–3 saniye sürer, bir pazar için aradan sonraki ilk arama daha uzun.
6. Tekrarlanan bir çağrının iki kez ücretlendirilmemesi için Idempotency-Key gönderin.
7. İkisini birkaç gün yan yana çalıştırın, karşılaştırın, sonra geçin.

curl -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"}'

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' }),
    signal: AbortSignal.timeout(100000),
});
const result = await response.json();

console.log(result.organic);

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"},
    timeout=100,
)
print(response.json()["organic"])