Gebruikslimieten

Limieten per pakket

Pakket	Per minuut	Per dag	Tegelijk
Proefperiode	60	5.000	2
Basis	60	5.000	2
Team	120	20.000	4
Pro	300	50.000	6

• Per minuut en per dag tellen aanvragen per kalenderminuut en kalenderdag. Bij een nieuw venster begint de teller weer op nul.
• Tegelijk is het aantal aanvragen dat tegelijk loopt.
• De limieten gelden voor de hele organisatie, niet per sleutel. Meerdere sleutels delen dus dezelfde ruimte.
• Elke pagina die je ophaalt is één aanvraag. Aanvragen die worden afgewezen omdat ze onjuist zijn opgebouwd (bijvoorbeeld een 400 of 404), tellen niet mee.

Daarnaast geldt een vangnet per IP-adres van 400 aanvragen per minuut, ongeacht je pakket.

Zien hoeveel je nog over hebt

Elk antwoord met een geldige sleutel bevat twee headers:

• X-RateLimit-Remaining: aanvragen die je nog over hebt in de huidige minuut.
• X-RateLimit-Remaining-Day: aanvragen die je nog over hebt vandaag.

Bij een 429

Overschrijd je een limiet, dan krijg je 429 rate_limited met een Retry-After-header. Die zegt hoeveel seconden je moet wachten:

• bij te veel tegelijk lopende aanvragen: 1 seconde;
• bij de minuutlimiet: tot het begin van de volgende minuut;
• bij de daglimiet: tot middernacht UTC (01:00 of 02:00 Nederlandse tijd, afhankelijk van zomer- of wintertijd);
• bij het IP-vangnet: 60 seconden.

Wacht de aangegeven tijd en probeer het dan opnieuw. Verstuur je aanvragen één voor één in plaats van tegelijk, dan loop je niet tegen de limiet voor gelijktijdige aanvragen aan.

Onze tip: haal grote tabellen incrementeel op, zie Incrementeel ophalen, en gebruik limit=1000. Dat scheelt je veel aanvragen.