glossary

X publiceert de rate limits van de Twitter API niet meer per tier

Taras Shynkarenko
Taras Shynkarenko
•Bijgewerkt: •8 min leestijd
X publiceert de rate limits van de Twitter API niet meer per tierX publiceert de rate limits van de Twitter API niet meer per tier

TL;DR

8 min leestijd

X publiceert één tabel met rate limits voor de v2-API, geordend per endpoint en verdeeld in een kolom per app en een kolom per gebruiker, met vensters van 15 minuten of 24 uur. Recent search staat 450 verzoeken per 15 minuten per app toe en 300 per gebruiker; full-archive search staat 1 per seconde en 300 per 15 minuten toe. Er zijn nu twee commerciële niveaus in plaats van vier: betalen per gebruik, met een limiet van 3 miljoen gelezen Posts per maand, en Enterprise. Gecontroleerd op 12 september 2026.

Wat zijn de rate limits van de Twitter API in 2026?

Niets in de huidige documentatie van X legt de rate limits van de Twitter API vast per abonnementstier. De actuele tabellen zijn geordend per endpoint en verdeeld in twee kolommen: een voor limieten per app, die gelden als je met een bearer token authenticeert, en een voor limieten per gebruiker, die gelden bij gebruikerstokens via OAuth 1.0a of OAuth 2.0. Elk cijfer hieronder komt van docs.x.com/x-api/fundamentals/rate-limits, gelezen op 12 september 2026.

Vensters duren 15 minuten, tenzij de regel iets anders zegt. Dit zijn de endpoints die een listening- of monitoringtool echt gebruikt.

MethodeEndpointPer appPer gebruiker
GET/2/tweets/search/recent450/15min300/15min
GET/2/tweets/search/all1/sec, 300/15min1/sec
GET/2/tweets/counts/recent300/15minniet beschikbaar
GET/2/tweets/counts/all300/15minniet beschikbaar
GET/2/tweets3.500/15min5.000/15min
GET/2/tweets/:id450/15min900/15min
GET/2/tweets/search/stream50/15minniet beschikbaar
POST/2/tweets/search/stream/rules100/15minniet beschikbaar
GET/2/tweets/search/stream/rules450/15minniet beschikbaar
GET/2/users/:id/tweets10.000/15min900/15min
GET/2/users/:id/mentions450/15min300/15min
GET/2/users/by/username/:username300/15min900/15min
POST/2/tweets10.000/24u100/15min
GET/2/usage/tweets50/15minniet beschikbaar
GET/2/tweets/sample10/stream100/15minniet beschikbaar

Twee regels in die tabel verdienen extra aandacht. Recent search geeft een app 450 verzoeken maar een gebruiker slechts 300, dus het bearer token voor alleen de app is de sterkere credential voor monitoring. Full-archive search wordt evenzeer door een limiet per seconde beheerst als door een limiet per venster, wat betekent dat een backfilljob een pauze tussen calls nodig heeft in plaats van een uitbarsting en daarna wachten.

Voor welke tiers gelden de rate limits van de Twitter API?

X heeft nu twee commerciële niveaus, betalen per gebruik en Enterprise, en de abonnementstiers Free, Basic en Pro die oudere gidsen nog noemen, zijn verdwenen. De changelog dateert de overstap. X kondigde op 20 oktober 2025 de pilot voor betalen per gebruik aan en lanceerde de prijzen per gebruik op 6 februari 2026 terwijl Basic en Pro nog beschikbaar waren, en zette daarna Basic-abonnees na 1 juni 2026 en Pro-abonnees na 1 september 2026 over. De tabellen met rate limits hierboven hebben helemaal geen kolom voor tiers, en dat is het eerlijke antwoord op "wat zijn de limieten op Basic". Er is geen Basic.

Waar X nog wel per niveau onderscheid maakt, zien de cijfers er zo uit.

