Rate-Limits & Kontingente
Zwei Limits laufen parallel: ein monatliches Request-Kontingent, das an deinen Tarif gebunden ist, und ein Rate-Limit pro Minute. Wenn eines davon erreicht wird, erhältst du 429.
Tarif-Limits
| Tier | Pro Monat | Pro Minute | Preis |
|---|---|---|---|
| FREE | 1.000 | 10 | €0 |
| STARTER | 50.000 | 60 | €9,99 |
| GROWTH | 500.000 | 300 | €49,99 |
| SCALE | 5.000.000 | 1.000 | €149,99 |
Zählung
- Jeder authentifizierte Aufruf von
/v1/products/*erhöht den Zähler um 1. 404-Antworten zählen mit, weil das Kontingent nach gültiger Authentifizierung und vor dem Endpoint-Handler erhöht wird.- Fehlende oder ungültige Schlüssel zählen nicht zu deinem Monatskontingent. Per-Minute-
429-Antworten erhöhen nur den Burst-Zähler; Monatskontingent-429s erhöhen das Monatskontingent nicht weiter. - Öffentliche
/v1/stats-Aufrufe zählen nicht mit. - Zähler gelten pro Schlüssel. Deine gesamte monatliche Nutzung ist die Summe über alle Schlüssel.
- Der Monatszähler wird zu Beginn jedes Kalendermonats zurückgesetzt (UTC).
- Der Minutenzähler wird jede Wanduhren-Minute zurückgesetzt (UTC).
Response-Header
Jede authentifizierte Antwort enthält:
X-RateLimit-Limit: 50000
X-RateLimit-Remaining: 49873Diese Werte spiegeln dein monatliches Kontingent in deinem aktuellen Tarif wider. Es gibt keinen Header für den Minutenzähler — behandle 429 mit Back-off.
Wenn du ein Limit erreichst
Du erhältst 429 Too Many Requests mit einem Body wie:
{
"error": "Monthly quota exceeded.",
"limit": 1000,
"tier": "FREE"
}Bei Per-Minute-Treffern wird ein Retry-After: 60-Header mitgesendet.
Upgrade mitten im Monat
Upgrades werden sofort wirksam. Dein Monatszähler wird nicht zurückgesetzt — das neue Limit gilt für den vorhandenen Zählerstand. Beispiel: Du hast 950 von 1.000 im Free-Tarif verbraucht; ein Upgrade auf Starter macht sofort 49.050 Requests für den Rest des Monats verfügbar.