Rate-Limits

API-Anfragen werden pro API-Schlüssel basierend auf Ihrem Abonnement-Paket begrenzt. Limits werden auf einem gleitenden Minutenfenster angewendet.

Paketbasierte Limits

Rate-Limits variieren nach Abonnement-Paket:

Plan Anfragen / Minute Tageslimit
Starter 60 10,000
Growth 300 50,000
Elite 1,000 200,000

Rate-Limit-Header

Jede API-Antwort enthält Rate-Limit-Informationen in den Antwort-Headern:

Header Beschreibung
X-RateLimit-Limit Maximale Anfragen im aktuellen Fenster erlaubt
X-RateLimit-Remaining Verbleibende Anfragen im aktuellen Fenster
X-RateLimit-Reset Unix-Zeitstempel, wann das Rate-Limit zurückgesetzt wird

Beispiel-Antwort-Header

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

Limit überschritten

Wenn Sie das Rate-Limit überschreiten, erhalten Sie eine 429-Antwort:

Beispiel 429-Antwort 429 Too Many Requests 
{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests. Please retry after 42 seconds.",
    "retry_after": 42
  }
}

Best Practices

  • Implementieren Sie exponentielles Backoff bei 429-Antworten
  • Cachen Sie Antworten lokal, wenn sich Daten nicht häufig ändern
  • Überwachen Sie X-RateLimit-Remaining-Header, um Limits nicht zu erreichen
  • Gruppieren Sie verwandte Operationen, um die Gesamtzahl der Anfragen zu reduzieren