LimietBetalen per gebruikEnterprise
Maandelijkse limiet voor gelezen Posts3 miljoen per factuurperiodeOp maat of onbeperkt
Filtered stream-regels per project1.00025.000+
Lengte van een filtered stream-regel1.024 tekens2.048 tekens
Filtered stream-verbindingen1Meerdere
Lengte van een recent search-query512 tekens4.096 tekens
Lengte van een full-archive search-query1.024 tekens4.096 tekens
Rate limits per endpointDe standaardtabellenOp maat, vastgelegd in het contract
Van vier tiers naar twee
1
Vóór 2026. De tiers Free, Basic, Pro en Enterprise bepalen toegang en rate limits.
2
20 oktober 2025. X kondigt de pilot voor prijzen per gebruik aan.
3
6 februari 2026. Prijzen per gebruik gaan live, en Basic en Pro worden later in 2026 overgezet.
4
Vandaag. Er blijven twee commerciële niveaus over: betalen per gebruik met een limiet van 3 miljoen gelezen Posts per maand, en Enterprise.
Volgens X's eigen changelog ging het tiersysteem in vier maanden van vier niveaus naar twee.

Waar spreekt X zichzelf tegen over deze cijfers?

Drie actuele pagina's op docs.x.com spreken elkaar tegen, en de verschillen zijn niet cosmetisch.

Het eerste is het aantal filtered stream-regels. De introductiepagina van filtered stream zet Enterprise op "25.000+" regels per project. De Enterprise-prijspagina, die hetzelfde product beschrijft, zet het op "5.000+ rules". Beide pagina's waren op 12 september 2026 live en geen van beide verwijst naar de andere als correctie.

Het tweede is de querylengte bij Post-tellingen. De tabel met rate limits noemt /2/tweets/counts/all met de opmerking "1024 query length". De pagina over de query builder voor tellingen zegt "Your query can be 512 characters long for pay-per-use customers, or up to 4.096 characters for Enterprise customers", met één getal voor beide count-endpoints. Een query van 1.024 tekens tegen /2/tweets/counts/all valt dus binnen de limiet van de ene pagina en buiten die van de andere.

Het derde is een verwijzing die nergens heen leidt. Beide query builders voor zoeken en de regelbuilder voor filtered stream zeggen dat je limieten afhangen van je toegangsniveau en linken voor de details naar /x-api/getting-started/about-x-api. Die pagina bevat geen sectie over toegangsniveaus meer. Er staan mogelijkheden, API-versies, resources en prijzen per gebruik, en niets dat een tier noemt. De pagina op docs.x.com/fundamentals/rate-limits heeft de omschrijving "Understand X API rate limits across access tiers and endpoints" en noemt daarna geen tiers, alleen een link naar de tabel met endpoints.

De les voor iedereen die een build begroot: behandel de tabel per endpoint als het geldende document en de pagina's met lopende tekst als verouderd.

Hoe lees je de rate limit-headers?

X stuurt bij elke response drie headers mee, en die zijn de enige realtime bron van waarheid.

x-rate-limit-limit: 900
x-rate-limit-remaining: 847
x-rate-limit-reset: 1705420800

x-rate-limit-limit is het plafond voor het huidige venster, x-rate-limit-remaining is wat er over is, en x-rate-limit-reset is een Unix-timestamp voor het moment waarop het venster opnieuw begint. Ga je over het plafond, dan krijg je een 429 met deze body:

{
  "errors": [{
    "code": 88,
    "message": "Rate limit exceeded"
  }]
}

Foutcode code: 88 heeft elke herschrijving van deze API sinds v1.1 overleefd, dus het loont om daar expliciet op te matchen in plaats van alleen op de statuscode. X's eigen advies voor herstel is x-rate-limit-reset uitlezen, wachten tot dat tijdstip en daarna exponentiële backoff toepassen.

Iemand bekijkt 's avonds een melding op een telefoon, als beeld voor het verschil tussen een rate limit en een rekening.

Zijn rate limits hetzelfde als je rekening?

