还没有输出。提交表单以生成内容。
透明定价,无隐藏费用。按需支付。
| 规则与模式 | 渠道 | 积分 | 价格(美元) | 官方/参考价格 | 每日节省 |
|---|---|---|---|---|---|
followers-you-know otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 使用完整指南
通过一次由 GraphQL 驱动的 API 调用,获取共同连接列表——也就是你和另一位 Twitter/X 用户都认识的关注者。

ApiPass 上的 Twitter Graphql Followers You Know API 是一个异步端点,可接入 Twitter/X 的内部 GraphQL 层,获取你(已认证用户)和目标用户共同关注的账号列表。提交目标 userId 和你的 AuthToken 后,ApiPass 会创建一个后台任务,并返回丰富的时间线载荷,其中包含每个共同连接的详细用户资料——包括 screen name、显示名称、关注者数量、认证状态、专业类别和个人资料媒体等信息。它基于 ApiPass 统一的任务式架构(createTask → recordInfo)构建,屏蔽了 Twitter 私有 GraphQL schema 的复杂性,让开发者可以专注于消费清晰、结构化的 JSON 结果。
无需费力解码 Twitter 私有 GraphQL 查询 ID、功能开关和变量 schema。ApiPass 会处理底层协议,你只需传入一个简单的 JSON body。
ApiPass 会根据实时价格和稳定性指标,在 starter、regular 和 official 提供商之间自动分配请求,无需任何手动配置,即可在成本与可靠性之间获得最佳平衡。
发起请求后可立即获得 taskId,并通过 webhook(callBackUrl)接收结果,或通过轮询 recordInfo 获取结果。非常适合批量社交图谱分析,无需长时间保持 HTTP 连接。
每条共同关注者记录都包含 rest_id、screen_name、follower/friends counts、is_blue_verified、专业类别、个人资料图片、横幅 URL 和置顶推文——你所需的信息都在一个载荷中。
starter 和 regular 渠道的价格远低于 Twitter 官方企业 API 层级;当你需要时,official 渠道则提供接近原生的稳定性。
使用你的 ApiPass Bearer API key 访问平台,并使用标准 Twitter auth_token cookie 获取用户范围数据,从而可在同一个计费账号下扩展多个 Twitter 身份。
使用 count 参数(例如 20)控制每个任务返回的共同关注者数量,便于针对分页或预览场景调整载荷大小。
includePromotedContent 布尔值可让你从时间线中干净地排除赞助条目,使数据集专注于自然产生的共同连接。
结果会在完整的 TimelineAddEntries 结构中返回,并包含 TimelineUser 项,保留 Twitter 原生排序(sortIndex)和条目 ID,便于下游对账与匹配。
构建销售或社交网络应用,展示你的现有关注者中有哪些人已经关注某个潜在客户,从而用暖介绍替代冷启动外联。
可视化你的受众与任何竞品、影响者或合作伙伴账号之间的重叠情况,以识别共同社区和交叉推广机会。
将共同关注者数据与 is_blue_verified、followers_count 和专业类别信号结合,在投入活动预算前评估可信度。
在用户个人资料页嵌入一个展示共同连接的迷你信息流,在你的产品中模拟原生“Followers you know”体验。
Twitter 官方 API 将关注者图谱端点限制在昂贵的 Enterprise 层级,并伴随严格的速率限制和漫长的申请审核。ApiPass 通过简单的 POST /api/v1/jobs/createTask 调用开放相同的 GraphQL 端点,并在三个提供商渠道中提供按量付费定价——无需企业合同。
官方 API 返回原始 GraphQL 响应,需要你自行管理查询哈希、功能开关以及带 PKCE 的 OAuth 2.0。ApiPass 将所有内容封装为一个 JSON body(model、input.AuthToken、input.variables),并通过回调或轻量级 GET /recordInfo?taskId=... 轮询返回结果,大幅缩短集成时间。
在 X 上联系潜在客户之前,销售团队可查询共同关注者,找出能够促成介绍的暖连接,从而提升回复率。
信任团队可绘制可疑协同账号之间的共同关注者图谱,以检测僵尸网络、马甲账号或非真实行为集群。
代理机构可将品牌与受众和品牌现有关注者高度重叠的创作者进行匹配,确保更高 ROI 的合作。
研究 X 上信息扩散或同质性的研究人员,可大规模收集共同关注者边,用于构建网络分析所需的标注图数据集。
在 ApiPass 注册以获取你的 Bearer API key,然后在浏览器中登录 Twitter/X,并从 F12 → Application → Cookies 复制 auth_token 值——这就是你的 input.AuthToken。
向 https://api.apipass.dev/api/v1/jobs/createTask 发送 POST 请求,包含 model: "twitter/graphql/followers-you-know"、目标 userId、你的 count,以及(可选的)callBackUrl。你会立即收到 taskId。
可以等待 webhook 请求你的回调 URL,或持续 GET /api/v1/jobs/recordInfo?taskId=...,直到 state 转为 success。解析 resultJson.resultObject.data.user.result.timeline,以遍历每一条共同关注者记录。
所有 API 都需要通过 Bearer Token 进行身份验证。
Authorization: Bearer
获取你可能认识的关注者。
该 API 接受具有以下结构的 JSON 载荷:
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "AuthToken": "string",
7 "variables": {
8 "userId": "string",
9 "count": "number",
10 "includePromotedContent": "boolean",
11 }
12 }
13}model必填string用于生成的模型名称
"twitter/graphql/followers-you-know"
callBackUrl可选string用于接收任务完成通知的回调 URL。如省略,则不会发送回调。
"https://your-domain.com/api/callback"
channel可选string你可以通过 channel 参数指定 APIPASS 内对应的服务商;这些服务商负责实际的图像和视频生成任务。APIPASS 目前提供三种服务商选项:
channel 参数的默认值为 auto。启用后,APIPASS 会根据实时价格和稳定性指标,在可用服务商之间自动分配任务,以平衡最低成本和可靠性能。除非你有自定义路由需求,否则请保留默认值 auto。
可用选项:
auto
input 对象包含以下参数:
input.variables.userId必填string44196397
input.variables.count可选number20
input.variables.includePromotedContent可选booleanfalse
input.AuthToken必填string打开 Twitter 主页并登录,然后前往 F12 > Application > Storage > Cookies > auth_token。

YOUR_X_AUTH_TOKEN
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/followers-you-know",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "AuthToken": "YOUR_X_AUTH_TOKEN",
9 "variables": {
10 "userId": "44196397",
11 "count": 20,
12 "includePromotedContent": false,
13 }
14 }
15 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}code状态码,200 表示成功,其他表示失败
message响应消息,失败时为错误描述
data.taskId用于查询任务状态和结果的任务 ID