Skip to main content

比较 X API 的用户查询端点

v2 用户查询端点将取代标准 v1.1 的 GET users/lookupGET users/show 端点。如果你有使用上述任一用户查询端点版本的代码、应用或工具,并正考虑迁移到更新的 X API v2 端点,那么这组指南适合你。    下表对比了不同类型的用户查询端点:  
说明标准 v1.1X API v2
支持的 HTTP 方法GETGET
主机域名https://api.x.comhttps://api.x.com
端点路径/1.1/users/show.json /1.1/users/lookup.json/2/users

/2/users/:id

/2/users/by

/2/users/by/:username
认证OAuth 1.0a 用户上下文OAuth 1.0a 用户上下文

仅应用

OAuth 2.0 授权码(PKCE)
默认请求速率限制每 15 分钟 900 次请求(每用户)

/show - 每 15 分钟 900 次请求(每应用)
/lookup - 每 15 分钟 300 次请求(每应用)
每 15 分钟 900 次请求(每用户)

每 15 分钟 300 次请求(每应用)
每个响应的最大用户数/show - 1

/lookup - 100
100
JSON 响应对象格式标准 v1.1 格式X API v2 格式(由 fields 和 expansions 请求参数决定,且与 v1.1 格式不向后兼容)

要了解如何从标准 v1.1 格式迁移到 X API v2 格式,请参阅我们的数据格式迁移指南
支持在有效负载中选择返回哪些fields
支持 annotations 字段(用于置顶 Post)
支持请求新的metrics 字段(用于置顶 Post)
支持 conversation_id 字段(用于置顶 Post)
需要使用与项目关联的开发者应用的凭据
其他迁移资源 用户查询:标准 v1.1 到 X API v2 X API 迁移中心 查看这些端点的示例代码