Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
还没有输出。提交表单以生成内容。
透明定价，无隐藏费用。按需支付。
| 规则与模式 | 渠道 | 积分 | 价格（美元） | 官方/参考价格 | 每日节省 |
|---|---|---|---|---|---|
tweet-result-by-rest-id otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 使用完整指南
通过传入单个 tweet ID，检索完整的推文数据，包括文本、媒体、互动指标和元数据。
ApiPass 上的 Twitter Graphql Tweet Result By Rest Id API 是一个由 GraphQL 驱动的端点，允许开发者仅使用推文的唯一 tweet ID (rest_id) 获取任意公开推文的完整 payload。通过向 ApiPass 的统一任务系统发送一个简单的 POST 请求，你可以访问推文文本、作者信息、媒体附件（图片、视频、GIF）、互动统计（点赞、转发、回复、引用数量）、Birdwatch 注释、对话上下文等内容。它镜像了 Twitter 的内部 GraphQL schema，为你提供与 Twitter 自身网页客户端所使用的同样丰富、结构化的数据，同时无需处理 OAuth 流程、速率限制上限或企业级定价层级的复杂性。
跳过冗长的申请、审批和高级访问权限流程。只需获取一个 ApiPass API key，即可在几分钟内开始拉取推文。
避免 Twitter 每月 $5,000+ 的企业级套餐。ApiPass 按成功任务计费，对独立开发者和成长型初创公司都很友好。
默认的 auto channel 会根据实时价格和稳定性，在 starter、regular 和 official provider 之间自动分配每个请求，为你平衡成本与可靠性。
获取与 Twitter 原生前端使用的同等完整数据，包括媒体变体、视频码率、conversation IDs 和 editability flags，而不只是精简版的 v2 REST 响应。
提交任务后接收 taskId，然后可以轮询 recordInfo，或提供 callBackUrl 以在处理完成后接收结果。非常适合批处理工作流和 serverless functions。
可切换 withHighlightedLabel、withTweetQuoteCount、withBirdwatchPivots、withVoice 和 withReactions 等可选标志，仅获取你需要的字段，并保持 payload 精简。
返回完整的 legacy 字段、entities、extended_entities、conversation thread IDs 以及原始 GraphQL __typename，让你获取从 full_text 到 display_text_range 的全部内容。
包含所有媒体变体：HLS streams、多种码率的 MP4 renditions（288k / 832k / 2176k）、宽高比、时长、缩略图、focus rectangles 和 monetization status。
在请求发起时，直接从 Twitter 的 GraphQL 层拉取实时 favorite_count、retweet_count、reply_count 和 quote_count 值。
在你自己的网站、newsletter 或消息应用中，基于完整媒体和互动数据重建 Twitter 原生卡片预览。
为品牌、影响者或营销活动持续跟踪特定推文的表现。
保存推文快照，用于法律证据、新闻报道、事实核查平台或研究数据集。
将结构化推文数据输入 LLM 微调工作流、情感模型或趋势检测系统。
了解 ApiPass 由 GraphQL 驱动的推文检索能力，在可访问性、定价和数据深度方面与 Twitter 官方 v2 REST 端点的对比。
Twitter 官方 GET /2/tweets/:id 需要 Developer account，付费层级从 $200/month（Basic）起，并会随着生产级用量攀升到企业级水平。ApiPass 不需要 Twitter 审批，并通过 starter、regular 和 official channels 提供透明的按任务付费定价。
Twitter 的 v2 REST API 返回扁平化、需显式选择的字段 schema，需要多个 expansions 和 tweet.fields 参数才能拼出完整信息。ApiPass 在单次响应中返回完整的 GraphQL tweetResult.result 对象，包括 legacy entities、video variants、Birdwatch pivots 和 conversation metadata。
新闻编辑室和 OSINT 团队会拉取突发新闻中引用的单条推文，用于验证内容、捕获某一时刻的互动情况，并在删除前归档媒体。
营销平台可深入分析关于某个产品的特定爆款推文，提取影响情绪的引文、媒体素材和触达指标。
代理机构可直接从源头获取经过验证的转发、点赞、回复和引用数量，用于汇报赞助推文表现。
律师事务所和合规团队可检索不可变的推文快照（包括 video variants 和 timestamps），用于诉讼、下架争议或监管申报。
在 apipass.dev 创建 ApiPass 账户，并从你的 dashboard 生成 Bearer token。
向 /api/v1/jobs/createTask 发送 POST 请求，使用模型 twitter/graphql/tweet-result-by-rest-id，将目标 tweetId 放入 input.variables，并可选择添加 withTweetQuoteCount 或 withBirdwatchPivots 等标志。也可以包含 callBackUrl，以便自动接收结果。
使用返回的 taskId 请求 GET /api/v1/jobs/recordInfo?taskId=... 并检查 state。当 state 为 success 后，解析 resultJson.resultObject.data.tweetResult.result 以访问完整推文 payload。
所有 API 都需要通过 Bearer Token 进行身份验证。
Authorization: Bearer
通过 tweetId 获取推文结果
此 API 接受具有以下结构的 JSON 负载：
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "tweetId": "string",
8 "withHighlightedLabel": "boolean",
9 "withTweetQuoteCount": "boolean",
10 "includePromotedContent": "boolean",
11 "withBirdwatchPivots": "boolean",
12 "withVoice": "boolean",
13 "withReactions": "boolean",
14 }
15 }
16}model必填string用于生成的模型名称
"twitter/graphql/tweet-result-by-rest-id"
callBackUrl可选string用于任务完成通知的回调 URL。如果省略，则不会发送回调。
"https://your-domain.com/api/callback"
channel可选string你可以通过 channel 参数指定 APIPASS 中对应的提供方；这些提供方负责处理实际的图像和视频生成任务。APIPASS 目前提供三种提供方选项：
channel 参数的默认值为 auto。启用后，APIPASS 会根据实时价格和稳定性指标，在可用提供方之间自动分配任务，以在最低成本和可靠性能之间取得平衡。除非你有自定义路由需求，否则请保留默认值 auto。
可用选项：
auto
input 对象包含以下参数：
input.variables.tweetId必填string1694513603251241143
input.variables.withHighlightedLabel可选booleantrue
input.variables.withTweetQuoteCount可选booleantrue
input.variables.includePromotedContent可选booleantrue
input.variables.withBirdwatchPivots可选booleantrue
input.variables.withVoice可选booleantrue
input.variables.withReactions可选booleantrue
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/graphql/user-by-screen-name",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "variables": {
9 "tweetId": "1694513603251241143",
10 "withHighlightedLabel": true,
11 "withTweetQuoteCount": true,
12 "includePromotedContent": true,
13 "withBirdwatchPivots": true,
14 "withVoice": true,
15 "withReactions": true,
16 }
17 }
18 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}code状态码，200 表示成功，其他表示失败
message响应消息，失败时为错误说明
data.taskId用于查询任务状态和结果的任务 ID
