Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
还没有输出。提交表单以生成内容。
透明定价，无隐藏费用。按需支付。
| 规则与模式 | 渠道 | 积分 | 价格（美元） | 官方/参考价格 | 每日节省 |
|---|---|---|---|---|---|
user-media otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 使用完整指南
通过一次异步 API 调用，获取任意 Twitter 用户的完整媒体时间线——包括照片、视频和 GIF。
ApiPass 上的 Twitter Graphql User Media API 是一个托管端点，只需提供用户 ID，即可获取任意公开 Twitter (X) 账号的完整媒体时间线。它构建在 Twitter 内部 GraphQL 基础设施之上，会返回结构化 JSON 载荷，其中包含目标用户发布的每张照片、每个视频和 GIF，以及丰富的元数据，例如发布时间戳、互动指标和媒体 URL。ApiPass 将此功能封装为基于异步任务的工作流：你向 /api/v1/jobs/createTask 提交请求，使用模型 twitter/graphql/user-media，获得 taskId，然后可以轮询 /api/v1/jobs/recordInfo，或注册回调 URL，在处理完成后接收结果。该设计免去了令牌管理、速率限制和爬取基础设施等麻烦，让开发者专注于构建功能，而不是维护数据管道。
跳过官方 X API 冗长的审批流程、企业级付费门槛和配额限制。只需一个 ApiPass API key 即可立即访问。
默认 auto 通道会根据实时价格和稳定性指标，在可用提供商之间自动分配任务，无需手动配置即可在最低成本与可靠性能之间取得平衡。
可根据预算和可靠性需求，在 starter（超低成本）、regular（标准层级，价格远低于官方 API）或 official（原生 Twitter API，高稳定性）之间选择。
提交任务后，可通过 webhook 回调或轮询接收结果，非常适合高吞吐量批处理场景，在这些场景中阻塞式调用并不实用。
返回与 Twitter 自家网页客户端使用的相同深度嵌套数据，包括媒体变体、比特率、尺寸和推文上下文——比 REST 替代方案详细得多。
仅对成功任务付费，成本透明，并内置跨提供商故障转移，避免官方层级常见的意外超额账单。
使用 count 参数，可在单次请求中获取从少量最新媒体项到大批量媒体项的数据，按需优化时效性或覆盖范围。
切换 includePromotedContent、withBirdwatchNotes、withVoice、withClientEventToken 和 withV2Timeline 等字段，以包含或排除特定数据层，让载荷保持精简且相关。
每个任务都会展示清晰的生命周期状态——waiting、queuing、generating、success 或 fail——让你的应用能够智能响应处理进度，并优雅地处理错误。
自动拉取并展示创作者的完整视觉内容流，用于作品集网站、粉丝页面或个人品牌中心，无需手动上传。
持续同步竞品或合作品牌的媒体帖子到你的分析平台，用于视觉情绪分析和营销活动分析。
直接从公开 Twitter 账号收集大规模、按主题定向的图片和视频数据集，用于微调计算机视觉或多模态模型。
为信息流应用、情绪板或趋势发现平台提供能力，展示来自影响者、记者或垂直社区的最新视觉内容。
了解 ApiPass 的 User Media 端点在可访问性、成本和数据丰富度方面如何与 Twitter 官方 API 对比，以及为什么开发者正在转向它。
官方 Twitter API v2 /users/:id/tweets 端点配合媒体 expansions 使用时，需要付费开发者账号，仅 Basic 层级就需 $200/month，且有严格的月度帖子上限。ApiPass 的 User Media 端点无需 Twitter 审批，按任务计费，并为仍希望获得原生 API 稳定性的用户提供价格有竞争力的 official 通道。
Twitter 官方 REST API 需要多个 expansion 参数，并将 includes.media 数组拼接起来，才能组装出干净的媒体时间线。ApiPass 直接暴露底层 GraphQL UserMedia 操作，返回与 Twitter 自家网页客户端使用的相同高密度、预关联结构——包括 v2 时间线模块、语音元数据和 Birdwatch 笔记——所有内容都可通过简单的布尔标志切换。
在签订合作前，审计影响者的视觉内容历史，以评估品牌契合度、发布节奏和互动质量。
为记者、公众人物或组织构建自动备份系统，在账号丢失或平台变更时，仍能长期保留其 Twitter 媒体记录。
调查人员和记者可以在突发事件期间，系统性地检索关键账号的媒体证据，并保留带时间戳和元数据的视觉上下文。
品牌可以将标记其产品的客户或大使媒体内容拉取到可购物图库、评论页面或社会认同组件中。
在 ApiPass 注册，从仪表盘生成 Bearer token，即可开始对每个请求进行身份验证。
向 /api/v1/jobs/createTask 发送 POST，包含 "model": "twitter/graphql/user-media"、目标 userId（例如 "44196397"），以及 count 或 withV2Timeline 等可选标志。你将立即在响应中收到 taskId。
可以轮询 GET /api/v1/jobs/recordInfo?taskId=...，直到 state 变为 success；也可以在创建任务时提供 callBackUrl，让 ApiPass 在生成完成的瞬间将完成的 resultJson 直接推送到你的服务器。
所有 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
