# 小红书笔记 ID 是什么，在链接里哪一段？

> 小红书笔记 ID 是 24 位十六进制字符，在笔记链接 /explore/ 或 /discovery/item/ 后面。怎么认出它、常和什么搞混，以及接口怎么用它。

网页版：https://okdata.online/zh/answers/xiaohongshu-note-id/

**简短回答：**就是笔记链接里 /explore/ 或 /discovery/item/ 后面、?xsec_token 前面那串 24 位十六进制字符。okdata 的小红书笔记详情可以直接传这个 ID 或整条链接，每次 $0.02，返回的笔记 id 就是它；笔记搜索每次 $0.02，一页约 20 篇，都带 ID。

每篇小红书笔记都有一个正好 24 位的 ID，只由数字和 a 到 f 的字母组成，比如 `66f3c1a8000000002c03e5b7`。它是笔记链接里唯一不变的部分：问号后面的 `xsec_token` 每次访问都重新发放、会过期，xhslink.com 短链里的分享码要跳转后才有意义，而这 24 位只要笔记还在就一直不变。所以表格和数据库里应该存它；大家贴来的链接五花八门时，要提取的也是它。

## 在各种链接里的位置

| 链接 | 笔记 ID 是 |
|---|---|
| `xiaohongshu.com/explore/66f3c1a8000000002c03e5b7?xsec_token=AB…` | `/explore/` 后面那段 |
| `xiaohongshu.com/discovery/item/66f3c1a8000000002c03e5b7` | `/discovery/item/` 后面那段 |
| `xiaohongshu.com/user/profile/5f2b7c1e0000000001006a3d/66f3c1a8000000002c03e5b7` | 最后一段；前一段是作者的用户 ID |
| `xhslink.com/a/Hk3pQx2Lm9` | 看不到，短链要先跳转 |

前三种可以用这个正则：`/(?:explore|discovery/item|user/profile/[0-9a-f]{24})/([0-9a-f]{24})`。

## 容易和什么搞混

- **用户 ID** 也是 24 位十六进制。`/user/profile/` 链接里第一段 24 位是账号，不是笔记。
- **评论 ID** 长得也一样。表格里每一列都标清楚。
- **xsec_token** 是一长串令牌，不属于 ID，见[要不要 xsec_token](/zh/answers/xiaohongshu-xsec-token/)。

还有一个特性：前 8 位按十六进制读，是一个 Unix 时间戳。我们核对过的笔记里，它都和发布时间对得上（`66f3c1a8` 是 2024 年 9 月下旬）。小红书没有公开说明这一点，所以报表里用 `published_at`，这个技巧只用来快速排个序。

## 接口怎么收、怎么返回

[小红书笔记详情](/zh/apis/xiaohongshu/notes/get/)可以传 `id=66f3c1a8000000002c03e5b7`，也可以用 `url=` 传 `/explore/`、`/discovery/item/` 或 xhslink.com 链接。`/user/profile/<用户>/<笔记>` 这种链接，把最后一段作为 `id` 传。不需要令牌。返回 `id`、规范链接 `url`（`/explore/<id>`）、`type`（`image` 或 `video`）、标题、正文、图片、点赞、收藏、评论、分享和话题；加 `view=full` 时，`ext.xsec_token` 里是小红书附带的令牌（有的话）。[笔记搜索](/zh/apis/xiaohongshu/notes/search/)的每条结果也带同样的 `id`。

| 任务 | 调用次数 | 费用 |
|---|---|---|
| 一个 ID 或链接换完整笔记 | 1 | $0.02 |
| 上个月投放的 250 个笔记 ID | 250 | $5.00 |
| 一页搜索结果，带笔记 ID 和数据 | 1 | $0.02 |

## 示例

```python
import os, re, requests

links = ["https://www.xiaohongshu.com/discovery/item/66f3c1a8000000002c03e5b7?source=webshare"]
pattern = re.compile(r"/(?:explore|discovery/item|user/profile/[0-9a-f]{24})/([0-9a-f]{24})")
for link in links:
    note_id = pattern.search(link).group(1)
    r = requests.get("https://api.okdata.online/v1/xiaohongshu/notes/get",
                     headers={"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"},
                     params={"id": note_id, "fields": "id,type,title,published_at,metrics.likes"},
                     timeout=60)
    print(r.json()["data"]["item"])
```

## 限制

- 已删除或私密的笔记返回 `not_found`，这次调用照常计费。
- `metrics.views` 为 null，小红书不公开浏览量。
- 一次调用一篇笔记，没有批量详情接口。整段分享文案怎么处理，见[小红书分享链接转笔记数据](/zh/answers/xiaohongshu-note-from-share-link/)。

## 用到的接口

- [小红书笔记详情](https://okdata.online/zh/apis/xiaohongshu/notes/get/) `xiaohongshu.notes.get`：$0.02/次
- [小红书笔记搜索](https://okdata.online/zh/apis/xiaohongshu/notes/search/) `xiaohongshu.notes.search`：$0.02/次 · 每页约 20 篇笔记

## 更多小红书内容

- [小红书 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/)
- [人在海外，怎么让 AI 读到国内版小红书的数据？](https://okdata.online/zh/answers/xiaohongshu-data-for-agents-outside-china/)
- [怎么搭一个小红书爆款笔记库，用来找选题、拆爆文？](https://okdata.online/zh/answers/xiaohongshu-viral-notes-library/)
- [千问里怎么拿到抖音、小红书、公众号的数据？](https://okdata.online/zh/answers/qwen-douyin-xiaohongshu-data/)
- [腾讯元宝能读抖音、小红书的数据吗？](https://okdata.online/zh/answers/yuanbao-douyin-xiaohongshu-data/)
- [小红书返回 300011 账号异常，怎么继续采集笔记？](https://okdata.online/zh/answers/xiaohongshu-300011-account-abnormal/)
- [小红书爬虫返回 461 是什么原因？还能怎么拿到数据？](https://okdata.online/zh/answers/xiaohongshu-461-status-code/)
- [自己爬还是按次调用数据接口：成本、维护和风险](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/)

## 资料来源

- [XHS-Downloader README: supported link formats (/explore/, /discovery/item/, /user/profile/…/…, xhslink.com)](https://github.com/JoeanAmier/XHS-Downloader) (读取于 2026-11-12)
- [Knowing the note ID, how to get xsec_token? (XHS-Downloader issue #397)](https://github.com/JoeanAmier/XHS-Downloader/issues/397) (读取于 2026-11-12)

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

- https://github.com/JoeanAmier/XHS-Downloader/issues/397
- https://github.com/ReaJason/xhs/issues/107

更新于 2026-11-12
