Naar hoofdinhoud gaan
De Enrow API past rate limits toe om eerlijk gebruik te garanderen en de servicekwaliteit te behouden. De limiet is hetzelfde voor alle endpoints en alle abonnementen, wordt afgedwongen per API key en wordt gemeten in requests per seconde (RPS). Deze pagina legt de standaardlimieten uit, wat er gebeurt wanneer je ze overschrijdt en hoe je binnen je quota blijft bij het opschalen.

​
Wat zijn de standaard rate limits?

Elk POST-endpoint staat 10 requests per seconde per API key toe. De limiet is identiek voor alle endpoints en alle abonnementen:
EndpointRate Limit
POST /email/find/single10 req/s
POST /email/find/bulk10 req/s
POST /email/verify/single10 req/s
POST /email/verify/bulk10 req/s
POST /phone/single10 req/s
POST /phone/bulk10 req/s
GET-endpoints zijn niet aan rate limits onderworpen, dus het ophalen van resultaten — bijvoorbeeld het single email-resultaat of bulk-resultaten — telt niet mee voor je quota.
Rate limits gelden per API key en worden gemeten in requests per seconde (RPS). Elke API key heeft zijn eigen onafhankelijke quota.

​
Wat gebeurt er als ik de rate limit overschrijd?

Wanneer je de rate limit overschrijdt, geeft de API een 429 Too Many Requests-response terug: 
{
  "message": "Too Many Requests"
}
De aanbevolen manier om een 429 af te handelen is het implementeren van exponential backoff — wacht voor elke nieuwe poging een steeds langere vertraging, zodat de API key tijd heeft om weer onder de limiet te komen: 
async function requestWithRetry(url, options, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    const response = await fetch(url, options);

    if (response.status === 429) {
      const delay = Math.pow(2, attempt) * 1000;
      await new Promise(resolve => setTimeout(resolve, delay));
      continue;
    }

    return response;
  }

  throw new Error('Max retries exceeded');
}
Voor de volledige lijst met responsecodes en hoe je ze afhandelt, zie Statuscodes en Foutafhandeling.

​
Hoe kan ik voorkomen dat ik de rate limit bereik?

De effectiefste manier om binnen je quota te blijven is het versturen van minder, grotere requests en het ontvangen van resultaten via webhooks in plaats van polling.
In plaats van 100 losse requests te doen, doe je 1 bulk-request (tot 5.000 items voor e-mail, 3.000 voor telefoon). Eén bulk-POST telt als 1 request voor je rate limit.
// ❌ 100 requests = 10 seconds at 10 RPS
for (const contact of contacts) {
  await findEmail(contact);
}

// ✅ 1 request
await findEmailsBulk(contacts);
Zie E-mails in bulk zoeken en E-mails in bulk verifiëren om te beginnen.
Het pollen van het GET-endpoint verspilt je rate limit-quota. Gebruik webhooks om resultaten automatisch te ontvangen zodra een zoekopdracht of verificatie is voltooid.
Sla resultaten op om overbodige API-calls voor hetzelfde contact te vermijden, wat ook credits bespaart.

​
Kan ik hogere rate limits krijgen?

Ja. Enrow kan je RPS per geval verhogen. Neem contact met ons op via api@enrow.io met je use case en verwachte volume.

​
FAQ

Nee. De limiet van 10 req/s geldt onafhankelijk voor elk POST-endpoint, en de quota wordt per API key bijgehouden in plaats van per account.
Nee. GET-endpoints zijn niet aan rate limits onderworpen, dus pollen voor resultaten verbruikt je RPS-quota niet. Dat gezegd hebbende, webhooks blijven de voorkeur hebben boven frequent pollen.
Ja. Eén bulk-POST telt als 1 request voor je rate limit, ook al kan deze tot 5.000 items voor e-mail of 3.000 voor telefoon bevatten.
Een 429 Too Many Requests-response met de body { "message": "Too Many Requests" }. Probeer het opnieuw met exponential backoff. Zie Foutafhandeling voor details.

​
Volgende stappen

E-mails in bulk zoeken

Voer tot 5.000 e-mailzoekopdrachten uit in één request om rate limit-quota te besparen.

Webhooks

Ontvang resultaten automatisch in plaats van de GET-endpoints te pollen.

Foutafhandeling

Handel 429 en andere responses netjes af in je integratie.

Credits & facturatie

Bekijk hoe credits worden verbruikt voor elk endpoint.