Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
还没有输出。提交表单以生成内容。
透明定价，无隐藏费用。按需支付。
| 规则与模式 | 渠道 | 积分 | 价格（美元） | 官方/参考价格 | 每日节省 |
|---|---|---|---|---|---|
list-latest-tweets-timeline otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 使用完整指南
通过一次由 GraphQL 驱动的 API 调用，获取任意公开 Twitter List 的最新推文时间线。
ApiPass 上的 Twitter Graphql List 最新推文时间线 API 是一个托管端点，开发者可通过特定 Twitter (X) List 的唯一 listId，获取该列表成员发布的最新推文。该 API 构建在 Twitter 内部 GraphQL 基础设施之上，并通过 ApiPass 统一的 createTask / recordInfo 任务流程对外提供服务，返回包含推文对象、作者元数据、互动指标和媒体附件的结构化 JSON 时间线。你无需直接处理 Twitter 的认证流程、速率限制或未公开的 GraphQL 参数，只需提交一个包含目标 listId、可选 count 和 includePromotedContent 标志的任务，然后轮询，或在时间线数据准备就绪后接收 webhook 回调。
跳过 Twitter 冗长的申请审核、项目审批和高级访问权限门槛。只需使用一个 ApiPass API key 进行认证，即可立即开始拉取列表时间线。
该端点采用先创建任务、再获取结果的模式，会立即返回 taskId，因此你的应用不会因长时间运行的抓取任务而阻塞。结果可通过 recordInfo 轮询或可选的 callBackUrl webhook 交付。
ApiPass 会根据实时价格和稳定性指标，自动在 starter、regular 和 official 提供方之间分配每个请求，在最低成本与可靠性能之间取得平衡——无需手写故障转移代码。
避免 Twitter 昂贵的 Basic/Pro/Enterprise 月度套餐。你只需为实际运行的列表时间线任务付费，对原型开发和生产工作负载都更具成本效益。
响应会封装在一致的 resultJson.resultObject.data.list.tweets_timeline 结构中，与 Twitter 的 GraphQL schema 保持一致，因此无需编写自定义 HTML/HAR 解析器即可集成。
每个任务都会暴露生命周期状态（waiting、queuing、generating、success、fail），以及 createTime、completeTime 和 costTime 字段，让你能够全面观测请求性能。
使用可选的 count 参数（例如 20）控制每次调用返回的推文数量，在新鲜度和载荷大小之间按你的使用场景取得平衡。
将 includePromotedContent: false 切换为排除赞助/推广推文，只接收由列表成员发布的自然内容流。
创建任务时提供 callBackUrl，ApiPass 将通过 POST 将完成后的时间线直接发送到你的端点，无需轮询完成状态。
从记者或行业专家 List 拉取推文，在你自己的产品或通讯中构建实时新闻流。
监控竞争对手或意见领袖 List，并实时呈现提及、话题标签和趋势。
构建 Slack、Discord 或 Telegram 机器人，将私有团队精选 List 中的最新推文广播给相关方，帮助他们保持信息同步。
持续采集特定主题的 List 时间线，为 LLM 微调、情感分析或学术研究构建高信号语料库。
了解与 Twitter 官方 List 时间线端点相比，ApiPass 如何简化访问、定价和集成。
Twitter 官方 GET /2/lists/:id/tweets 端点在首次调用前需要付费 Developer Portal 订阅、创建项目并完成 OAuth 2.0 设置。ApiPass 用一个 bearer token 和设置为 twitter/graphql/list-latest-tweets-timeline 的 model 字段替代所有这些步骤——你可以在几分钟内上线，而不是等待数天。
Twitter 官方套餐设置严格的月度帖子上限和分级定价，费用可能扩展到每月数千美元。ApiPass 采用按任务按量付费模式，并具备智能提供方路由（auto channel），因此成本会随用量线性增长，没有最低承诺，也没有意外超额费用。
关注由交易员、分析师或协议创始人组成的精选 List，在影响市场的推文发布瞬间捕捉信号。关注由交易员、分析师或协议创始人组成的精选 List，在影响市场的推文发布瞬间捕捉信号。
追踪客户、合作伙伴或批评者 List，近实时捕捉对你的品牌或产品的提及。
将编辑精选 List 的最新帖子同步到 CMS、博客侧边栏或移动应用信息流，无需手动复制粘贴。
汇总竞争对手账号 List 中的推文，并运行下游 NLP，以跟踪产品发布、招聘公告或公关活动。
注册 ApiPass，进入仪表盘并生成 bearer token。无需 Twitter Developer account 或 OAuth 握手——你的 ApiPass key 是认证每个请求所需的唯一凭证。
向 /api/v1/jobs/createTask 发送 POST 请求，将 model 设置为 twitter/graphql/list-latest-tweets-timeline，并在 input.variables 对象中填入目标 listId。你也可以包含可选参数，例如 count 用于限制返回的推文数量，includePromotedContent 用于过滤赞助帖子，以及 callBackUrl 用于通过 webhook 交付结果。ApiPass 会立即响应一个 taskId，你可以用它跟踪任务。
你可以等待 ApiPass 将完成后的时间线推送到你的 callBackUrl，或使用 taskId 轮询 GET /api/v1/jobs/recordInfo。当任务状态转换为 success 后，完整的列表时间线将在 data.resultJson.resultObject.data.list.tweets_timeline 下可用，可直接解析并集成到你的应用中。
所有 API 都需要通过 Bearer Token 进行身份验证。
Authorization: Bearer
获取该 List 的最新推文时间线。
该 API 接受具有以下结构的 JSON payload：
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "listId": "string",
8 "count": "number",
9 "includePromotedContent": "boolean",
10 }
11 }
12}model必填string用于生成的模型名称
"twitter/graphql/list-latest-tweets-timeline"
callBackUrl可选string用于任务完成通知的回调 URL。如果省略，则不会发送回调。
"https://your-domain.com/api/callback"
channel可选string你可以通过 channel 参数指定 APIPASS 中对应的服务商；这些服务商会处理实际的图像和视频生成任务。APIPASS 目前提供三种服务商选项：
channel 参数的默认值为 auto。启用后，APIPASS 会根据实时价格和稳定性指标，在可用服务商之间自动分配任务，以平衡最低成本和可靠性能。除非你有自定义路由需求，否则请保留默认值 auto。
可用选项：
auto
input 对象包含以下参数：
input.variables.listId必填string44196397
input.variables.count可选number20
input.variables.includePromotedContent可选booleanfalse
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/list-latest-tweets-timeline",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "variables": {
9 "listId": "123",
10 "count": 20,
11 "includePromotedContent": false,
12 }
13 }
14 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}code状态码，200 表示成功，其他表示失败
message响应消息，失败时为错误描述
data.taskId用于查询任务状态和结果的任务 ID
