# 小红书用户 ID 和小红书号有什么区别，接口要哪个？

> 主页上的小红书号是给人看、可以修改的号；用户 ID 是主页链接里固定不变的 24 位十六进制字符。接口要哪个，以及怎么从一个换到另一个。

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

**简短回答：**接口要的是用户 ID：主页链接里 /user/profile/ 后面那串 24 位十六进制字符，永远不变。主页上显示的小红书号是对外的号，不能拿来查询。okdata 的小红书博主信息接受用户 ID、主页链接或 xhslink.com 分享链接，每次 $0.02，两个都返回，小红书号在 username 里。

小红书主页上有两个标识，能当查询键的只有一个。昵称下面写着“小红书号”，后面是一串数字，比如 `95210384417`，博主自己设置过的话也可能是自定义的字符。这是账号对外的号，大家互相推荐时报的就是它，而且本人可以修改。用户 ID 不一样：24 位数字加 a 到 f 的字母，比如 `5f2b7c1e0000000001006a3d`，只出现在网页链接 `xiaohongshu.com/user/profile/5f2b7c1e0000000001006a3d` 里。它在注册时生成，之后不再变，所以小红书自己的网页接口、各种爬虫和数据工具要的都是它。投放方案里列的如果全是小红书号，得先换成用户 ID 才能拉数据。

## 对比

| | 用户 ID | 小红书号 |
|---|---|---|
| 长什么样 | `5f2b7c1e0000000001006a3d`（24 位十六进制） | `95210384417` 或自定义字符 |
| 在哪里看到 | 主页网页链接 `/user/profile/` 后面 | 主页昵称下方 |
| 会不会变 | 不会 | 会，本人可以修改 |
| 在 okdata 数据里 | 账号的 `id`，笔记的 `author.id` | 账号的 `username` |
| 能不能拿来查询 | 能 | 不能 |

昵称是第三样东西：随便写、可以重名、也能改。表格千万别用昵称做主键。

## 怎么拿到用户 ID

1. **从主页链接或分享链接拿。**用 `url=` 传主页网页链接，或 App 里分享按钮复制出来的 xhslink.com 链接，调[小红书博主信息](/zh/apis/xiaohongshu/users/get/)。返回的 `id` 是用户 ID，`username` 是小红书号。
2. **从他的笔记拿。**[笔记详情](/zh/apis/xiaohongshu/notes/get/)返回的 `author.id` 就是作者的用户 ID。
3. **手上只有小红书号。**这里没有按小红书号查询的接口。在 App 里搜这个号，打开主页，点分享复制链接，再走第 1 步。

有了用户 ID，[博主笔记列表](/zh/apis/xiaohongshu/users/notes/list/)可以从新到旧列出他发过的笔记。小红书官方达人广场蒲公英里的达人 ID，也就是这个 24 位用户 ID。

| 步骤 | 调用次数 | 费用 |
|---|---|---|
| 分享链接换用户 ID、小红书号和账号数据 | 1 | $0.02 |
| 再取最新 20 篇笔记 | 1 | $0.02 |
| 投放方案里的 40 个博主，两步都做 | 80 | $1.60 |

## 示例

```bash
curl -G "https://api.okdata.online/v1/xiaohongshu/users/get" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'url=https://xhslink.com/m/8Tq2LwRk5Zp' \
  --data-urlencode 'fields=id,username,name,followers,posts'
```

存 `id`。`username` 放在旁边方便人看，隔一段时间刷新一下，因为它会变。

## 限制

- 博主笔记列表只返回笔记，不带作者的昵称和小红书号，这些从博主信息接口取。
- 被封或已注销的账号返回 `not_found`，这次调用照常计费。
- 主页上的“获赞与收藏”到底算的是什么，见[小红书获赞与收藏](/zh/answers/xiaohongshu-likes-and-collects/)；批量查一批博主的粉丝和笔记数，见[小红书博主粉丝数](/zh/answers/xiaohongshu-creator-profile-followers/)。

## 用到的接口

- [小红书博主信息](https://okdata.online/zh/apis/xiaohongshu/users/get/) `xiaohongshu.users.get`：$0.02/次
- [小红书博主笔记列表](https://okdata.online/zh/apis/xiaohongshu/users/notes/list/) `xiaohongshu.users.notes.list`：$0.02/次 · 每页约 20 篇笔记
- [小红书笔记详情](https://okdata.online/zh/apis/xiaohongshu/notes/get/) `xiaohongshu.notes.get`：$0.02/次

## 更多小红书内容

- [小红书 API](https://okdata.online/zh/apis/xiaohongshu/)
- [小红书 API Python 教程：笔记、博主和评论（2026）](https://okdata.online/zh/guides/xiaohongshu-api-python/)
- [怎么按关键词批量导出小红书评论](https://okdata.online/zh/guides/xiaohongshu-note-comments/)
- [怎么在小红书蒲公英按报价和阅读量筛达人](https://okdata.online/zh/guides/xiaohongshu-pgy-creator-rates/)
- [怎么搜索小红书笔记并导出成 CSV 表格](https://okdata.online/zh/guides/xiaohongshu-search-export-notes/)
- [怎么导出一个小红书博主主页的全部笔记？](https://okdata.online/zh/answers/xiaohongshu-export-creator-notes/)
- [小红书分享链接（xhslink.com）怎么解析成笔记数据？](https://okdata.online/zh/answers/xiaohongshu-note-from-share-link/)
- [怎么用 AI 每天自动生成竞品在小红书、抖音的发布日报？](https://okdata.online/zh/answers/ai-competitor-daily-report/)
- [小红书返回 300011 账号异常，怎么继续采集笔记？](https://okdata.online/zh/answers/xiaohongshu-300011-account-abnormal/)
- [怎么用 API 查小红书博主的粉丝数、获赞与收藏和笔记数？](https://okdata.online/zh/answers/xiaohongshu-creator-profile-followers/)
- [自己爬还是按次调用数据接口：成本、维护和风险](https://okdata.online/zh/compare/scraping-vs-data-api/)
- [怎么选社交媒体数据 API（2026）](https://okdata.online/zh/compare/social-media-data-apis/)
- [社媒数据 MCP 服务器：自己部署还是用托管的](https://okdata.online/zh/compare/social-media-data-mcp-servers/)
- [小红书数据接口有哪些？官方开放平台、第三方 API、开源爬虫 4 类方案怎么选（2026）](https://okdata.online/zh/compare/xiaohongshu-data-apis/)

## 资料来源

- [XHS-Downloader README: profile and note link formats (/user/profile/作者ID/作品ID)](https://github.com/JoeanAmier/XHS-Downloader) (读取于 2026-11-12)

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

- https://github.com/xpzouying/xiaohongshu-mcp/pull/729

更新于 2026-11-12
