Rate-Limits
API-Anfragen werden pro API-Schlüssel nach Ihrem Tarif begrenzt und in einem gleitenden Minutenfenster ausgewertet.
Paketbasierte Limits
Rate-Limits variieren nach Abonnement-Paket:
| Plan | Anfragen / Minute | Tageslimit |
|---|---|---|
| Business | 100 | 20,000 |
| Agency | 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