还没有输出。提交表单以生成内容。
透明定价,无隐藏费用。按需支付。
| 规则与模式 | 渠道 | 积分 | 价格(美元) | 官方/参考价格 | 每日节省 |
|---|---|---|---|---|---|
user-tweets otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 使用完整指南
通过一次 API 调用,获取任意 Twitter 用户发布的完整推文时间线。

ApiPass 上的 Twitter Graphql User Tweets API 是一个强大的端点,开发者只需提供用户 ID,即可获取任意公开 Twitter (X) 用户的推文时间线。该 API 基于 Twitter 内部 GraphQL 基础设施构建,可返回丰富且结构化的推文数据,包括原创帖子、回复、转推、媒体附件、互动指标和时间线元数据。ApiPass 将 Twitter GraphQL 层的复杂性封装为简洁的、基于异步任务的 REST 接口:你向 /api/v1/jobs/createTask 提交请求,传入目标 userId 和可选分页参数,接收 taskId,然后通过 /api/v1/jobs/recordInfo 获取完整的时间线结果。凭借智能提供商路由、可选 webhook 回调以及多种 channel 等级(starter、regular、official 或 auto),ApiPass 让你无需管理 OAuth token、速率限制或爬取基础设施,也能轻松将用户时间线数据集成到应用中。
跳过冗长的审批流程和 OAuth 配置。只需生成一个 ApiPass API key,即可使用简单的 Bearer token 立即开始获取用户时间线。
默认的 channel: auto 设置会根据实时价格和稳定性指标,在可用提供商之间自动分配任务,在最低成本与可靠性能之间取得平衡。
可在 starter(超低成本)、regular(标准等级,价格远低于官方 API)和 official(Twitter 原生 API,稳定性最高)之间选择,根据可靠性需求灵活控制支出。
基于任务的设计(createTask → recordInfo)可以优雅处理长时间运行的请求,避免客户端超时,并支持可靠的批量处理。
可提供可选的 callBackUrl,在任务处理完成的瞬间自动接收通知,无需低效的轮询循环。
可使用 withVoice、withV2Timeline、withQuickPromoteEligibilityTweetFields 和 includePromotedContent 等 boolean 标志精细调整响应 payload,准确获取所需数据。
传入任意公开 Twitter userId(例如 44196397)以及 count 参数,即可获取分页批次的推文数据,并包含所有原生 GraphQL 元数据。
每个任务都会暴露实时状态流转(waiting → queuing → generating → success / fail),并提供 createTime、completeTime 和 costTime 字段,便于性能监控。
结果会以清晰的 resultJson.resultObject 结构返回,映射 Twitter 原生 GraphQL 响应,使解析和下游处理更加直接。
持续拉取关键影响者、竞争对手或品牌账号的推文,为实时监控仪表盘提供数据支持。
构建个人或组织级推文归档工具,保存完整时间线,包括媒体和互动统计,用于合规或历史参考。
从指定用户收集大规模、结构化的推文数据集,用于微调 LLM、情感分类器或推荐系统。
为创作者和营销人员提供其自身或竞争对手账号的详细时间线洞察、发帖模式和互动拆解。
了解 ApiPass 在成本、可访问性和集成工作量方面与 Twitter 原生开发者平台的对比。
Twitter 官方 GET /2/users/:id/tweets 端点需要付费开发者账号(Basic tier 及以上),并受到严格的月度额度限制和人工审批流程约束。ApiPass 完全消除了这一门槛——只需注册、获取 API key,并按任务付费,价格远低于官方 API;当你需要与官方同等级别的可靠性时,也可以选择使用 official channel。
官方 API 需要配置 OAuth 2.0、管理 bearer token、处理分页 cursor,并谨慎跟踪速率限制。ApiPass 将其替换为简单的两步任务模式(createTask + recordInfo),并支持可选 webhooks——除单个 API key 外无需额外认证流程,也无需在你这一侧维护速率限制逻辑。
跟踪竞争对手品牌账号,了解其内容发布节奏、信息传达策略和受众互动模式。
营销机构可以拉取历史推文数据,在签约前验证影响者的发帖稳定性、内容质量和受众互动情况。
聚合有影响力的交易员、项目创始人或分析师的推文,为自动化交易信号和市场情绪模型提供数据。
研究人员和记者可以收集公众人物的推文时间线,用于话语分析、虚假信息研究或调查报道。
在 ApiPass 注册,并从仪表盘生成你的 Bearer API key。这个单一 key 可用于认证你的所有请求——无需 OAuth 流程、无需开发者账号审批,也无需 token 刷新逻辑。
向 https://api.apipass.dev/api/v1/jobs/createTask 发送 POST 请求,将 model 设置为 twitter/graphql/user-tweets,传入目标 userId 和所需 count。你可以使用 includePromotedContent、withVoice、withV2Timeline 和 withQuickPromoteEligibilityTweetFields 等 boolean 标志精细调整响应 payload。也可以选择传入 callBackUrl,在任务完成瞬间接收推送通知。API 将返回一个唯一的 taskId 用于跟踪。
使用返回的 taskId 查询 GET /api/v1/jobs/recordInfo?taskId=....。监控 state 字段在 waiting、queuing 和 generating 之间流转。当 state 变为 success 后,完整推文时间线将出现在 resultJson.resultObject 字段中,可直接解析并集成到你的应用。
所有 API 都需要通过 Bearer Token 进行身份验证。
Authorization: Bearer
创建用于获取用户推文的任务
该 API 接受以下结构的 JSON 负载:
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 // Input parameters
7 }
8}model必填string用于生成的模型名称
"twitter/simple/user-tweets"
callBackUrl可选string任务完成通知的回调 URL。如省略,则不会发送回调。
"https://your-domain.com/api/callback"
channel可选string你可以通过 channel 参数指定 APIPASS 中对应的提供方;这些提供方会处理实际的图像和视频生成任务。APIPASS 当前提供三种提供方选项:
channel 参数的默认值为 auto。启用后,APIPASS 会根据实时价格和稳定性指标,在可用提供方之间自动分配任务,以平衡最低成本与可靠性能。除非你有自定义路由需求,否则请保留默认值 auto。
可用选项:
auto
input 对象包含以下参数:
input.user_id必填string用户 ID
为获得最佳效果,请描述主体、风格、光照和构图
44196397
1curl -X POST "https://api.apipass.dev/api/v1/jobs/createTask" \
2 -H "Content-Type: application/json" \
3 -H "Authorization: Bearer YOUR_API_KEY" \
4 -d '{
5 "model": "twitter/simple/user-tweets",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "user_id": "44196397"
9 }
10 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}code状态码,200 表示成功,其他表示失败
message响应消息,失败时为错误描述
data.taskId用于查询任务状态和结果的任务 ID