X / Twitter 推文 API
通过 URL 获取单条推文的完整详情：正文、作者 ID 和互动数（点赞、转推、回复、引用、书签、浏览量）。
US$0.22/千次请求，按请求付费，无需订阅。
Post
NASA
@NASA
Liftoff! 🚀
1:45 PM · Jun 9, 2024 · 9.4M Views
{"id": "1800000000000000000","text": "Liftoff! 🚀","authorId": "11348282","likes": 142000,"retweets": 21400,"replies": 3900,"quotes": 1200,"bookmarks": 8600,... 还有 10 个字段}
价格与服务商
X / Twitter 推文 API 价格：一个 API，4 个可互换的服务商
最便宜的服务商优先响应。如果它失败，下一个会在同一次调用中接手。
试一试
一个请求获取 X / Twitter 推文
这个示例展示了 26 个字段中的 12 个。查看全部字段
{
"found": true,
"data": {
"id": "1800000000000000000",
"text": "Liftoff! 🚀",
"authorId": "11348282",
"likes": 142000,
"retweets": 21400,
"replies": 3900,
"quotes": 1200,
"bookmarks": 8600,
"views": 9400000,
"createdUtc": 1717940700
}
}完整的参数与响应参考：这个接口的每个字段、类型和示例。
参考
一个请求，一种响应结构。
你发送的每个字段和收到的每个字段，都附有真实示例。
最近验证于 2026-11-14 · 可用率和延迟按 30d 统计
请求体
JSON，POST 到这个接口。
- urlstring
https://x.com/NASA/status/1800000000000000000
带数字推文 ID 的规范 x.com 或 twitter.com 推文 URL，包括 /i/web/status 和媒体分享等变体。
- 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.
响应
JSON，每个字段一个示例值。
- 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.
- heightinteger可设为必填
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.
- videoUrlstring可设为必填
Playable video file URL. Present only for video and gif items.
- widthinteger可设为必填
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.
常见问题
关于 X / Twitter 推文 API
AnyAPI 的 X / Twitter 推文 API 只需一次 POST 请求 /v1/run/twitter.tweet，就以统一格式的 JSON 返回 X / Twitter 数据。通过 URL 获取单条推文的完整详情：正文、作者 ID 和互动数（点赞、转推、回复、引用、书签、浏览量）。AnyAPI 会在 4 个数据源之间路由每个请求，某个数据源失败时自动切换。费用：每千次请求 US$0.22 起，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 X / Twitter 推文 API 调用中有 100.0% 成功，响应时间中位数为 1.3 秒，共测量 422,255 次调用。