API dokümantasyonu

Kimlik doğrulama

Hesabınızda bir anahtar oluşturun ve HTTPS üzerinden Bearer anahtarı olarak gönderin.

Arama isteği

Anahtar kelime, ülke, dil ve cihaz bilgisiyle POST isteği gönderin.

curl -X POST https://api.serper.live/v1/search \
  -H "Authorization: Bearer sl_live_YOUR_TOKEN" \
  -H "Idempotency-Key: 0199860b-2f4e-7a1c-9b3d-5e6f70819a2b" \
  -H "Content-Type: application/json" \
  -d '{"query":"best coffee shops","country":"TR","device":"desktop"}'

Yanıt biçimi

Başarılı yanıt, güncel organik sonuçlar ve sorgu bilgilerini içerir. Sorgu hizmeti başka sonuç türleri ekleyebilir.

{
  "requestId": "6b1f…",
  "query": "best coffee shops",
  "country": "TR",
  "language": "…",
  "device": "desktop",
  "fetchedAt": "2026-09-26T14:00:00.000Z",
  "latencyMs": 18342,
  "price": 0.1,
  "currency": "USD",
  "organic": [
    { "position": 1, "title": "…", "url": "https://…", "domain": "example.com", "snippet": "…" }
  ]
}

Ücretlendirme ve hatalar

Ücret sorgudan önce ayrılır. Başarılı sorgular ücretlendirilir; başarısız olanlar iade edilir. HTTP 402 yetersiz bakiye, 409 Idempotency-Key çakışması, 503 ise hizmetin kapasite sınırında olduğu anlamına gelir.

Sınırlar

Anahtar kelimeler en fazla 120 karakter olabilir. Kullanılabilir ülkeler: Türkiye. Her isteğe benzersiz Idempotency-Key ekleyin.