问答
X 的用户 ID 和 @用户名,数据库里该存哪个?
简短回答
用数字用户 ID 做主键,@用户名只当显示用的标签。用户名唯一但可以改,ID 不会变。okdata 的 X 账号信息接口按用户名查账号,返回里带着 ID,每次 $0.0004;所以两个都要存,每次刷新时核对 ID 有没有变。
每个 X 账号都有两个标识。用户 ID 是 2244994945 这样的数字,由 X 分配一次,之后永远不变。用户名就是主页地址里的 @名字,大家输入、转发的都是它,账号主人随时可以改。X 自己的数据字典对用户名的描述就是“唯一,但可能变化”。按用户名建的监控表,哪天品牌一改名,就悄无声息地断了。
两者的区别
| 用户 ID | 用户名(username) | |
|---|---|---|
| 例子 | 2244994945,新账号是 19 位 |
@TwitterDev |
| 会不会变 | 永远不变 | 账号主人改名就变 |
| 是否唯一 | 唯一 | 同一时刻唯一 |
| 长度 | 老账号很短,新账号是 64 位的 Snowflake ID | 一般不超过 15 个字符 |
新账号的用户 ID 是 Snowflake ID,所以也大致记录了注册时间,见怎么从推文 ID 算出发布时间。
该怎么存
每个账号一行:user_id 做主键,再存 username、name,以及最后一次看到这个用户名的日期。用户名当成需要定期刷新的显示值,不要拿它去关联帖子、粉丝或投放记录。
okdata 这边怎么处理
X 账号信息和 X 账号帖子列表都传 username,带不带 @ 都行,返回 id(用户 ID)和 username(当前用户名)。X 帖子详情和搜索返回的每条帖子里,也都有 author.id 和 author.username。接口目录里没有按数字用户 ID 查账号的接口,这正是两个都要存的原因。
用户名失效时会出现两种情况。一种是返回 not_found,这次调用照常计费。另一种是旧用户名已经被别的账号占用,你拿到的是另一个人的主页,id 对不上。不管哪种,都去读一条你之前存下的、这个账号发过的帖子:帖子 ID 不会变,返回里的 author.username 就是现在的用户名。
| 要做的事 | 调用次数 | 费用 |
|---|---|---|
| 一个用户名换成 ID | 1 | $0.0004 |
| 刷新 300 个跟踪账号 | 300 | $0.12 |
| 通过一条已知帖子修复改名账号 | 1 | $0.0003 |
示例
import os, requests
API = "https://api.okdata.online"
H = {"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"}
def get(path, **params):
return requests.get(API + path, headers=H, params=params, timeout=60).json()
def refresh(row):
"""row = {"user_id": "...", "username": "...", "known_post_id": "..."}"""
body = get("/v1/x/users/get", username=row["username"], fields="id,username,followers")
if body["code"] == "ok" and body["data"]["item"]["id"] == row["user_id"]:
return {**row, "followers": body["data"]["item"]["followers"]}
post = get("/v1/x/posts/get", id=row["known_post_id"], fields="author.id,author.username")
if post["code"] == "ok" and post["data"]["item"]["author"]["id"] == row["user_id"]:
return {**row, "username": post["data"]["item"]["author"]["username"], "renamed": True}
return {**row, "status": "需要人工核对"}
限制
- 被封禁或已注销的账号,两条路都返回
not_found,没办法读到它现在的状态。 - ID 按字符串存。新账号的用户 ID 超出了 JavaScript 普通数字能精确表示的范围。
- 显示名称(
name)改得比用户名还勤,而且不唯一,千万别用它来匹配账号。
想批量查一批账号的粉丝数,见不用官方 API 怎么拿 Twitter 账号的粉丝数。
资料来源
这个问题出现过的地方(读取于 2026-11-12)
更新于