Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
还没有输出。提交表单以生成内容。
透明定价，无隐藏费用。按需支付。
| 规则与模式 | 渠道 | 积分 | 价格（美元） | 官方/参考价格 | 每日节省 |
|---|---|---|---|---|---|
home-latest-timeline otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 使用完整指南
通过一次由 GraphQL 驱动的 API 调用，以真实的逆时间顺序获取已认证用户最新的首页时间线。
ApiPass 上的 Twitter Graphql Home Latest Timeline API 是一个基于异步任务的端点，可让你获取 Twitter/X 首页时间线的“Following”（Latest）标签页——也就是来自已认证用户所关注账号的、按逆时间顺序排列的同一条推文信息流。它构建在 Twitter 内部 GraphQL 层之上，返回内容丰富的载荷，包括完整推文内容、媒体、互动指标（点赞、转推、回复、收藏、浏览量）、作者资料数据、推广内容标记以及时间线指令。你可以使用 twitter/graphql/home-latest-timeline 模型通过 POST /api/v1/jobs/createTask 提交任务，并通过 GET /api/v1/jobs/recordInfo 获取结果；任务完成时也可选择通过回调投递结果。该逆时间顺序时间线端点会返回出现在用户首页时间线中的 Tweets，并将最新的 Tweets 排在最前。
无需经历冗长的 X Developer 审批流程、项目设置以及 OAuth 1.0a/2.0 配置。只需一个 ApiPass API key 即可开始使用。
不同于精简后的 v2 REST 响应，你将获得 Twitter 自家 Web 客户端所使用的深层对象结构，包括卡片数据、浏览量、对话控制以及推广元数据。
channel: auto 参数会根据实时价格和稳定性指标，在可用供应商之间自动分配你的任务，从而在最低成本与可靠性能之间取得平衡。
可根据你的预算和可靠性需求，在 starter（超低成本）、regular（标准层，价格远低于官方 API）或 official（原生 Twitter API 定价，稳定性最高）之间选择。
提交任务后即可立即获得 taskId；你可以轮询结果，也可以通过 callBackUrl 接收推送通知——非常适合高并发、非阻塞型工作负载。
每个任务都会返回包含 code、message、state、costTime 和 resultJson 字段的标准化封装，让错误处理和监控更简单直接。
严格按照所关注账号发布推文的时间顺序返回，不进行算法排序，与官方 Twitter/X 客户端中的“Latest”标签页保持一致。
可通过 count 控制返回的推文数量，通过 includePromotedContent 切换推广内容，通过 latestControlAvailable 启用相关控制，并设置 requestContext（例如 launch）以匹配特定客户端行为。
每个条目都包含完整的推文正文、entities（URLs、mentions）、带关注者数量和认证状态的作者 user_results、互动计数、浏览状态、来源归因，以及 TimelineAddEntries 和 TimelineShowCover 等时间线指令。
为第三方阅读器应用和浏览器扩展提供能力，用于展示无广告、无算法重排序的纯时间顺序信息流。
持续从精选的关注关系图中拉取最新推文，为品牌监控、公关或竞品追踪仪表盘提供数据。
当你关注的特定账号发布包含目标关键词的新推文时，触发通知（Slack、Discord、email、SMS）。
将你的关注信息流接入 LLM 流水线，用于摘要生成、情感评分、主题聚类或个性化每日简报。
了解 ApiPass 如何简化访问、扩展响应深度，并消除 Twitter 官方开发者平台带来的接入阻力。
官方端点需要 OAuth 1.0a User Context 或带 PKCE 的 OAuth 2.0 Authorization Code，并且需要已获批准的 X Developer 账号和项目。ApiPass 用单个 Bearer token 替代了整个流程——无需注册应用、无需 OAuth 握手，也无需刷新 user-context tokens。
官方 v2 逆时间顺序首页时间线端点会返回已认证用户及其关注账号发布的最新 Tweets 和 Retweets，但采用扁平化 REST 格式，并有严格的速率上限（每 15 分钟最多 180 次请求，最多 3,200 条推文）。ApiPass 代理 Twitter 原生 GraphQL 响应——也就是 twitter.com 使用的同一响应——为你提供 v2 REST 端点省略的卡片绑定、对话控制、浏览量、推广元数据和时间线封面，并且使用 ApiPass 基于任务的配额体系，而不是按用户计的速率限制。
关注数百个来源的记者和新闻编辑室可以每分钟拉取最新帖子，在内容成为趋势之前发现突发新闻。
以真实时间顺序跟踪已关注的金融影响者列表中的 cashtag 提及和分析师评论，用于对时间敏感的交易信号。
管理多个品牌账号的代理机构可以通过程序化方式查看每个账号的首页时间线，发现值得互动的对话。
按固定间隔采集时间线快照，用于研究特定关注关系图中的信息扩散、网络效应或内容传播速度。
在 ApiPass 注册，并从你的仪表盘生成 Bearer token。
使用模型标识符 twitter/graphql/home-latest-timeline，向 /api/v1/jobs/createTask 端点发送 POST 请求。配置你的输入变量，例如 count（要获取的推文数量）、includePromotedContent（切换广告）、latestControlAvailable 和 requestContext。如果你希望 ApiPass 在任务完成的瞬间将结果推送到你的服务器，也可以选择提供 callBackUrl。
ApiPass 会立即返回 taskId。使用该 ID 通过 /api/v1/jobs/recordInfo 端点查询任务状态——当 state 字段变为 success 后，完整的 GraphQL 时间线载荷将出现在 data.resultJson 中，可直接解析推文条目、作者资料、互动指标和时间线指令。如果你设置了回调 URL，则可以完全跳过轮询，在结果到达时立即处理。
所有 API 都需要通过 Bearer Token 进行身份验证。
Authorization: Bearer
获取 Home Latest 时间线。
该 API 接受具有以下结构的 JSON 负载：
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "count":"number",
8 "includePromotedContent": "boolean",
9 "latestControlAvailable": "boolean",
10 "requestContext": "string",
11 }
12 }
13}model必填string用于生成的模型名称
"twitter/graphql/home-latest-timeline"
callBackUrl可选string任务完成通知的回调 URL。如果省略，则不会发送回调。
"https://your-domain.com/api/callback"
channel可选string你可以通过 channel 参数指定 APIPASS 中对应的服务商；这些服务商负责实际的图像和视频生成任务。APIPASS 目前提供三种服务商选项：
channel 参数的默认值为 auto。启用后，APIPASS 会根据实时价格和稳定性指标，在可用服务商之间自动分配任务，以平衡最低成本和可靠性能。除非你有自定义路由需求，否则建议保留默认值 auto。
可用选项：
auto
input 对象包含以下参数：
input.variables.count必填number20
input.variables.includePromotedContent可选booleanfalse
input.variables.latestControlAvailable可选booleantrue
input.variables.requestContext可选stringlaunch
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/home-latest-timeline",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "variables": {
9 "count": 20,
10 "includePromotedContent": False,
11 "latestControlAvailable": True,
12 "requestContext": "launch",
13 }
14 }
15 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}code状态码，200 表示成功，其他表示失败
message响应消息，失败时为错误描述
data.taskId用于查询任务状态和结果的任务 ID
