Rate Limits

Rate Limits schützen die API vor Missbrauch und sorgen für faire Nutzung durch alle Kunden. Jeder API-Schlüssel hat eine Anfragenquote, die stündlich zurückgesetzt wird. Wird Ihr Limit überschritten, antworten Anfragen mit Fehler 429 (Too Many Requests), bis das Limit zurückgesetzt wird.

Standardlimits pro API-Schlüssel: | Limit-Typ | Limit | Reset-Periode | |-----------|-------|---------------| | Anfragen | 1.000/Stunde | Stündlich | | Burst | 100/Minute | Pro Minute | | Batch-Größe | 100 Elemente | Pro Anfrage | **Limits pro Endpoint:** • E-Mail-Verifizierung: 1.000/Stunde • E-Mail-Suche: 500/Stunde • Anreicherung: 200/Stunde • Lead-Suche: 500/Stunde • SEO-Analyse: 200/Stunde Höhere Limits nötig? Kontaktieren Sie den Support, um Enterprise-Optionen zu besprechen.

Jede Antwort enthält Rate-Limit-Informationen in den Headern: ``` X-RateLimit-Limit: 1000 X-RateLimit-Remaining: 856 X-RateLimit-Reset: 1709046000 Retry-After: 3600 ``` | Header | Beschreibung | |--------|--------------| | `X-RateLimit-Limit` | Maximale Anfragen pro Stunde | | `X-RateLimit-Remaining` | Verbleibende Anfragen im aktuellen Fenster | | `X-RateLimit-Reset` | Unix-Timestamp, wann das Limit zurückgesetzt wird | | `Retry-After` | Sekunden bis zum nächsten Versuch (nur bei 429) |

Wenn Sie eine 429-Antwort erhalten, implementieren Sie Retry-Logik: ```javascript async function makeRequest(url, options) { const response = await fetch(url, options); if (response.status === 429) { const retryAfter = response.headers.get('Retry-After') || 60; await sleep(retryAfter * 1000); return makeRequest(url, options); // Erneut versuchen } return response; } ``` **Exponentielles Backoff:** Bei wiederholten Fehlschlägen exponentielles Backoff mit Jitter verwenden: ```javascript const delay = Math.min(baseDelay * 2 ** attempt + randomJitter, maxDelay); ```

Optimieren Sie Ihre API-Nutzung, um Rate Limits zu vermeiden: • **Nutzen Sie Batch-Endpoints** – verifizieren Sie 100 E-Mails in einer Anfrage statt in 100 Anfragen • **Cachen Sie Antworten** – holen Sie keine Daten erneut, die Sie schon haben • **Verteilen Sie Anfragen** – feuern Sie nicht alle gleichzeitig ab • **Beobachten Sie die Header** – behalten Sie Restquoten proaktiv im Blick • **Behandeln Sie Fehler sauber** – implementieren Sie ordentliche Retry-Logik • **Nutzen Sie Webhooks** – warten Sie bei Async-Operationen auf Callbacks statt zu pollen **Queue-basierter Ansatz:** ```javascript // Anfragen mit Rate-Limiting verarbeiten const queue = new RateLimitedQueue({ maxConcurrent: 10, minDelay: 100 // ms zwischen Anfragen }); await queue.addAll(requests); ```