TL;DR
7 min leestijdDe Data API van Reddit staat 100 queries per minuut per OAuth-client-id toe, gemiddeld over een rollend venster van tien minuten, wat neerkomt op 1.000 queries per venster en 6.000 per uur. Elk antwoord bevat X-Ratelimit-Used, X-Ratelimit-Remaining en X-Ratelimit-Reset, zodat je het resterende budget kunt aflezen voordat je het uitgeeft. Ga je over de limiet, dan antwoordt Reddit met 429; commercieel gebruik vereist een apart contract, hoe weinig queries je ook stuurt.
Wat is de rate limit van de Reddit API?
De Data API van Reddit hanteert rate limits van 100 queries per minuut per OAuth-client-id, gemiddeld over een rollend venster van tien minuten, volgens de Reddit Data API Wiki. Dat middelen is wat je ontwerp bepaalt: Reddit meet het gemiddelde over tien minuten in plaats van elke minuut los, dus je echte budget is 1.000 queries per venster en 6.000 per uur, en je kunt in één minuut boven de 100 uitpieken zolang het gemiddelde over het venster klopt. Stem je pollinglus af op het venster, niet op het kopcijfer per minuut.
| Limiet | Waarde | Waar Reddit het vermeldt |
|---|---|---|
| Geauthenticeerde queries | 100 queries per minuut (QPM) per OAuth-client-id | Reddit Data API Wiki |
| Middelingsvenster | Momenteel 10 minuten, om pieken mogelijk te maken | Reddit Data API Wiki |
| Effectief budget per venster | 1.000 queries per rollende 10 minuten | Afgeleid uit de twee rijen hierboven |
| Niet-geauthenticeerd verkeer | Volledig geblokkeerd; de standaard rate limit geldt niet | Reddit Data API Wiki |
| Chatberichten | 2.000 per dag per ontvanger, 3.000 per dag in totaal | Reddit Data API Wiki |
| Chatrooms, botaccounts | Tot 300 keer per dag toetreden | Reddit Data API Wiki |
| Oud gepubliceerd cijfer | 60 verzoeken per minuut voor OAuth2-clients | reddit-archive-wiki op GitHub |
Laatst gecontroleerd: 8 september 2026
Welk getal is actueel, 60 of 100?
Het actuele cijfer is 100 QPM, en de 60 komt uit documentatie die Reddit zelf als verouderd markeert. Reddits gearchiveerde API-wiki op GitHub zegt nog steeds "Clients connecting via OAuth2 may make up to 60 requests per minute" en heeft geen versiestempel, en daarom duikt hij steeds weer op in antwoorden op Stack Overflow. De Data API Wiki op het supportdomein, die opent met Reddits waarschuwing dat oude API-documentatie "mogelijk verouderd is", is de pagina die 100 QPM en het gemiddelde over tien minuten noemt. Bouw op 100 QPM en dateer elke bron die 60 noemt als van voor 2023.
De toegangsregels veranderden in dezelfde periode. De Data API Terms van Reddit hebben 19 juni 2023 als ingangsdatum en 20 juli 2026 als laatste revisie, dus alles van voor medio 2023 beschrijft een ander product. Lees wat toegang tot de Data API kost zodra je niet meer gratis in aanmerking komt samen met deze limieten.
Hoe lees je de X-Ratelimit-headers in het antwoord?
Reddit meldt je resterende budget bij elk antwoord van de Data API via drie headers. De Data API Wiki definieert ze precies zo.
| Header | Wat het volgens Reddit meldt |
|---|---|
X-Ratelimit-Used | Geschat aantal verzoeken dat in deze periode is gebruikt |
X-Ratelimit-Remaining | Geschat aantal verzoeken dat nog over is |
X-Ratelimit-Reset | Geschat aantal seconden tot het einde van de periode |
Twee details zitten mensen vaak dwars. Reddit noemt alle drie de waarden schattingen, dus een client die afbouwt tot X-Ratelimit-Remaining: 0 verzamelt fouten in plaats van netjes te stoppen. HTTP/2 zet headernamen bovendien in kleine letters, dus je client ziet x-ratelimit-remaining terwijl de documentatie hoofdletters gebruikt; vergelijk zonder op hoofdletters te letten. Log alle drie en laat een alarm afgaan als het resterende aantal onder een ondergrens zakt die je zelf kiest. PRAW respecteert deze headers automatisch en spreidt zijn verzoeken daarop.
Wat gebeurt er als Reddit 429 teruggeeft?
Reddit antwoordt met HTTP 429 Too Many Requests zodra je over het gemiddelde van het venster gaat, en het antwoord kan een retry-after-header bevatten met de wachttijd. De referentie-implementatie is prawcore, de HTTP-laag onder PRAW: de sessions.py daarvan koppelt too_many_requests aan een TooManyRequests-exception die retry-after uit het antwoord leest. Opvallend is dat 429 ontbreekt in de set RETRY_STATUSES van prawcore, die 500, 502, 503, 504, 408, 520 en 522 bevat, dus PRAW gooit bij 429 een fout in plaats van stilletjes opnieuw te proberen.
Neem die keuze over. Een serverfout verdient een nieuwe poging, omdat het verzoek geldig was, maar een 429 Too Many Requests betekent dat je planner niet klopt, en die in een retry-lus begraven verbergt de bug terwijl je quotum opbrandt. Laat de 429 zien en repareer het schema.

