# X 的用户 ID 和 @用户名，数据库里该存哪个？

> X 的用户 ID 永远不变，@用户名可以改。为什么要用数字 ID 做主键、用户名只当标签，以及怎样发现并修复改了名的账号。

网页版：https://okdata.online/zh/answers/x-user-id-vs-handle/

**简短回答：**用数字用户 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 算出发布时间](/zh/answers/x-tweet-id-timestamp/)。

## 该怎么存

每个账号一行：`user_id` 做主键，再存 `username`、`name`，以及最后一次看到这个用户名的日期。用户名当成需要定期刷新的显示值，不要拿它去关联帖子、粉丝或投放记录。

## okdata 这边怎么处理

[X 账号信息](/zh/apis/x/users/get/)和 [X 账号帖子列表](/zh/apis/x/users/posts/list/)都传 `username`，带不带 @ 都行，返回 `id`（用户 ID）和 `username`（当前用户名）。[X 帖子详情](/zh/apis/x/posts/get/)和搜索返回的每条帖子里，也都有 `author.id` 和 `author.username`。接口目录里没有按数字用户 ID 查账号的接口，这正是两个都要存的原因。

用户名失效时会出现两种情况。一种是返回 `not_found`，这次调用照常计费。另一种是旧用户名已经被别的账号占用，你拿到的是另一个人的主页，`id` 对不上。不管哪种，都去读一条你之前存下的、这个账号发过的帖子：帖子 ID 不会变，返回里的 `author.username` 就是现在的用户名。

| 要做的事 | 调用次数 | 费用 |
|---|---|---|
| 一个用户名换成 ID | 1 | $0.0004 |
| 刷新 300 个跟踪账号 | 300 | $0.12 |
| 通过一条已知帖子修复改名账号 | 1 | $0.0003 |

## 示例

```python
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 账号的粉丝数](/zh/answers/x-follower-count-api/)。

## 用到的接口

- [X 账号信息](https://okdata.online/zh/apis/x/users/get/) `x.users.get`：$0.0004/条 · 每次最多 $0.04
- [X 账号帖子列表](https://okdata.online/zh/apis/x/users/posts/list/) `x.users.posts.list`：$0.002/次 · 每页约 20 条帖子
- [X 帖子详情](https://okdata.online/zh/apis/x/posts/get/) `x.posts.get`：$0.0003/次

## 更多X（推特）内容

- [X（推特） API](https://okdata.online/zh/apis/x/)
- [怎么按关键词搜 X（推特）帖子并导出](https://okdata.online/zh/guides/x-search-posts-by-keyword/)
- [怎么每天记录多个国家的 X（推特）趋势](https://okdata.online/zh/guides/x-trends-by-country/)
- [twscrape 报 No active accounts、账号一直被锁，还有别的办法吗？](https://okdata.online/zh/answers/twscrape-no-active-accounts/)
- [按千次播放给剪辑手结算，怎么统计 TikTok、YouTube Shorts、Instagram Reels 和 X 上每条切片的播放量？](https://okdata.online/zh/answers/clipper-payout-view-tracking/)
- [Claude 或 AI 智能体怎么读取 x.com 推文链接的内容？](https://okdata.online/zh/answers/ai-agent-read-tweet-from-link/)
- [怎么拿到一个推特账号发过的所有推文？](https://okdata.online/zh/answers/get-all-tweets-from-account/)
- [snscrape 抓推特一直报 blocked (404)，有能用的替代吗？](https://okdata.online/zh/answers/snscrape-twitter-blocked-404/)
- [平台官方 API 和第三方数据接口怎么选（2026）](https://okdata.online/zh/compare/official-apis-vs-data-apis/)
- [怎么选社交媒体数据 API（2026）](https://okdata.online/zh/compare/social-media-data-apis/)
- [账号信息接口](https://okdata.online/zh/roles/accounts-get/)
- [账号作品列表接口](https://okdata.online/zh/roles/accounts-posts-list/)
- [内容详情接口](https://okdata.online/zh/roles/posts-get/)
- [X 趋势：今日榜单](https://okdata.online/zh/tools/hot-search/x/)

## 资料来源

- [X API 数据字典：用户 id 与 username](https://docs.x.com/x-api/fundamentals/data-dictionary) (读取于 2026-11-12)
- [X API 文档：X IDs](https://docs.x.com/fundamentals/x-ids) (读取于 2026-11-12)

这个问题出现过的地方（读取于 2026-11-12）：

- https://devcommunity.x.com/t/durability-of-user-ids-and-detecting-username-changes/171310
- https://stackoverflow.com/questions/9165016
- https://stackoverflow.com/questions/11621677

更新于 2026-11-12
