还没有输出。提交表单以生成内容。
透明定价,无隐藏费用。按需支付。
| 规则与模式 | 渠道 | 积分 | 价格(美元) | 官方/参考价格 | 每日节省 |
|---|---|---|---|---|---|
followers otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 使用完整指南
通过一次 API 调用获取任意公开 Twitter (X) 账号的完整关注者列表——无需 OAuth、无需开发者审批,也无需为速率限制烦恼。

ApiPass 上的 Twitter Graphql Followers API 是一个托管端点,可直接接入 Twitter 的内部 GraphQL 层,返回任意公开 X 账号的关注者。向 /api/v1/jobs/createTask 端点提交目标 userId,并使用 model twitter/graphql/followers 后,你将获得一个 taskId,可通过轮询(或通过 webhook callback 投递)获取丰富的 JSON payload,其中包含每位关注者的个人资料元数据——包括 screen name、简介、关注者/正在关注数量、认证状态、头像、创建日期等。不同于官方 X API(其于 2026 年 2 月 6 日默认推出按量付费,按 API 请求收取 credits,并要求复杂的 OAuth 流程),ApiPass 将所有能力封装在一次简单的 bearer-token REST 调用之后,让你几分钟内即可开始导出关注者数据。
跳过 Twitter 多步骤的应用审核和密钥轮换流程。只需使用一个 Authorization: Bearer YOUR_API_KEY header 进行认证,即可立即开始拉取关注者数据。
官方 X API 会收取可观的按资源计费费用,并且 pay-per-use 每月最多只能读取 2 million 条 posts;超过后,X 会要求你升级到 Enterprise 定价,起价为每月 $42,000。ApiPass 会自动将你的请求路由到最具成本效益的 provider。
默认的 channel: auto 设置会根据价格和稳定性,实时将每个 task 分配到可用 providers,让你无需自行编写路由逻辑,就能获得成本与可靠性的最佳平衡。
提交一个 task,获得一个 taskId,然后可以轮询 /api/v1/jobs/recordInfo,或在 job 完成时通过你的 callBackUrl 接收 callback。非常适合批量导出关注者,避免同步请求超时。
你会收到 Twitter 自有客户端可见的完整原始 timeline 结构,包括 user_results.result.legacy 字段、专业资料数据、is_blue_verified flags 和 affiliate badges——这些字段通常会被官方 v2 REST API 去除,或隐藏在 expansion parameters 后面。
选择 starter 以处理超低成本的批量 jobs,选择 regular 以支持均衡的生产 workloads,或在需要与 Twitter 原生 API 一致的稳定性和速度时选择 official——全部都通过一个统一端点提供。
每条关注者记录都会返回完整的 TimelineUser 对象:rest_id、screen_name、name、description、followers_count、friends_count、statuses_count、created_at、profile_image_url_https、profile_banner_url、认证状态、置顶 tweet IDs,以及专业类别元数据。
通过 input.variables.count 参数控制每个 task 拉取的关注者记录数量,唯一必填字段为 userId。可切换 includePromotedContent,将推广内容从结果中过滤掉。
每个 job 都会暴露清晰的状态——waiting、queuing、generating、success 或 fail——并包含 createTime、completeTime 和 costTime 字段,便于你监控性能,并将失败原因直接展示给用户。
可视化创作者、品牌或竞争对手的关注者增长、受众画像、认证关注者比例以及影响者重叠情况。
拉取相关行业账号的关注者,根据简介关键词和关注者数量进行评分,并将合格潜在客户推送到你的销售管道。
识别任意目标账号的高信号关注者(已认证、followers_count 较高、具有细分专业类别),为营销活动寻找创作者资源。
导出关注者网络,用于情感分析、社区发现,或围绕公众人物和话题研究受众变化的长期趋势。
了解 ApiPass 在定价、访问要求和响应丰富度方面如何对比 Twitter 官方 API,以及为什么大多数开发者使用 ApiPass 能更快上线。
官方 X API 采用 pay-per-use credit system,其中 owned reads——即由你自己的 developer app 为你自己的数据(如 posts、bookmarks、followers 和 lists)发起的请求——按每个 resource $0.001 计费;但拉取其他账号的 followers 需要按标准(non-owned)读取定价收费,成本显著更高,并且还需要付费 tier subscription。ApiPass 没有月度订阅门槛、没有开发者审批关卡,也没有 2M-read 上限——你按 task 付费,并且从第一天起就可以面向任意公开账号。
官方 v2 REST API 返回的是规范化 JSON,需要使用 expansion parameters 并组装字段才能获得更丰富的数据;其速率限制按 endpoint、auth type 和 15-minute window 分别计算,超出后会返回 429 status code。ApiPass 则通过简单的异步 task 模型暴露原始 Twitter GraphQL 响应——默认包含所有 legacy field、professional badge 和 affiliate label——无需管理 15-minute windows。
定期导出竞争对手的关注者列表,跟踪他们的受众与你的重叠情况,并发现尚未触达的细分人群。
分析新关注者的账号年龄(created_at)、statuses_count 和 default_profile_image flag,以识别自有账号上的非真实互动。
在发布里程碑时快照关注者列表,用于空投 tokens、设置 Discord 访问门槛,或奖励创作者账号的早期支持者。
拉取垂直领域中记者、分析师和意见领袖的关注者,用于绘制影响力网络并优化外联名单。
在 ApiPass 注册,从仪表板生成 bearer token,并将其复制到你的 Authorization: Bearer YOUR_API_KEY header 中。
向 https://api.apipass.dev/api/v1/jobs/createTask 发送 POST 请求,使用 model: "twitter/graphql/followers",并提供包含目标 userId(必填)的 input.variables 对象,也可选填 count 和 includePromotedContent 字段。如果你希望接收 webhook 通知,请包含 callBackUrl。响应中会返回一个 taskId。
你可以等待 callback 触发到你的 callBackUrl,或者 GET https://api.apipass.dev/api/v1/jobs/recordInfo?taskId=task_xxxx 进行轮询,直到 state 为 success。完整的关注者 payload——包括每位用户的个人资料元数据、认证状态和互动数量——都将在 data.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