X / Twitter 用户推文 API
分页返回某个用户的推文时间线，包含正文、媒体和互动数。使用 cursor 字段分页。
US$0.45/千次请求，按请求付费，无需订阅。
@nasa
@nasa
@NASA· Jun 9, 2024
Liftoff! 🚀
{"id": "1800000000000000000","url": "https://x.com/NASA/status/1800000000000000000","text": "Liftoff! 🚀","likes": 142000,"retweets": 21400,"replies": 3900,"createdAt": "2024-06-09T13:45:00Z","authorHandle": string,... 还有 13 个字段}
价格与服务商
X / Twitter 用户推文 API 价格：一个 API，3 个可互换的服务商
最便宜的服务商优先响应。如果它失败，下一个会在同一次调用中接手。
每次请求封顶 US$0.01011 条结果US$0.000250 条结果US$0.0051100 条结果US$0.0101（封顶）按实际返回的内容计费。调低返回数量上限即可少付，而且无论返回多少，单次请求都不会超过封顶价。
试一试
一个请求获取 X / Twitter 用户推文
这个示例展示了 30 个字段中的 10 个。查看全部字段
{
"found": true,
"data": {
"nextCursor": "DAABCgABF__cursor",
"tweets": [
{
"id": "1800000000000000000",
"url": "https://x.com/NASA/status/1800000000000000000",
"text": "Liftoff! 🚀",
"likes": 142000,
"retweets": 21400,
"replies": 3900,
"createdAt": "2024-06-09T13:45:00Z"
}
]
}
}完整的参数与响应参考：这个接口的每个字段、类型和示例。
参考
一个请求，一种响应结构。
你发送的每个字段和收到的每个字段，都附有真实示例。
最近验证于 2026-11-14 · 可用率和延迟按 30d 统计
请求体
JSON，POST 到这个接口。
- handlestring
nasa
Twitter/X 用户名，不带开头的 @。
- cursorstring
0
来自上一次响应 nextCursor 的不透明分页游标。获取第一页时省略。
- limitinteger
Page size to ask for (1-100, default 20). Some sources honor it; others always return their whole native page of about 20 authored tweets and replies. A page is never trimmed after the call, so follow nextCursor and pass it back as cursor to continue exactly where this response ended.
- requireFieldsarray
可选；省略时路由不变，由最便宜的数据源处理。列出本次请求必须能返回的输出字段，例如 `isPinned`，请求就只会由能返回全部这些字段的数据源处理。未列出的字段，只要处理请求的数据源有，仍会照常返回。这可能提高你的价格：最便宜的数据源无法返回某个列出的字段时，会改由更贵的数据源处理，并按它的价格报价和扣费。如果某条帖子确实没有某个列出的字段，该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回，请求会作为无效输入被拒绝，不扣费。在分页遍历中，它只作用于第一页；后续页面沿用该页选定的数据源，按当时的报价计费。
- requireSinglePageboolean
要求使用能在一个响应中返回所请求 limit 数量的数据源。
响应
JSON，每个字段一个示例值。
- nextCursorstring
DAABCgABF__cursor
Opaque cursor for the next page when the selected lane supports pagination, otherwise null.
Populated whenever the provider has data for the entity.
- authorHandlestring
Handle of the account that posted.
- authorIdstring
Numeric X user id of the account that posted, as a string.
- authorImagestring
Avatar image URL of the account that posted.
- authorNamestring
Display name of the account that posted.
- 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
1800000000000000000
Populated whenever the provider has data for the entity.
- isPinnedboolean可设为必填
Whether X marks the post as pinned on the profile, or null when the serving source does not publish it.
- isReplyboolean
- langstring
- likesinteger
142000
- quotesinteger
- repliesinteger
3900
- retweetsinteger
21400
- sourcestring
Client the post was sent from, e.g. "Twitter Web App".
- textstring
Liftoff! 🚀
Populated whenever the provider has data for the entity.
- urlstring
https://x.com/NASA/status/1800000000000000000
Populated whenever the provider has data for the entity.
- viewsinteger
Photo, video, and GIF attachments on the post. Empty when the post has none.
- heightinteger
- 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
- 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.
你在出售这个 API？查看你的接口必须返回的完整数据结构。
常见问题
关于 X / Twitter 用户推文 API
AnyAPI 的 X / Twitter 用户推文 API 只需一次 POST 请求 /v1/run/twitter.user_tweets，就以统一格式的 JSON 返回 X / Twitter 数据。分页返回某个用户的推文时间线，包含正文、媒体和互动数。使用 cursor 字段分页。AnyAPI 会在 3 个数据源之间路由每个请求，某个数据源失败时自动切换。费用：每千次请求 US$0.45 起，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 X / Twitter 用户推文 API 调用中有 100.0% 成功，响应时间中位数为 1.5 秒，共测量 411,130 次调用。