问答
小红书笔记 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。
还有一个特性:前 8 位按十六进制读,是一个 Unix 时间戳。我们核对过的笔记里,它都和发布时间对得上(66f3c1a8 是 2024 年 9 月下旬)。小红书没有公开说明这一点,所以报表里用 published_at,这个技巧只用来快速排个序。
接口怎么收、怎么返回
小红书笔记详情可以传 id=66f3c1a8000000002c03e5b7,也可以用 url= 传 /explore/、/discovery/item/ 或 xhslink.com 链接。/user/profile/<用户>/<笔记> 这种链接,把最后一段作为 id 传。不需要令牌。返回 id、规范链接 url(/explore/<id>)、type(image 或 video)、标题、正文、图片、点赞、收藏、评论、分享和话题;加 view=full 时,ext.xsec_token 里是小红书附带的令牌(有的话)。笔记搜索的每条结果也带同样的 id。
| 任务 | 调用次数 | 费用 |
|---|---|---|
| 一个 ID 或链接换完整笔记 | 1 | $0.02 |
| 上个月投放的 250 个笔记 ID | 250 | $5.00 |
| 一页搜索结果,带笔记 ID 和数据 | 1 | $0.02 |
示例
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,小红书不公开浏览量。- 一次调用一篇笔记,没有批量详情接口。整段分享文案怎么处理,见小红书分享链接转笔记数据。
资料来源
- XHS-Downloader README: supported link formats (/explore/, /discovery/item/, /user/profile/…/…, xhslink.com)
- Knowing the note ID, how to get xsec_token? (XHS-Downloader issue #397)
这个问题出现过的地方(读取于 2026-11-12)
更新于