给 AI

问答

小红书笔记 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,小红书不公开浏览量。
  • 一次调用一篇笔记,没有批量详情接口。整段分享文案怎么处理,见小红书分享链接转笔记数据。

资料来源

  1. XHS-Downloader README: supported link formats (/explore/, /discovery/item/, /user/profile/…/…, xhslink.com)github.com · 读取于
  2. Knowing the note ID, how to get xsec_token? (XHS-Downloader issue #397)github.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