Documentatie

Aanvraaglimieten

Om eerlijk gebruik en systeemstabiliteit te waarborgen, past onze API aanvraaglimieten toe. Verschillende abonnementen hebben verschillende aanvraaglimieten.

Wat je abonnement bevat

Je maandelijkse limiet komt uit je abonnement. Het is één gedeelde limiet voor alle producten, en elke gemeten aanroep telt er één keer op.

Free: 30.000 verzoeken per maand, gemiddeld ongeveer 1.000 per dag, zonder daglimiet.

Betaalde abonnementen: Starter 150.000, Pro 500.000 en Business 2.000.000 verzoeken per maand. Enterprise is onbeperkt.

Demo-endpoint: Het demo-endpoint zonder sleutel staat ongeveer 100 verzoeken per dag per IP-adres toe en vraagt geen registratie.

GET /v1/demo/{ip}

Aanvraaglimiet-headers

Alle API-antwoorden bevatten headers die informatie geven over uw huidige aanvraaglimietstatus:

X-RateLimit-Limit: Maximaal aantal aanvragen dat is toegestaan in het huidige tijdvenster

X-RateLimit-Remaining: Aantal resterende aanvragen in het huidige tijdvenster

X-RateLimit-Reset: Tijdstip waarop het aanvraaglimietvenster wordt gereset (Unix-tijdstempel)

Aanvraaglimiet overschreden

Als u uw aanvraaglimiet overschrijdt, geeft de API een antwoord 429 Too Many Requests met de volgende inhoud:

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded. Please try again later.",
  "retryAfter": 60
}

Best practices

Implementeer backoff: Wanneer u een aanvraaglimietfout ontvangt, implementeer dan exponentiële backoff voordat u het opnieuw probeert.

Antwoorden cachen: Cache API-antwoorden waar mogelijk om het aantal aanvragen te verminderen.