Nee, en X zegt dat zelf direct: rate limits regelen hoe vaak je verzoeken doet, voor de stabiliteit van het systeem, terwijl gebruiksfacturering de opgehaalde data rekent. Je kunt binnen elke rate limit blijven en toch geld uitgeven, en je kunt een rate limit raken zonder iets extra uit te geven.

RedReplier
RedReplier

Aan de slag

Reddit, X, Bluesky en HN

Realtime meldingen op intentie

Onbeperkt AI-antwoorden

Gerangschikt op koopintentie

Gelezen items worden per teruggegeven resource gerekend, niet per verzoek. Een gelezen Post kost $0,005 en een gelezen gebruiker kost $0,010. Resources worden binnen een venster van 24 uur UTC ontdubbeld, dus dezelfde Post twee keer per dag ophalen wordt één keer gerekend, en X noemt die ontdubbeling een zachte garantie in plaats van een belofte. Het plan per gebruik heeft een limiet van 3 miljoen gelezen Posts per maandelijkse factuurperiode, hoe rustig je je verzoeken ook spreidt. Het volledige kostenplaatje, inclusief de schrijfkant, staat uitgesplitst in de notitie over de prijzen van de X API.

Welke limiet houdt een monitoringtool echt tegen?

De maandelijkse limiet voor gelezen Posts, niet de limiet op verzoeken per venster. Recent search met 450 verzoeken per 15 minuten en 100 resultaten per verzoek is op papier 45.000 Posts per venster, genoeg om een tegoed van 3 miljoen Posts in minder dan een dag continu pollen op te maken. Het plafond voor verzoeken is ruim; het plafond voor resources is het budget.

Dat verandert hoe een goede query eruitziet. Smalle regels met weinig treffers kosten weinig, en een brede regel die op een veelvoorkomend woord matcht, verbrandt het tegoed terwijl jij slaapt. Filtered stream is het goedkopere instrument voor continue dekking, omdat het alleen levert wat bij je regels past, en de regels zelf kosten niets om aan te houden. Die regels goed schrijven is dezelfde vaardigheid als een goede zoekopdracht schrijven, en dat behandelt de referentie over geavanceerde zoekoperators op X.

De andere helft van de berekening is dat X maar één netwerk is. Een koopvraag die op X wordt gesteld, wordt meestal ook op Reddit en Hacker News gesteld, en die platforms meten toegang anders, zoals de vergelijking van de rate limits van de Reddit API laat zien. Teams die met de X API begonnen en daarna het gat in hun dekking doorrekenden, komen meestal uit bij listening over meerdere netwerken in plaats van te betalen om er één breder te maken.

Veelgestelde vragen

Wat is de rate limit voor de zoek-API van X?

Recent search op /2/tweets/search/recent staat 450 verzoeken per 15 minuten toe met een bearer token voor alleen de app en 300 per 15 minuten met een gebruikerstoken, en geeft standaard 10 resultaten en maximaal 100 terug. Full-archive search op /2/tweets/search/all staat 1 verzoek per seconde en 300 per 15 minuten per app toe, en geeft standaard 10 en maximaal 500 resultaten terug.

Heeft X nog een Free-tier?

Niet als gedocumenteerd product. X lanceerde de prijzen per gebruik op 6 februari 2026, en de huidige documentatie over toegang krijgen leidt je door aanmelden, een app aanmaken en credentials opslaan zonder een tier te noemen. Het woord "Free" komt alleen nog voor in changelog-items, waaronder de notitie van 22 augustus 2025 die POST /2/users/:id/likes en POST /2/users/:id/following uit de Free-tier haalde.

Wat betekent HTTP 429 bij de X API?

Het betekent dat je in het huidige venster een rate limit voor dat endpoint hebt overschreden. De body van de response bevat code: 88 en de melding "Rate limit exceeded". Lees de header x-rate-limit-reset voor de Unix-timestamp waarop het venster opnieuw begint, en probeer het niet eerder opnieuw.

