API Platformu

Hata Kodları

API'nin döndürdüğü hata kodları ve anlamları.

Tüm hatalar, okunabilir bir mesaj ve büyük harfli bir hata kodu içeren JSON nesnesi olarak döner.

{
  "error": "Rate limit exceeded",
  "code": "RATE_LIMIT_EXCEEDED"
}

Error codes

Kod	HTTP	Anlamı
`INVALID_REQUEST`	400	İstek gövdesi hatalı veya zorunlu alan eksik
`KEYWORD_REQUIRED`	400	`keyword` alanı boş veya eksik
`URL_REQUIRED`	400	`url` alanı boş veya eksik
`INVALID_URL`	400	`url` `http://` veya `https://` ile başlamıyor
`INVALID_FORMAT`	400	`format` değeri `json` veya `raw` değil
`INVALID_MATCH_TYPE`	400	`match_type` geçersiz: `broad`, `phrase_match`, `exact_match`, `related`
`INVALID_CREDENTIALS`	401	Kullanıcı adı veya parola geçersiz
`INVALID_API_KEY`	401	Kimlik doğrulama başarısız
`CREDENTIALS_EXPIRED`	401	API kullanıcı bilgilerinin süresi dolmuş
`INSUFFICIENT_CREDITS`	402	Hesabınızda yeterli kredi yok
`IP_NOT_WHITELISTED`	403	IP adresiniz beyaz listede değil
`RATE_LIMIT_EXCEEDED`	429	Rate limit aşıldı
`INTERNAL_ERROR`	500	Sunucu tarafında bir hata oluştu
`SERP_FAILED`	502	Arama sonuçları alınamadı
`WORKER_FAILED`	502	Veri alınamadı
`SCRAPE_FAILED`	502	Hedef sayfa alınamadı
`AUDIT_FAILED`	502	Denetim tamamlanamadı
`TARGET_UNREACHABLE`	502	Hedef siteye ulaşılamadı
`TARGET_BLOCKED`	502	Hedef site isteği engelledi
`TIMEOUT`	504	İstek zaman aşımına uğradı — bkz. aşağıdaki not
`TARGET_REQUIRED`	400	target alanı boş veya eksik
`INVALID_TARGET`	400	target geçerli bir domain veya URL değil
`INVALID_TYPE`	400	Bilinmeyen rapor tipi
`TYPE_UNAVAILABLE`	400	Bu rapor tipi henüz kullanılabilir değil
`INVALID_FILTER`	400	Bilinmeyen filtre alanı, hatalı operatör veya çok fazla koşul
`INVALID_ORDER_BY`	400	Bilinmeyen sıralama alanı veya 3'ten fazla sıralama kuralı
`INVALID_DATE_RANGE`	400	date_from, date_to'dan sonra veya tarihler okunamıyor
`INVALID_CURSOR`	400	Sayfalama cursor'ı bilinmiyor veya süresi dolmuş
`SERVICE_NOT_ENABLED`	403	Bu servis hesabınızda etkin değil
`REQUEST_IN_PROGRESS`	409	Aynı idempotency_key ile bir request zaten çalışıyor
`REQUEST_TOO_LARGE`	413	Request body boyut sınırını aşıyor
`REQUEST_FAILED`	502	Request tamamlanamadı
`EMPTY_RESULTS`	200	Sorgu için sonuç bulunamadı

Zaman aşımı süresi

Zaman aşımı üst sınırı endpoint'e göre değişir: SERP, Keyword Data ve Google Images için 10 dakika, Technical SEO için 2 dakika.

EMPTY_RESULTS

EMPTY_RESULTS bir hata değildir — istek başarılıdır (200), yalnızca sorgu için sonuç bulunamamıştır.

Son güncelleme: 2026-08-21