Hoeveel zoekwoorden kan één OAuth-client-id per uur pollen?
Deel het uurbudget door wat elk zoekwoord kost, en een monitor die per subreddit werkt, komt uit op enkele tientallen. De rekensom is één regel:
Queries per hour = keywords x subreddits x (60 / poll interval in minutes) x pages per poll
Volg één zoekwoord in 12 subreddits, poll elke 5 minuten en haal per poll één pagina op:
1 x 12 x (60 / 5) x 1 = 144 queries per hour per keyword
Je plafond is 100 QPM x 60 minuten = 6.000 queries per uur, dus 6.000 / 144 = 41,6, wat neerkomt op 41 zoekwoorden zonder enige marge. Haal je twee pagina's per poll op, dan verdubbelen de kosten tot 288 per zoekwoord per uur en zak je naar 20 zoekwoorden. Houd 20 procent achter de hand voor het vernieuwen van tokens en nieuwe pogingen, en het plafond bij één pagina wordt 4.800 / 144 = 33 zoekwoorden.
Pieken worden apart begrensd. Elk rollend venster van tien minuten bevat 1.000 queries, dus een backfill die in de eerste minuut 900 verzoeken afvuurt, laat er 100 over voor de negen minuten daarna. Draai doorlopende monitoring en backfills onder aparte OAuth-client-id's. Deze berekening bepaalt of je überhaupt op de ruwe API bouwt, en het is dezelfde berekening achter RedReplier naast zelf de Reddit API draaien.
RedReplier
Aan de slag
Reddit, X, Bluesky en HN
Realtime meldingen op intentie
Onbeperkt AI-antwoorden
Gerangschikt op koopintentie

