Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
还没有输出。提交表单以生成内容。
透明定价，无隐藏费用。按需支付。
| 规则与模式 | 渠道 | 积分 | 价格（美元） | 官方/参考价格 | 每日节省 |
|---|---|---|---|---|---|
user-by-rest-id otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 使用完整指南
通过 ApiPass 统一的 GraphQL 端点，使用数字用户 ID 即时获取完整的 Twitter 用户资料数据。
ApiPass 上的 Twitter Graphql User By Rest ID API 是一个强大的端点，开发者只需提交数字 userId（也称为 rest_id），即可获取全面的 Twitter 用户信息。与基于用户名的查询不同，此端点使用稳定的数字标识符直接查询 Twitter 的 GraphQL 后端；即使用户更新了自己的 handle，该标识符也不会改变。通过向 /api/v1/jobs/createTask 发起一个简单的 POST 请求，并将 model 设置为 twitter/graphql/user-by-rest-id，你会收到一个 task ID，随后可通过 /api/v1/jobs/recordInfo 端点获取完整的资料详情——包括显示名称、screen name、头像、横幅、粉丝/关注数量、认证状态、专业账号信息、高亮标签等。ApiPass 会自动处理身份验证、路由和服务商选择，让你专注于构建产品，而无需应对 Twitter 复杂的内部 API。
使用用户永久不变的 rest_id（例如 Elon Musk 的 44196397）而不是可变的 screen name 来查询用户，确保当用户更改 handle 时，你的集成不会失效。
使用单个 Bearer YOUR_API_KEY header 替代 Twitter 复杂的 OAuth 2.0 流程，大幅降低新项目的接入门槛。
默认的 auto 通道会基于实时价格和稳定性指标，在 starter、regular 和 official 服务商之间智能分配请求，在无需手动配置的情况下平衡成本与可靠性。
create-task 与 query-task 模式配合可选的 callBackUrl，让你能够构建可扩展、非阻塞的流水线，即使在高负载下也不易超时。
单次调用即可获取 40 多个用户字段，包括 is_blue_verified、professional 数据、highlights_info、affiliates_highlighted_label、relationship_perspectives 等，无需额外端点。
按量付费定价，official 通道价格与 Twitter 官方费率对齐，同时为高容量、低关键性工作负载提供成本更低的层级。
返回完整的 GraphQL user.result 结构，包括 core（name、screen_name、created_at）、头像、legacy（followers、friends、statuses、listed counts）、verification、professional、dm_permissions、highlights_info 和 tipjar_settings。
通过 withHighlightedLabel boolean 控制是否包含 affiliates_highlighted_label 区块，便于展示品牌关联和已认证企业徽章。
每个任务都会经历清晰的生命周期状态（waiting、queuing、generating、success、fail），并在每次响应中包含 createTime、completeTime 和 costTime 指标。
持续监控数千名创作者的粉丝增长、互动信号和认证状态，并通过稳定的 rest_id 进行跟踪。
使用已验证的 Twitter 资料数据增强客户记录——显示名称、简介链接、专业类别和企业标签——为 B2B 外联流程提供支持。
验证账号年龄（created_at）、粉丝与关注比例以及蓝标认证状态，用于识别机器人、诈骗或冒充行为。
构建竞品追踪产品，定期快照竞争对手账号的指标，比较其增长轨迹和内容表现信号。
虽然 Twitter 官方 API 提供对用户查询端点的直接访问，但大规模集成会带来显著开销——从 OAuth 的复杂性、分级定价限制，到字段暴露受限。ApiPass 将相同的底层 GraphQL 基础设施封装为开发者友好的接口，提供更智能的路由、更丰富的载荷和更灵活的成本层级。
Twitter 官方 API v2 GET /2/users/:id 端点需要 OAuth 2.0 Bearer token、应用注册、项目设置以及分级访问审批。ApiPass 用单个 API key 替代了所有这些流程——注册、生成密钥，几分钟内即可开始调用。无需开发者门户审核，也无需协商应用级速率限制。
Twitter 官方端点会根据访问层级暴露有限字段，高容量层级通常受昂贵的月度订阅限制。ApiPass 提供更丰富的 GraphQL 响应（包括 highlights_info、affiliates_highlighted_label、professional 和 relationship_perspectives），并允许你在 starter、regular 和 official 通道之间选择——只有在稳定性至关重要时才支付 official 费率，而在低层级进行批量查询时最高可节省 90% 成本。
在授予空投资格或 NFT 白名单访问权限之前，通过 rest_id 确认与钱包关联的 Twitter 账号，避免伪造的 screen name 替换。
记者和 OSINT 分析师可以将归档的数字 ID 解析为当前账号状态，跟踪公众人物的资料、简介和认证状态随时间的变化。
将从广告点击或推荐链接中收集的用户 ID 解析为完整的资料快照，并按粉丝层级或专业类别将营销活动表现归因到具体受众细分。
当用户使用自己的 Twitter ID 联系客服时，可即时拉取其资料以确认身份、检查 is_blue_verified 状态，并为高价值账号定制回复。
在 ApiPass 注册，进入仪表盘并生成一个 Bearer API key。无需应用审核流程、无需 OAuth 设置，也无需等待期——注册后几分钟内即可开始调用。
向 createTask 端点发送 POST 请求，将 model 设置为 twitter/graphql/user-by-rest-id，并在 input.variables 对象中放入目标数字用户 ID。你也可以选择切换 withHighlightedLabel 标志以包含关联徽章数据，并在希望任务完成后由 ApiPass 自动将结果推送到你的服务器时提供 callBackUrl。响应将返回一个唯一的 taskId，你将使用它来获取结果。
向 recordInfo 端点发送 GET 请求，并将你的 taskId 作为查询参数。轮询该端点（或等待回调），直到 state 字段返回 success。此时，完整的 Twitter 用户资料——包括核心身份信息、头像、粉丝指标、认证状态、专业账号详情和高亮标签——将位于嵌套的 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
