Twitter List Tweets API | Date-Filtered X List Posts

List Tweets returns the posts written by the members of a public Twitter/X List, newest first, filtered through X's search index. It is the time-rangeable half of the List feed: it accepts since and until dates and an include_replies toggle. It does not carry retweets, and search-index lag applies, so a post can take a moment to appear. Each page is one $0.0008 read.

curl -X GET "https://example.com/list/tweets?list_id=1234567890123456789&since=2026-08-01&until=2026-08-15&include_replies=false&product=Top&count=20"

{  "tweets": [    {      "id": "1899887766554433221",      "text": "Shipping the thing we said we would ship.",      "created_at": "2026-08-14T09:12:44.000Z",      "author": {        "id": "745273",        "username": "naval"      }    }  ],  "next_cursor": "DAABCgABF..."}

{  "error": "bad_request",  "message": "Missing or malformed parameter. Fix the request before retrying."}

{  "error": "unauthorized",  "message": "The API key is missing, malformed, or revoked. Check the Authorization header."}

{  "error": "insufficient_credits",  "message": "Your balance is exhausted. Top up your credits to continue."}

{  "error": "not_found",  "message": "The resource does not exist, for example a deleted tweet or a private account."}

{  "error": "rate_limited",  "message": "Too many requests. Back off and retry with exponential backoff."}

{  "error": "server_error",  "message": "Something failed on our side. Retry with backoff; if it persists, contact support."}

Pricing

Each page is one $0.0008 read. Narrowing with since and until costs the same per page but returns fewer pages.

When to use

Use it when you need a List's posts for a specific date range, or with replies filtered out, for example pulling a week of output from a curated founders List.

Pagination

This endpoint is cursor-paginated and returns roughly 20 records per call. Pass the next_cursor from each response back as the cursor parameter to read the next page. Stop when the records array comes back empty: follower-graph endpoints return a non-null cursor even on the final page, so the empty array is the only reliable stop signal. See Pagination for the full loop.

Related endpoints

• List Timeline: Read a public List's native X timeline, retweets included.
• List Members: Page through the members of a public Twitter/X List.
• Advanced Tweet Search: Search tweets with Twitter's full query-operator syntax, paginated with cursors.

FAQ

How is this different from List Timeline?

They are two capabilities, not two spellings. List Tweets is search-backed, so it accepts since, until and include_replies. List Timeline is X's native List feed, which carries retweets and X's own ordering but takes no filters at all.

Why are retweets missing?

This endpoint reads X's search index, which does not return retweets for a List query. If you need them, use List Timeline instead.

Is until inclusive?

No. until is exclusive, matching X's own until: search operator. A post made on the until date is not returned.