Hız Sınırları

API istekleri, abonelik paketinize göre API anahtarı başına hız sınırına tabidir. Sınırlar dakika başına kayan pencere üzerinden uygulanır.

Paket Bazlı Sınırlar

Hız sınırları abonelik paketine göre değişir:

Plan İstek / Dakika Günlük Limit
Starter 60 10,000
Growth 300 50,000
Elite 1,000 200,000

Hız Sınırı Başlıkları

Her API yanıtı, yanıt başlıklarında hız sınırı bilgisi içerir:

Başlık Açıklama
X-RateLimit-Limit Mevcut pencerede izin verilen maksimum istek sayısı
X-RateLimit-Remaining Mevcut pencerede kalan istek sayısı
X-RateLimit-Reset Hız sınırının sıfırlandığı Unix zaman damgası

Örnek Yanıt Başlıkları

HTTP/1.1 200 OK
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 287
X-RateLimit-Reset: 1732780800

Sınırı Aşma

Hız sınırını aştığınızda 429 yanıtı alırsınız:

Örnek 429 Yanıtı 429 Too Many Requests
{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests. Please retry after 42 seconds.",
    "retry_after": 42
  }
}

En İyi Uygulamalar

  • 429 yanıtı aldığınızda üstel geri çekilme uygulayın
  • Veriler sık değişmediğinde yanıtları yerel olarak önbelleğe alın
  • Sınırlara ulaşmamak için X-RateLimit-Remaining başlıklarını izleyin
  • Toplam istek sayısını azaltmak için ilgili işlemleri gruplayın