/v1/x/*. See the API Reference for the full endpoint list. Credit rates are in Credits.
Pagination
Search, timelines, replies, thread, quotes, retweeters, likers, followers, and following use an opaquenextCursor. Pass it back unchanged on the next request.
Verification fields
User objects expose two separate flags:verified— legacy checkmark (government/brand/org verification before X Premium)isBlueVerified— X Premium / Blue subscription badge
XUser ref
On user-keyed routes (/v1/x/users/:ref/tweets, /likes, /media, /followers, etc.), :ref accepts either a screen name or a numeric user id.
Tweet lookup
GET /v1/x/tweets and POST /v1/x/tweets/lookup support batch lookup (up to 100 ids). Responses use partial success: { meta, data, errors } with per-ID availability codes. See Errors — X availability.
Profile availability (soft 404)
Profile and XUser-keyed endpoints return HTTP 404 withUSER_NOT_FOUND, USER_PROTECTED, or USER_SUSPENDED when the target account state prevents a response. Credits are still charged for definitive 404s.
Likes and likers session limits
Likes (/v1/x/users/:ref/likes) typically only returns likes visible to the authenticated X session. For other users, results are often empty or heavily limited.
Likers (/v1/x/tweets/:id/likers) may return an empty page when X does not expose the liker list to the session.
Thread vs replies vs quotes
Thread (/v1/x/tweets/:id/thread) — the focal tweet plus chained self-replies by the same author. Not third-party replies.
Replies (/v1/x/tweets/:id/replies) — conversation replies under the tweet (paginated). Distinct from thread.
Quotes (/v1/x/tweets/:id/quotes) — quote-tweets of the given tweet (paginated via search).
Trends
GET /v1/x/trends returns trending topics for a WOEID place. Query param: woeid (optional, default 1 = Worldwide).
Use GET /v1/x/trends/locations to list every valid WOEID — that catalogue is the source of truth.
Watches
X watches poll a search query and delivertweet.created webhooks. See Watches and Webhooks.