Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
还没有输出。提交表单以生成内容。
透明定价，无隐藏费用。按需支付。
| 规则与模式 | 渠道 | 积分 | 价格（美元） | 官方/参考价格 | 每日节省 |
|---|---|---|---|---|---|
retweeters otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 使用完整指南
通过一次 API 调用，获取转推任意公开推文的完整用户列表。
ApiPass 上的 Twitter Graphql Retweeters API 是一个托管端点，可让开发者以编程方式获取在 X（原 Twitter）上转推指定推文的用户列表。提交 tweetId，并可选提供分页和筛选参数后，你将获得结构化的转推账号数据集，非常适合用于互动分析、受众研究和内容传播追踪。该 API 基于异步任务模型构建，会在后台处理繁重的抓取工作：你可以使用模型 twitter/graphql/retweeters，通过 POST /api/v1/jobs/createTask 创建任务，然后通过轮询或接收回调，经由 /api/v1/jobs/recordInfo 获取结果。这种方式将你的应用与速率限制和长时间运行的请求解耦，让大规模转推者数据采集更简单、更可靠。
无需管理 Twitter 开发者账号、OAuth 流程或轮换凭证。一个 ApiPass Bearer API key 即可解锁所有端点。
默认的 channel: auto 设置会根据实时价格和稳定性指标，将每个任务分配到可用提供方，在最低成本与可靠性能之间取得平衡。
提交任务后可立即获得 taskId。系统会在后台完成抓取，因此你的应用不会因上游响应缓慢而阻塞。
提供 callBackUrl 后，ApiPass 会在任务完成的第一时间将结果推送到你的服务器，无需轮询。
可在 starter（超低成本）、regular（标准层，远低于官方价格）和 official（原生 Twitter API 的稳定性与速度）之间选择，以匹配你的预算和 SLA 需求。
结果会以清晰的 JSON 封装返回（code、message、data.resultJson），并提供明确的任务生命周期状态（waiting、queuing、generating、success、fail），便于集成。
传入任意公开 tweetId（例如 1694634492403843248），即可获取该特定帖子的转推者列表。
使用 count 参数（默认 20）控制每个任务返回的转推者记录数量，可根据速度或完整性需求进行优化。
切换 includePromotedContent（boolean）以在响应中包含或排除推广/广告相关条目，保持自然互动数据的纯净。
识别放大特定帖子的高触达人群账号，并将其作为外联潜在对象呈现。识别放大特定帖子的高触达人群账号，并将其作为外联潜在对象呈现。
可视化展示是谁在一段时间内传播你的内容，或竞争对手的内容。
将转推者列表输入 CRM 或 ML 系统，用于构建相似受众并优化定向。
当你关注的重要账号转推特定推文时，触发提醒和下游工作流。
虽然 Twitter Official API 提供对转推者数据的直接访问，但也伴随着显著门槛——严格的开发者审批、分层使用上限，以及会随规模快速增长的固定定价。ApiPass 提供了一种更简化的替代方案，通过更简单的集成模型、灵活的提供方路由和大幅降低的成本，交付相同的数据。
Twitter Official API 需要经过审批的开发者账号，并对其转推查询端点实施严格的按层级月度帖子配额和速率限制。ApiPass 将这一切都抽象掉——只需使用你的 API key 发送请求，并仅为你运行的任务付费。
Twitter Official API 提供单一固定定价模式，而 ApiPass 会在 starter、regular 和 official 渠道之间自动路由你的任务，以极低成本交付相同的转推者数据；当你需要与原生服务保持一致时，也始终可以使用 official。
衡量哪些影响者和社群推动了品牌推文的传播。
追踪谁在转推竞争对手公告，以绘制其支持者网络。
快速列举病毒式传播或敏感帖子的放大者，为响应策略提供依据。
收集结构化的转推传播数据，用于信息扩散、错误信息或网络分析等研究。
注册 ApiPass，并从你的仪表盘生成 Bearer token。这个单一 key 可解锁所有端点，无需 Twitter 开发者账号或 OAuth 设置。
向 /api/v1/jobs/createTask 发送 POST 请求，将 model 设置为 twitter/graphql/retweeters，提供目标 tweetId，并可选传入 count 和 includePromotedContent 等参数。你也可以包含 callBackUrl 以自动接收结果。API 会立即返回一个 taskId，供你用于跟踪进度。
你可以等待 ApiPass 将结果推送到你的 callBackUrl，或轮询 GET /api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID，直到 state 字段变为 success。完整的转推者列表将位于 data.resultJson.resultObject 中，可直接供你的应用使用。
所有 API 都需要通过 Bearer Token 进行身份验证。
Authorization: Bearer
获取转发该推文的用户列表
该 API 接受具有以下结构的 JSON payload：
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "tweetId": "string",
8 "count": "number",
9 "includePromotedContent": "boolean",
10 }
11 }
12}model必填string用于生成的模型名称
"twitter/graphql/retweeters"
callBackUrl可选string用于任务完成通知的回调 URL。如果省略，则不会发送回调。
"https://your-domain.com/api/callback"
channel可选string你可以通过 channel 参数在 APIPASS 中指定对应的提供方；这些提供方负责实际的图像和视频生成任务。APIPASS 目前提供三种提供方选项：
channel 参数的默认值为 auto。启用后，APIPASS 会根据实时价格和稳定性指标，在可用提供方之间自动分配任务，以平衡最低成本与可靠性能。除非你有自定义路由需求，否则请保留默认值 auto。
可用选项：
auto
input 对象包含以下参数：
input.variables.tweetId必填string1694634492403843248
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/user-by-screen-name",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "variables": {
9 "tweetId": "1694634492403843248",
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
