给 AI

问答

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 账号的粉丝数。

资料来源

  1. X API 数据字典:用户 id 与 usernamedocs.x.com · 读取于
  2. X API 文档:X IDsdocs.x.com · 读取于

这个问题出现过的地方(读取于 2026-11-12)

更新于

接上一次,以后直接问 AI。

新 key 自带 $0.10 试用额度。贴一句话,就能接进你的智能体。

免费开始
一句话接进你的 AI

把这句话发给你的智能体

读一下 https://okdata.online/zh/agents.md,帮我把 okdata 配好;我的 key 在环境变量 OKDATA_API_KEY 里。

Claude Code、Cursor、Codex 等能打开网址的智能体,读完会自己配好。

MCP 地址https://api.okdata.online/mcp