X / Twitter Tweet API
Fetch a single Twitter/X tweet by URL with its full text and engagement counts (likes, retweets, replies, quotes, bookmarks, views).
Pricing and providers
X / Twitter Tweet API pricing: one API, 4 interchangeable providers
The cheapest provider serves first. If it fails, the next one takes over in the same call.
Try it
Get X / Twitter tweet in one request
{
"data": {
"authorHandle": "alex_rivera",
"authorId": "Alex Rivera",
"authorImage": "https://example.com/image.jpg",
"authorName": "Alex Rivera",
"authorVerified": true,
"bookmarks": 42,
"conversationId": "a1b2c3d4",
"createdUtc": 12.5,
"id": "a1b2c3d4",
"inReplyToId": "a1b2c3d4",
"lang": "en",
"likes": 12500,
"media": [
{
"height": 42,
"type": "general",
"url": "https://example.com/page",
"videoUrl": "https://example.com/page",
"width": 1024
}
],
"quotes": 42,
"replies": 42,
"retweets": 42,
"text": "A short example description of this item.",
"views": 12500
},
"found": true,
"reason": "not_found"
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
One request, one response shape.
Every field you send and every field you get back, each with a real example.
Last verified 2026-10-06 · uptime and latency measured over 30d
Request body
JSON, posted to this endpoint.
- urlstring
https://x.com/SpaceX/status/1732824684683784516
Canonical x.com or twitter.com status URL with a numeric tweet ID, including /i/web/status and media-share variants.
- requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `media` or `videoUrl`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a tweet that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.
Response
JSON, one example value per field.
- authorHandlestring
Handle of the account that posted.
- authorIdstring
Populated whenever the provider has data for the entity.
- authorImagestring
Avatar image URL of the account that posted.
- authorNamestring
Display name of the account that posted.
- authorVerifiedboolean
Whether the posting account carries an X blue verification badge.
- bookmarksinteger
- conversationIdstring
Id of the conversation the post belongs to, as a string.
- createdUtcnumber
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Populated whenever the provider has data for the entity.
- idstring
Populated whenever the provider has data for the entity.
- inReplyToIdstring
Id of the post this post directly replies to, as a string, or null when the post is not a reply.
- langstring
Two-letter language code X detected for the post.
- likesinteger
- quotesinteger
- repliesinteger
- retweetsinteger
- textstring
Populated whenever the provider has data for the entity.
- viewsinteger
View count, or null when X does not report one for this tweet. Distinct from 0, which means the tweet has no views.
Photo, video, and GIF attachments on the post. Empty when the post has none.
- heightintegercan require
Pixel height of the media item, when the lane reports it.
- typestringcan require
One of photo, video, or gif.
- urlstringcan require
Image URL. For a video or GIF this is the poster/thumbnail frame. X media URLs on pbs.twimg.com are publicly fetchable without authentication; append ?name=orig for the full-resolution original.
- videoUrlstringcan require
Playable video file URL. Present only for video and gif items.
- widthintegercan require
Pixel width of the media item, when the lane reports it.
- foundboolean
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
FAQ
About the X / Twitter Tweet API
The AnyAPI X / Twitter Tweet API returns X / Twitter tweet data as normalized JSON from one POST call to /v1/run/twitter.tweet. Fetch a single Twitter/X tweet by URL with its full text and engagement counts (likes, retweets, replies, quotes, bookmarks, views). AnyAPI routes each request across 4 sources and falls back automatically when one fails. It costs from $0.22 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of X / Twitter tweet calls through AnyAPI succeeded, with a median response time of 1.3 seconds across 40,454 measured calls.