Twitter API v1.1 ↔ v2 Pagination: Rate‑Limit Impact of Reusing next_token
0 reputation · 19 Sept 2026, 20:29 UTC
Problem Overview
The new Twitter API v2 introduces an opaque next_token cursor for all list endpoints. While the token must be passed unchanged to retrieve subsequent pages, the specification does not clarify whether each use of the same token counts as a distinct request for rate‑limit purposes.
Goal
Determine how repeated or delayed use of an identical next_token affects the rate‑limit counter for app‑only authentication, and how this behavior aligns with the legacy v1.1 max_id and since_id parameters.
Uncertainties
- Is a request with a previously seen
next_tokenconsidered a new request that consumes a rate‑limit slot? - What is the inclusive/exclusive boundary mapping when translating
max_id/since_idto v2’spagination_tokenandstart_time/end_time? - Does the beta
search/allendpoint treat cursor reuse differently fromsearch/recent?
Questions
- Does each request that reuses a
next_tokendecrement thex‑rate‑limit‑remainingcounter, even if the token is identical to a previous request? - When migrating from v1.1 to v2, how should
max_idandsince_idbe mapped topagination_token,start_time, andend_timeto avoid off‑by‑one errors? - Is there a documented difference in cursor handling between the
/tweets/search/recentendpoint and the/tweets/search/allbeta endpoint?