Skip to main content
GET
Returns tweets received from tracked X accounts within the last 24 hours. Tweets are cached in memory as they arrive on the dispatch path and expire automatically after 24h. Provide accounts via numeric user IDs (uids), usernames (usernames), or both. Up to 100 accounts per request.
This endpoint only returns tweets that were captured while the account was being tracked. It does not backfill history — use the backfill endpoints for that.

Query Parameters

string
Comma-separated X user IDs (e.g. 44196397,1234567). Either uids or usernames is required.
string
Comma-separated X usernames (e.g. elonmusk,jack). Resolved to user IDs internally. Unresolved usernames are returned in the unresolved field.
number
Unix timestamp in milliseconds. Only tweets received at or after this time are returned. Omit to return all cached tweets (up to 24h).
string
default:"flat"
Response shape: - flat — single array of tweet payloads, sorted ascending by arrival time - uid — object keyed by user ID, with an array of tweets per user (empty array if no cached tweets for that uid)

Response

array | object
When group=flat: an array of tweet payloads sorted ascending by arrival time. When group=uid: an object mapping each resolved user ID to its array of tweet payloads.
string[]
Usernames that could not be resolved to a user ID. Only present when at least one username failed to resolve.
The total request cap is 100 accounts (after merging uids and usernames and deduping). Rate limit: 30 requests per minute.