429: Rate-Limits und Tageskontingente

Herausgegeben von Argorant

Was ein 429 bei der Argorant-API bedeutet: Rate-Limits und Tageskontingente, die mit deiner Stufe wachsen, wie du wartest und weitermachst und warum nie eine Anfrage oder ein Credit verloren geht.

Ein 429 heißt, du hast ein Rate-Limit oder das Tageskontingent für diese Aktion erreicht. Die Limits wachsen mit deiner Stufe, und der Account-Endpunkt zeigt dir genau, wo du stehst. Anfragen pro Minute gelten pro Key; Suchen und Zählungen pro Minute teilt sich das ganze Konto, ein zweiter Key bringt also nicht mehr. Mit einem Plan haben Suchen und Zählungen kein Tageslimit; in der Testphase gibt es eins, höher über einen KI-Assistenten.

Zuerst deinen Stand ansehen

npx argorant whoami

Die Übersicht zum Kontingent zeigt für den aktuellen Tag pro Aktion Verbrauch gegenüber Limit: Zählanfragen, Vorschauzeilen, freigeschaltete Zeilen, Exportzeilen und Prüfanfragen. Konten ohne Tagesgrenze werden als unbegrenzt angezeigt.

Was du tust

  1. Warte ab. Ein exponentiell wachsender Abstand zwischen Versuchen mit etwas Zufall ist die richtige Form, keine enge Schleife.
  2. Bündle statt einzeln zu iterieren. Ein Export mit 1.000 Zeilen ist ein Auftrag. Tausend einzelne Freischaltungen sind tausend Anfragen.
  3. Für die Verifizierung schick Batches mit bis zu 500 Adressen pro Anfrage statt eines Aufrufs pro Adresse.
  4. Wenn du ein Tageskontingent erreicht hast und kein kurzfristiges Limit, hilft Zeit oder eine höhere Stufe, keine Wiederholung.
Der Kontingent-Bereich von whoami mit dem heutigen Verbrauch gegenüber den Limits
Der Kontingent-Bereich von whoami mit dem heutigen Verbrauch gegenüber den Limits

Für Agenten

Die CLI endet bei einem 429 mit Code 4. Behandle das als Signal für die Planung: Lauf pausieren, die verbleibende Arbeit melden und später weitermachen. Alles schon Erstellte ist sicher. Bereits berechnete Exporte bleiben mit argorant export download herunterladbar, ein Rate-Limit kostet dich also nie einen fertigen Auftrag.

Zählungen und Vorschauen sind kostenlos, aber trotzdem begrenzt, denn eine außer Kontrolle geratene Schleife bleibt eine, egal was sie kostet.

Kommst du nicht weiter? support@argorant.com