tweetapi.dev

Pagination

Cursors, page size and ordering.

List endpoints return a page and, when there is more, a next_cursor. Pass it back as cursor to get the next page.

curl "https://api.tweetapi.dev/v1/users/x/tweets?count=20" -H "x-api-key: $KEY"
# ... "next_cursor": "DAABCgABG..."
curl "https://api.tweetapi.dev/v1/users/x/tweets?count=20&cursor=DAABCgABG..." -H "x-api-key: $KEY"
  • Cursors are opaque strings. Do not parse or store them for longer than a session.
  • A page without next_cursor is the last one.
  • count is a hint. X returns about 20 items per page even when fewer are asked for, so the floor is 20. Maximum is 100 for timelines, 50 for search and 200 for followers.
  • You are charged for items returned, never for the page size you asked for.
  • Timelines are newest first. Search with product=Latest is newest first; Top is by relevance where available.