Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
还没有输出。提交表单以生成内容。
透明定价，无隐藏费用。按需支付。
| 规则与模式 | 渠道 | 积分 | 价格（美元） | 官方/参考价格 | 每日节省 |
|---|---|---|---|---|---|
user-by-screen-name otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 使用完整指南
只需传入一个 screen_name，即可即时获取完整的 X (Twitter) 用户资料数据——无需 OAuth、无需处理速率限制问题，也无需手动进行 GraphQL 签名。
ApiPass 上的 Twitter Graphql User By Screen Name API 是一个托管端点，它将 X 内部的 UserByScreenName GraphQL 操作封装在简洁的异步 REST 接口之后。你无需处理 guest tokens、query IDs、feature flags 或不断变化的 GraphQL hashes，只需将 screen_name（例如 elonmusk）POST 到 /api/v1/jobs/createTask，并将 model 设为 twitter/graphql/user-by-screen-name，ApiPass 就会返回一个 taskId，你可以通过 /api/v1/jobs/recordInfo 轮询结果，或通过 callBackUrl 自动接收结果。响应会返回完整的用户对象：rest_id、显示名称、简介、粉丝/关注数、认证状态、头像和横幅图片、创建日期、位置、置顶推文、高亮标签以及安全模式字段。在底层，ApiPass 的 channel: auto 路由器会实时将每次调用分发到 starter、regular 和 official providers，以平衡成本、稳定性和速度——因此你无需直接访问 /graphql/.../UserByScreenName 路径，也能获得生产级 Twitter 用户数据。
跳过整个 X 开发者门户流程。你只需要一个 Authorization: Bearer YOUR_API_KEY 请求头——无需应用审核、无需 consumer keys、无需 access tokens。
在 X 的按量计费模式下，用户资料查询每次约需 $0.010，且免费层级已不再向新开发者开放，现有用户也已迁移至按量计费。ApiPass 的多提供商路由会自动为你接入成本最低且稳定的通道。
默认的 channel: auto 可让 APIPASS 根据实时价格和稳定性指标，在 starter、regular 和 official providers 之间为每个任务分配通道——无需手动调优，即可获得最佳的价格与可靠性平衡。
不同于 X API v2 默认只返回 id/name/username，并要求你枚举字段和扩展项（X API v2 版本默认仅提供用户 id、name 和 username 字段，如需请求更多字段，则需要使用 fields 和 expansions 参数），GraphQL 端点可在一次调用中返回完整且丰富的用户对象。
即发即忘的任务会立即返回 taskId；提供 callBackUrl 后，ApiPass 会在结果准备好时将其推送到你的服务器——非常适合 serverless 和基于队列的架构。
无需在自己的代码中管理 15 分钟滚动窗口，无需刷新 guest-token 的逻辑，也无需应对 GraphQL query-hash 漂移——ApiPass 会处理所有上游复杂性，让你的应用保持简单。
传入 screen_name: "elonmusk"，即可获得完整的用户对象——包括 rest_id，这是几乎所有其他 Twitter GraphQL 端点（UserTweets、Followers、Following、UserMedia 等）都需要的规范数字用户 ID。
可直接在 input.variables 对象中切换 withSafetyModeUserFields 和 withHighlightedLabel，以控制响应中出现哪些扩展资料字段（安全模式元数据、高亮创作者标签）。
每个请求都会经过一致的 waiting → queuing → generating → success / fail 状态机，并可通过 /api/v1/jobs/recordInfo 查询；createTime、completeTime、costTime 和 resultJson 会以可预测的 schema 返回。
将任意 @handle 转换为下游流程所需的稳定数字 rest_id。
拉取粉丝数、认证徽章、简介关键词、账号年龄和高亮标签，以便大规模评估和排序账号资料。
在批准注册、抽奖或 KOL 合作前，自动验证提交的 Twitter handles 是否存在、是否活跃、是否未受保护，并是否匹配预期元数据。
为任何包含 Twitter handle 的联系人记录，在毫秒级补充头像、位置、网站 URL、粉丝数和创建日期。
虽然 X 官方 API 将用户查询置于开发者审批、阶梯定价和稀疏默认字段之后，ApiPass 则通过一次简单、自动路由、按任务付费的调用交付完整的 GraphQL 资料对象。
官方 GET /2/users/by/username/:username 端点要求你通过 query params 手动扩展字段，且默认只返回 id、name 和 username——额外字段需要 fields 和 expansions 参数。ApiPass 的 GraphQL 封装会在一次调用中返回完整的原生用户对象（包括置顶推文、专业账号信息、认证类型和高亮标签），无需 fields= 枚举。
X 已将访问方式整合为基于使用量的模式：创建一条帖子约需 0.010，读取一条帖子约需 0.005，用户资料查询和 DM 读取每次约需 $0.010，并叠加月度额度限制。ApiPass 仅按成功任务收费，默认将你路由到成本最低且稳定的提供商，并且不需要开发者门户申请步骤。
将推文流中提到的每个 handle 解析为完整资料，方便分析师按粉丝规模、认证状态或账号年龄进行筛选。
在发放 tokens、NFTs 或 whitelist spots 之前，确认与钱包关联的 Twitter handle 真实、账号足够久，并满足粉丝数门槛。
快速拉取任何公开账号的权威元数据（创建日期、位置、资料历史信号、高亮标签），用于调查分析。
用简介、网站 URL 和粉丝数丰富候选人的 Twitter handles，以发现适合触达的开发者布道者、设计师和创作者。
在 ApiPass 注册，并从仪表板获取 YOUR_API_KEY。无需开发者门户申请、无需 OAuth 设置，也无需应用审核——一个 bearer token 即可解锁平台上的所有模型。
向 https://api.apipass.dev/api/v1/jobs/createTask 发送 POST 请求，将 model 设置为 twitter/graphql/user-by-screen-name，并在 input.variables.screen_name 中提供目标 handle（例如 elonmusk）。你也可以选择包含 withSafetyModeUserFields 和 withHighlightedLabel 来丰富响应，并在希望 ApiPass 自动将结果推送到你的服务器时传入 callBackUrl。API 会立即返回一个 taskId，例如 task_12345678。
你可以等待 ApiPass 将完成的 payload POST 到你的 callBackUrl，或使用 bearer token 轮询 https://api.apipass.dev/api/v1/jobs/recordInfo?taskId=task_12345678。当 data.state 变为 success 后，完整的用户资料——包括 rest_id、简介、粉丝和关注数、认证状态、头像、创建日期以及任何已请求的可选字段——都会出现在 data.resultJson.resultObject 中。就这样：你现在已经可以在生产环境中拉取 Twitter GraphQL 用户数据。
所有 API 都需要通过 Bearer Token 进行身份验证。
Authorization: Bearer
通过 screen_name 获取用户信息
该 API 接受具有以下结构的 JSON 载荷：
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "screen_name": "string",
8 "withSafetyModeUserFields": "boolean",
9 "withHighlightedLabel": "boolean",
10 }
11 }
12}model必填string用于生成的模型名称
"twitter/graphql/user-by-screen-name"
callBackUrl可选string任务完成通知的回调 URL。如果省略，则不会发送回调。
"https://your-domain.com/api/callback"
channel可选string你可以通过 channel 参数指定 APIPASS 中对应的提供商；这些提供商会处理实际的图像和视频生成任务。APIPASS 目前提供三种提供商选项：
channel 参数的默认值为 auto。启用后，APIPASS 会根据实时价格和稳定性指标，在可用提供商之间自动分配任务，以平衡最低成本和可靠性能。除非你有自定义路由需求，否则请保留默认值 auto。
可用选项：
auto
input 对象包含以下参数：
input.variables.screen_name必填stringelonmusk
input.variables.withSafetyModeUserFields可选booleantrue
input.variables.withHighlightedLabel可选booleantrue
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 "screen_name": "elonmusk",
10 "withSafetyModeUserFields": true,
11 "withHighlightedLabel": true
12 }
13 }
14 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}code状态码，200 表示成功，其他表示失败
message响应消息，失败时为错误描述
data.taskId用于查询任务状态和结果的任务 ID
