rednote/
note-detail

通过带有效 token 的 xiaohongshu.com 或 xhslink.com URL 获取一条公开 Rednote 笔记,返回标准化正文、作者、媒体、时间和可见互动数据。

Rednote Note Detail API

带 token 的笔记 URL
单条笔记详情
标准化帖子记录
每次请求 1 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

Rednote Note Detail

Rednote 笔记是将正文和媒体与作者身份、话题引用、发布时间及可见互动联系起来的公开内容对象。这些字段适合补全已知链接、审核选定内容,并比较不同观察时点的笔记表现。

Rednote Note Detail API 主要特性

  • 带 token 的笔记查询仅在已接受主机名、笔记详情路径和非空 xsec_token 共同构成完整来源标识时,解析一个已知公开笔记 URL。
  • 笔记与作者信息返回标准化笔记标识、来源 URL、正文、时间,以及可获得的作者 ID、username、显示名称、主页、头像和账号标记。
  • 媒体与互动快照保留可获得的媒体地址、预览图、尺寸、时长、话题引用,以及点赞、评论、分享和观看数量,并标明采集时间。

Rednote Note Detail API 参数

参数必填描述
url必填必填的非空 URL,主机名必须为 xiaohongshu.com、xhslink.com 或其子域;路径必须包含 /explore/{note_id} 或 /discovery/item/{note_id},查询参数必须含非空 xsec_token。

如何使用 Rednote Note Detail API

提供当前可用且带 token 的笔记 URL,提交异步请求,并在完成后读取单条标准化帖子记录。

  1. 复制当前公开笔记 URL,确认主机名、笔记详情路径和查询字符串中的非空 xsec_token 均符合要求。
  2. 将 url POST 到 /v1/rednote/note-detail,并保存提交响应中的 data.task_id。
  3. 轮询 /v1/tasks/{task_id},直到任务成功或报告失败。
  4. 成功后读取 data.results.items。来源只执行一次详情查询;next_cursor 只对 SocQ 已存储记录分页。
REDNOTE_NOTE_URL=''
# 在引号内粘贴当前带 xsec_token 的公开笔记 URL

curl -X POST "https://api.socq.ai/v1/rednote/note-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"url\":\"$REDNOTE_NOTE_URL\"}"

# 轮询 GET /v1/tasks/{task_id}
# 从 data.results.items 读取标准化帖子

Rednote Note Detail API 最佳使用场景

  • 补全已知笔记目录: 将符合要求的笔记 URL 转换为标准化身份、正文、作者、发布时间和来源字段,补充已有内容索引。
  • 审核选定笔记内容: 结合正文、作者信息、媒体引用和话题字段,检查一组范围明确的单条公开笔记。
  • 比较互动观察值: 在多次独立查询中,将可见的点赞、评论、分享和观看数量与 collected_at 配对,进行分时点比较。

Rednote Note Detail API 使用建议

  • 使用完整笔记 URL,并保留主机名、/explore/ 或 /discovery/item/ 路径以及 xsec_token 查询参数;裸 note ID 无法通过校验。
  • 将 xsec_token 保留在 URL 查询字符串中,因为请求只接受 url,单独提交 token 字段会被拒绝。
  • 复用其它 SocQ Rednote 笔记结果中的 URL 时,先确认 xsec_token 仍然存在;Note Detail 无法重建缺失的 token。
  • 每个任务只提交一个 URL;这个详情接口不提供批量字段、results_limit 或来源 cursor 输入。
  • 仅把 next_cursor 用于已存储结果分页;来源只执行一次详情查询,通常最多生成一条记录。
  • 存储时允许作者、媒体、话题、时间和互动字段为空,并将可见计数与 collected_at 配对,避免把缺失值误判为零。

探索其他平台

还可以将 Rednote 数据与其他已支持社交平台的公开数据结合使用。

Rednote Note Detail API — 常见问题

Rednote Note Detail API 是一个通过受支持主机上带 token 的 URL 获取一条公开 Rednote 笔记的接口,返回标准化笔记标识、正文、作者、媒体、话题引用、时间和可见互动字段。

使用 xiaohongshu.com、xhslink.com 或其子域上的非空 URL。路径必须包含 /explore/{note_id} 或 /discovery/item/{note_id},查询参数必须含非空 xsec_token。

不可以。公开请求结构只接受 url;SocQ 会从该 URL 中提取 note_id 和 xsec_token。

应提交本身已带 xsec_token 的当前公开笔记 URL。其它 SocQ Rednote 笔记接口返回的 URL 只有在仍保留该查询参数时才能复用;Note Detail 不会生成缺失的 token。

标准帖子记录可以包含笔记标识、URL、正文、发布时间与采集时间、作者信息、媒体、话题、提及,以及可见的点赞、评论、分享和观看数量。未公开的选填字段可以为空。

不支持。来源只执行一次详情查询并最多保存一条记录。共享任务读取接口仍为 SocQ 已存储记录提供 limit、next_cursor 和 has_more。

此接口配置为每个任务固定消耗 1.00 SocQ 积分,预估费用不随返回记录数量变化。