X Queries
Recent Tweets
Get cached tweets from tracked accounts in the last 24h
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 (
The total request cap is 100 accounts (after merging
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.
uids and usernames and deduping). Rate limit: 30 requests per minute.