X / Twitter Tweet API
Full detail for a single tweet by URL: text, author id, and engagement counts (likes, retweets, replies, quotes, bookmarks, views).
$0.22/1k req, pay per request, no subscription.
{"id": "1800000000000000000","text": "Liftoff! 🚀","authorId": "11348282","likes": 142000,"retweets": 21400,"replies": 3900,"quotes": 1200,"bookmarks": 8600,... 10 more fields}
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
This sample shows 12 of 26 fields. See every field
{
"found": true,
"data": {
"id": "1800000000000000000",
"text": "Liftoff! 🚀",
"authorId": "11348282",
"likes": 142000,
"retweets": 21400,
"replies": 3900,
"quotes": 1200,
"bookmarks": 8600,
"views": 9400000,
"createdUtc": 1717940700
}
}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-31 · uptime and latency measured over 30d
Request body
JSON, posted to this endpoint.
- urlstring
https://x.com/NASA/status/1800000000000000000
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 `videoUrl` or `width`, 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
11348282
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
8600
- conversationIdstring
Id of the conversation the post belongs to, as a string.
- createdUtcnumber
1717940700
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
1800000000000000000
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
142000
- quotesinteger
1200
- repliesinteger
3900
- retweetsinteger
21400
- textstring
Liftoff! 🚀
Populated whenever the provider has data for the entity.
- viewsinteger
9400000
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.
- typestring
One of photo, video, or gif.
- urlstring
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
true
- 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. Full detail for a single tweet by URL: text, author id, 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 136,641 measured calls.