Hoe ziet exponentiële backoff eruit tegenover een gemiddelde over tien minuten?
Backoff betekent hier dat je de wachttijd na elke mislukking verdubbelt en willekeurige jitter toevoegt, zodat een vloot workers niet in hetzelfde ritme opnieuw probeert. Een schema dat bij het venster van tien minuten past: wacht 1, 2, 4, 8 en 16 seconden over vijf pogingen, voeg aan elke wachttijd tot 1 seconde jitter toe, begrens elke wachttijd op 60 seconden en geef het verzoek na de vijfde poging op. Stuurt Reddit retry-after, gebruik dan die waarde in plaats van je berekende.
De eigen strategie van prawcore is bewust kleiner: FiniteRetryStrategy zet DEFAULT_RETRIES = 2 en slaapt 2 * random() seconden voor de eerste nieuwe poging en 2 + 2 * random() voor de laatste. Neem de jitter en de harde stop over, want onbeperkt opnieuw proberen tegen een gemiddeld venster graaft het gat dieper: elke nieuwe poging telt mee voor hetzelfde gemiddelde over tien minuten dat de 429 veroorzaakte. Als je systeem exponentiële backoff nodig heeft om binnen het budget te blijven, is het schema het defect, en is de keuze tussen polling en webhooks het nuttigere gesprek.
Wat onderscheidt het gratis niveau van de Data API van commerciële licenties?
De scheidslijn is wat je met de data doet, niet hoeveel queries je stuurt. Het helpcentrumartikel van Reddit over toegang tot Reddit-data definieert commerciële doeleinden als "elk gebruik van onze diensten door een bedrijf of namens een bedrijf of als onderdeel van een product of dienst waarmee geld wordt verdiend", en noemt abonnementsdiensten, apps achter een betaalmuur en betaalde datatoegang als voorbeelden. Sectie 3.1 van de Data API Terms zegt het in contracttaal: commerciële doeleinden, gebruik boven de rate limits of alles wat niet uitdrukkelijk is toegestaan, "moet een aparte overeenkomst met Reddit sluiten."
Een product waarmee geld wordt verdiend en dat 10 queries per minuut stuurt, heeft dus een contract nodig, ook al komt het nooit in de buurt van het plafond. Academisch werk loopt nu uitsluitend via het programma Reddit for Researchers, en Reddits Responsible Builder Policy stelt dat onderzoek met data die buiten dat programma is verzameld het beleid schendt, met handhaving tot ingetrokken tokens en geschorste accounts. Bepaal aan welke kant van de lijn je staat voordat je de client schrijft.
Elk getal hierboven geldt omdat jij de OAuth-client-id beheert. RedReplier houdt Reddit samen met X, Bluesky, Facebook en Hacker News op één plek in de gaten, zodat dekking een instelling in je abonnement wordt in plaats van een berekening van queries per uur. Het biedt ook een API en een MCP-server die werkt met Claude Code, Cursor en elke standaard MCP-client.
Veelgestelde vragen
Geldt de limiet van 100 QPM per gebruiker of per app?
Per OAuth-client-id, volgens de Data API Wiki van Reddit. Elke gebruiker die je app authenticeert, put uit dezelfde pool van 100 QPM die aan die client-id hangt, dus een multi-tenant tool krijgt geen extra ruimte door gebruikers toe te voegen. Aparte client-id's registreren voor echt aparte applicaties is de ondersteunde manier om budgetten te splitsen.
Wat gebeurt er met verzoeken die OAuth helemaal overslaan?
Reddit blokkeert ze. De Data API Wiki zegt dat verkeer zonder OAuth of inloggegevens wordt geblokkeerd en dat de standaard rate limit niet geldt, en het onderdeel Rules voegt toe dat Reddit "niet-geïdentificeerde gebruikers van de Data API vrij kan afremmen of blokkeren." Er bestaat geen tegoed voor niet-geauthenticeerd verkeer om op te plannen.
Tonen de X-Ratelimit-headers de minuut of het venster van tien minuten?
Ze melden de huidige periode, en dat is het middelingsvenster van tien minuten. X-Ratelimit-Reset telt de seconden af tot het einde van die periode, dus een waarde rond 600 betekent dat het venster net is geopend en een waarde rond 0 dat je tegoed bijna wordt aangevuld. Reddit noemt alle drie schattingen, dus houd marge in plaats van tot nul te besteden.
Stuurt Reddit bij 429 altijd een Retry-After-header mee?
Nee. De TooManyRequests-exception van prawcore leest de header met response.headers.get("retry-after") en toont alleen een wachtinstructie als hij aanwezig is, dus je code moet de afwezigheid ervan afhandelen. Gebruik retry-after als hij er is en val terug op je eigen backoff-schema als hij ontbreekt.
Is een User-Agent-string verplicht?
Ja, en het formaat ligt vast. De Data API Wiki van Reddit eist <platform>:<app ID>:<version string> (by /u/<reddit username>) en merkt op dat standaardwaarden zoals "Python/urllib" of "Java" "drastisch worden beperkt." Hij waarschuwt ook: "NEVER lie about your User-Agent."
Kan ik de limiet verhogen zonder commercieel contract?
Moderatorbots hebben een gedocumenteerde route: de Data API Wiki van Reddit nodigt beheerders van mod-bots die de limieten moeten overschrijden uit om contact op te nemen via het contactformulier. Het helpcentrum van Reddit voegt toe dat bepaalde ontwikkelaars die bredere toegang nodig hebben, kosten kunnen betalen om de standaardlimieten op te heffen. Voor alles waarmee geld wordt verdiend, is de route de aparte overeenkomst uit sectie 3.1 van de Data API Terms.
Dekt de limiet van 100 QPM ook chatberichten op Reddit?
Chat heeft zijn eigen plafonds, los van de querylimiet van 100 QPM: 2.000 berichten per dag per ontvanger en 3.000 per dag in totaal, volgens de Data API Wiki. Botaccounts kunnen daarnaast tot 300 keer per dag een chatroom binnengaan. Niets daarvan put uit hetzelfde rollende venster van tien minuten als je gewone queries.
Hoe behandelt Reddit een 429 anders dan een serverfout?
De set RETRY_STATUSES van prawcore omvat 500, 502, 503, 504, 408, 520 en 522, de codes die betekenen dat het verzoek geldig was en de server struikelde, dus PRAW probeert die automatisch opnieuw. 429 valt bewust buiten die set. Prawcore gooit in plaats daarvan een TooManyRequests-exception, omdat een rate-limitfout betekent dat je schema niet klopt, niet de server.
Wat gebeurt er met academisch onderzoek dat het programma Reddit for Researchers overslaat?
Reddits Responsible Builder Policy ziet data die buiten het programma Reddit for Researchers is verzameld als een overtreding. De handhaving gaat tot ingetrokken tokens en geschorste accounts. Van academische projecten wordt verwacht dat ze via het programma lopen in plaats van data op te halen met een algemene OAuth-client-id.
RedReplier
Aan de slag
Reddit, X, Bluesky en HN
Realtime meldingen op intentie
Onbeperkt AI-antwoorden
Gerangschikt op koopintentie
Waarom heeft een backfill een eigen OAuth-client-id nodig, los van doorlopende monitoring?
Elk rollend venster van tien minuten bevat in totaal 1.000 queries, en een backfill die in de eerste minuut 900 verzoeken afvuurt, laat er maar 100 over voor de resterende negen. Draai die backfill op dezelfde client-id als je doorlopende monitoring en de monitor komt de rest van het venster tekort. Aparte client-id's geven elke taak een eigen budget van 1.000 queries.
Zie ons vaker in Google
Met één klik markeer je RedReplier als voorkeursbron, zodat onze artikelen hoger staan in je Topverhalen, AI-modus en AI-overzichten.
Voordat je gaat...
RedReplier
Vang elke koper die vraagt om wat jij verkoopt
RedReplier houdt Reddit, X, Bluesky en Hacker News in realtime in de gaten, rangschikt elke thread op koopintentie en schrijft een concept voor je antwoord, zodat jij er als eerste bij bent.
Reddit, X, Bluesky en HN
Realtime meldingen op intentie
Onbeperkt AI-antwoorden
Gerangschikt op koopintentie
Gerelateerde artikelen


Wanneer is Reddit scrapen legaal? De gebruikersovereenkomst antwoordt eerder dan een rechter
Twee antwoorden op de vraag of Reddit scrapen legaal is: Amerikaanse rechters zien openbaar scrapen niet meer als misdrijf, en Reddit verbiedt het contractueel.


Hoe Reddit Rising threads laat zien voordat ze Hot bereiken
De sortering Rising op Reddit rangschikt jonge posts op recente weergaven. Waar hij verschijnt, de .json- en RSS-endpoints en hoe hij verschilt van Hot en New.


Acht oorzaken waarom Reddit search niet werkt, en hoe je de post toch vindt
Werkt Reddit search niet voor een post waarvan je weet dat hij bestaat? De acht oorzaken die Reddit documenteert, van sortering en bereik tot Safe Search en verwijderingen, met oplossingen.

