company logo

Help center

Zu Surfer wechseln
Alle SammlungenIntegrationen, MCP & APIAPISurfer API Rate Limits & Quotas

Surfer API Rate Limits & Quotas

Eine Kurzreferenz für Rate Limits pro Endpunkt, Nutzungskontingente pro Tool und wie Sie diese programmgesteuert überwachen können, damit Ihre Integrationen nicht unerwartet an Grenzen stoßen.

⏱ Ratenlimits

Alle Endpunkte erzwingen ein pro Sekunde oder pro Minute Ratenlimit. Das Überschreiten gibt 429 Too Many Requests zurück.

Endpunktgruppe

Ratenbegrenzung

Die meisten Endpunkte (GET + POST)

10 Anfragen / Sek.

SERP Analyzer Batch

10 Anfragen / Min.

KI-Detektor

60 Anfragen / Min.

Wenn Sie auf einen 429-Fehler stoßen, warten Sie, bevor Sie es erneut versuchen. Überprüfen Sie den Retry-After Header in der Antwort, um zu sehen, wie lange Sie warten müssen, und versuchen Sie es dann erneut. Verwenden Sie exponentielles Backoff für automatisierte Workflows.

Überwachung von Rate Limits über Response-Header

Jede V2 API-Antwort enthält diese Header, damit Sie die Limits verfolgen können, bevor Sie sie erreichen:

Kopfzeile

Typ

Was es Ihnen mitteilt

x-ratelimit-limit

integer

Maximale Anfragen, die im aktuellen Fenster für diesen Endpunkt zulässig sind

x-ratelimit-remaining

integer

Verbleibende Anfragen, bevor Sie ratenbegrenzt werden (0 = die nächste Anfrage wird blockiert)

x-ratelimit-reset

integer

Unix-Zeitstempel (Sekunden), wenn das Fenster zurückgesetzt wird

Das Lesen von x-ratelimit-remaining in Ihrer Integration ermöglicht es Ihnen, proaktiv langsamer zu werden, anstatt auf einen 429-Fehler zu warten.


📊 Nutzungskontingente

Kontingente unterscheiden sich von Ratenlimits und verfolgen, wie viele Abfragen Sie in einem Abrechnungszeitraum verbraucht haben. Die folgenden Limits entsprechen unserer Fair Usage Policy für Ihre Sicherheit. Während Enterprise-Limits benutzerdefiniert sind, kontaktieren Sie Ihren Customer Success Manager, um Ihr Kontingent zu überprüfen, oder sehen Sie sich Ihr Nutzungs-Dashboard unter Einstellungen an.

Tool

Kontingent (monatlich · jährlich)

Was passiert bei Überschreitung

Content Editor (Dokumente)

500 / Monat · 6.000 / Jahr (Peace of Mind) · Benutzerdefiniert (Enterprise)

422 Quota exceeded

Audit

100 / Monat · 1.200 / Jahr

422 Quota exceeded

SERP Analyzer

100 Abfragen / Tag

422 Quota exceeded

Auto-Optimize

100 / Tag

422 Quota exceeded

Humanizer & AI Detector

50.000 Wörter / Monat · 600.000 Wörter / Jahr (alle Pläne)

422 Quota exceeded

success icon
Hinweis: Es gibt derzeit keinen API-Endpunkt, um verbleibende Credits oder Kontingentnutzung programmgesteuert zu überprüfen. Um zu vermeiden, dass Sie während einer Ausführung an Limits stoßen, verfolgen Sie Ihre eigene Nutzung oder überprüfen Sie Ihr Dashboard vor großen Batch-Jobs.

Zusätzliche Ressourcen:

Surfer API Einführung

Surfer API Dokumentation (v1)

Surfer API Dokumentation (v2)

Surfer API Anwendungsbeispiele

War diese Antwort hilfreich für dich?
😞
😐
😁