Kontingente & Limits

Die Nutzung wird durch zwei Limits geregelt: ein Monatskontingent (je Tarif) und ein Stundenlimit. Beide gelten pro API-Schlüssel.

Limit-Header#

Jede Antwort enthält Ihre aktuelle Nutzung, damit Sie proaktiv drosseln können:

X-RateLimit-Limit: 50000
X-RateLimit-Remaining: 48766
X-RateLimit-Reset: 1751328000
X-Plan: pro

• X-RateLimit-Limit — Ihr Monatskontingent.
• X-RateLimit-Remaining — verbleibende Aufrufe in dieser Periode.
• X-RateLimit-Reset — Unix-Zeit des Resets.
• X-Plan — Ihr aktueller Tarif.

Wenn Sie ein Limit erreichen#

Eine Überschreitung des Stundenlimits oder Monatskontingents liefert 429 Too Many Requests mit der Resetzeit. Aufrufe von /me zählen nicht zum Kontingent.

{
  "success": false,
  "error": "Monthly quota exceeded",
  "plan": "free",
  "limit": 1000,
  "resetAt": "2026-07-01T00:00:00.000Z"
}