Rate limits

Rate limits skyddar API:et mot missbruk och säkrar rättvis användning för alla kunder. Varje API-nyckel har en förfrågningskvot som återställs varje timme. När du överskrider gränsen svarar förfrågningar med felet 429 (Too Many Requests) tills kvoten återställts.

Standard-rate-limits per API-nyckel: | Typ av gräns | Gräns | Återställningsperiod | |--------------|-------|----------------------| | Förfrågningar | 1 000/timme | Per timme | | Burst | 100/minut | Per minut | | Batchstorlek | 100 element | Per förfrågan | **Gränser per endpoint:** • E-postverifiering: 1 000/timme • E-postsökning: 500/timme • Berikning: 200/timme • Leadssökning: 500/timme • SEO-analys: 200/timme Behöver du högre gränser? Kontakta supporten för att diskutera enterprise-alternativ.

Varje svar innehåller rate-limit-information i headers: ``` X-RateLimit-Limit: 1000 X-RateLimit-Remaining: 856 X-RateLimit-Reset: 1709046000 Retry-After: 3600 ``` | Header | Beskrivning | |--------|-------------| | `X-RateLimit-Limit` | Maximalt antal tillåtna förfrågningar per timme | | `X-RateLimit-Remaining` | Återstående förfrågningar i aktuellt fönster | | `X-RateLimit-Reset` | Unix-tidsstämpel då gränsen återställs | | `Retry-After` | Sekunder tills du kan försöka igen (endast vid 429) |

När du får ett 429-svar — implementera 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); // Försök igen } return response; } ``` **Exponentiell backoff:** Vid upprepade misslyckanden, använd exponentiell backoff med jitter: ```javascript const delay = Math.min(baseDelay * 2 ** attempt + randomJitter, maxDelay); ```

Optimera ditt API-användande för att undvika rate limits: • **Använd batch-endpoints** – verifiera 100 e-postadresser i en förfrågan i stället för 100 • **Cacha svar** – hämta inte data du redan har • **Sprid förfrågningar** – skicka inte allt på en gång • **Bevaka headers** – håll koll på återstående kvot proaktivt • **Hantera fel snyggt** – implementera ordentlig retry-logik • **Använd webhooks** – vid asynkrona operationer, vänta på callbacks i stället för polling **Köbaserad approach:** ```javascript // Bearbeta förfrågningar med rate limiting const queue = new RateLimitedQueue({ maxConcurrent: 10, minDelay: 100 // ms mellan förfrågningar }); await queue.addAll(requests); ```