Worden rate limits per app of per gebruiker geteld?

Allebei, en welke geldt hangt af van hoe je authenticeerde. Verzoeken met een bearer token tellen mee voor de limiet per app, en verzoeken met een gebruikerstoken via OAuth 1.0a of OAuth 2.0 tellen mee voor de limiet per gebruiker van die gebruiker. Verschillende endpoints publiceren maar één van de twee kolommen, wat betekent dat de andere manier van authenticeren daar helemaal niet beschikbaar is.

Serverrekken met knipperende statuslampjes staan voor de continue verbinding die een filtered stream openhoudt.

Hoeveel filtered stream-regels kan ik draaien?

Een project met betalen per gebruik krijgt 1.000 regels van maximaal 1.024 tekens elk, via één verbinding, met een levering van maximaal 250 Posts per seconde. Enterprise verhoogt de regellengte naar 2.048 tekens en staat meerdere verbindingen toe. Over het aantal regels voor Enterprise spreken X's eigen pagina's elkaar tegen: 25.000+ op de introductie van filtered stream en 5.000+ op de Enterprise-prijspagina.

Gelden rate limits ook voor het gebruiksendpoint zelf?

Ja. GET /2/usage/tweets, het endpoint dat je eigen verbruik van Posts rapporteert, heeft een limiet van 50 verzoeken per 15 minuten per app en geen limiet per gebruiker. Je eigen uitgaven pollen is goedkoop maar ontsnapt niet aan de boekhouding, dus lees het volgens een schema uit in plaats van vóór elke call.

Hoeveel rekent de X API per gelezen Post?

Een gelezen Post kost $0,005 en een gelezen gebruiker $0,010, gerekend per teruggegeven resource en niet per verzoek. X ontdubbelt resources binnen een venster van 24 uur UTC, dus dezelfde Post twee keer per dag ophalen telt één keer, al noemt X die ontdubbeling een zachte garantie in plaats van een belofte. Het plan per gebruik beperkt het totaal aantal gelezen Posts tot 3 miljoen per factuurperiode, hoe die ook verspreid worden.

Wanneer schafte X de Basic- en Pro-tiers van de API af?

X lanceerde de prijzen per gebruik op 6 februari 2026 terwijl Basic en Pro nog beschikbaar waren, en schafte daarna beide af. Basic-abonnees werden na 1 juni 2026 overgezet en Pro-abonnees na 1 september 2026, waardoor Enterprise en betalen per gebruik overbleven. Oudere gidsen die nog limieten van Basic of Pro noemen, beschrijven een prijsstructuur die niet meer bestaat.

Waarom is de limiet per gebruiker bij sommige endpoints hoger dan die per app?

Er is geen vaste regel. Op /2/tweets krijgt een bearer token per app 3.500 verzoeken per 15 minuten, terwijl een token per gebruiker er 5.000 krijgt, en /2/tweets/:id volgt hetzelfde patroon met 450 tegenover 900. Recent search werkt andersom, met 450 per app tegenover 300 per gebruiker, dus welke credential sterker is, hangt af van het endpoint dat je aanroept en niet van een vaste rangorde tussen app- en gebruikersauthenticatie.

Wat is de goedkoopste manier om X continu te monitoren?

Filtered stream, niet zoekopdrachten pollen. Recent search met 450 verzoeken per 15 minuten en 100 resultaten per call kan op papier 45.000 Posts per venster teruggeven, genoeg om een maandtegoed van 3 miljoen Posts in minder dan een dag continu pollen op te maken. Filtered stream levert alleen wat bij je regels past, en die regels aanhouden kost niets, dus een goed afgebakende set regels dekt hetzelfde terrein voor een fractie van de gelezen items.

RedReplier
RedReplier

Aan de slag

Reddit, X, Bluesky en HN

Realtime meldingen op intentie

Onbeperkt AI-antwoorden

Gerangschikt op koopintentie

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

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