Zum Inhalt springen

Ratenbegrenzungen

Limits pro Tarif

Jeder Arbeitsbereich hat ein Budget pro Minute und ein Spitzenfenster: höchstens das 2-Fache der durchschnittlichen Rate in beliebigen 10 Sekunden. Was zuerst aufgebraucht ist, wird mit 429 rate_limited und Retry-After beantwortet. Ihre eigene Nutzung der App zählt nie gegen das API-Budget.

TarifPro MinuteSpitzeEnthalten / MonatJobs gleichzeitig
Pro6020 / 10 s4.0002
Business600200 / 10 s12.0005
Enterpriseindividuellindividuellindividuellindividuell

Antwort-Header

X-RateLimit-LimitErlaubte Anfragen pro Minute für den Arbeitsbereich.
X-RateLimit-RemainingVerbleibende Anfragen in der aktuellen Minute.
X-RateLimit-ResetSekunden bis zum Zurücksetzen des Minutenfensters (keine Unix-Zeit).
Retry-AfterBei jedem 429: Sekunden, die vor einem neuen Versuch zu warten sind.
X-Request-IdDie ID der Anfrage, auch in Fehler-Bodys. Nennen Sie sie dem Support.
Idempotent-Replayedtrue, wenn die Antwort ein Replay einer früheren Anfrage ist.

Anfragen pro Monat

Jeder Tarif enthält eine Anzahl Anfragen pro Kalendermonat (UTC). Die Nutzung steht in Settings → API neben Latenz und Fehlerrate der letzten 30 Tage. Eine Überschreitung wird heute nicht abgelehnt; jede Änderung kündigen wir zuerst hier und im Änderungsprotokoll an.

Aufwendige Arbeit

Massenläufe und ZIP-Exporte laufen im Hintergrund und teilen sich die gleichzeitigen Jobs des Tarifs; weitere warten in einer Warteschlange. Verfolgen Sie sie per Abfrage oder mit den Webhooks bulk.completed und export.completed, statt in enger Schleife abzufragen.