rednote/
note-comments

提交 xiaohongshu.com 或 xhslink.com 上的 Rednote 笔记链接,采集一个来源页的公开评论,并获取文本、作者、时间、笔记关联和可见互动数据。

Rednote Note Comments API

笔记链接输入
单次来源请求
标准化评论
每次请求 1 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

Rednote Note Comments

Rednote 笔记评论是围绕某一公开笔记产生的回复,可包含评论正文、作者身份、发布时间、上下文关联和可见互动数。它们适合用于整理指定笔记下的公开讨论,同时保留每条观察的来源与采集时间。

Rednote Note Comments API 主要特性

  • 兼容 Rednote 分享链接可提交 xiaohongshu.com、xhslink.com 或其子域上的一个链接;note-comments 校验不会强制特定路径、查询参数或 xsec_token。
  • 稳定的评论记录以 CommentItem 1.0 结构返回评论 ID、正文、来源链接、时间以及可用作者身份,方便统一处理。
  • 笔记与上下文关联来源提供时保留 post_id 与 parent_id,使评论能够关联到目标笔记及可用的父级上下文。
  • 带时间锚点的互动字段将可用 likes_count、replies_count 与 collected_at 一并返回,不把缺失值写成零,也不暗示已覆盖完整回复树。

Rednote Note Comments API 参数

参数必填描述
url必填必填的非空链接。运行时接受 xiaohongshu.com、xhslink.com 及其子域,不强制路径或 xsec_token;请使用实际笔记分享链接,以便来源服务解析到正确笔记。

如何使用 Rednote Note Comments API

提交一个受支持的 Rednote 笔记分享链接,跟踪异步任务,并读取已保存的标准化评论。

  1. 复制 xiaohongshu.com 或 xhslink.com 上目标笔记的实际分享链接。
  2. 向 /v1/rednote/note-comments POST url,并保存响应中的 task_id。
  3. 轮询 /v1/tasks/{task_id},直到任务成功或返回失败。
  4. 读取 data.results.items;仅当 has_more 为 true 时使用 next_cursor 继续读取已保存结果。
curl -X POST "https://api.socq.ai/v1/rednote/note-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://xhslink.com/{share_code}"}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items;has_more 为 true 时继续传 next_cursor

Rednote Note Comments API 最佳使用场景

  • 定性回复编码: 围绕一个指定笔记查看公开评论正文与可用作者上下文,归纳问题、反应或反复出现的讨论主题。
  • 可追溯评论归档: 保存评论 ID、来源 URL、post_id、parent_id、published_at 和 collected_at,构建能追溯来源的研究记录。
  • 互动快照复核: 比较返回评论中可用的点赞数和回复数,并以采集时间标记每次观察。

Rednote Note Comments API 使用建议

  • 应复制目标笔记的完整分享链接;仅通过 hostname 校验,不代表来源服务一定能解析无关路径。
  • 不要虚构或单独要求 xsec_token;该规则属于 note-detail 契约,不属于 rednote/note-comments。
  • 提交时不要发送 results_limit 或来源 cursor;此契约只有 url,来源侧只发起一次请求。
  • 将 parent_id、post_id、时间、作者属性和互动指标视为可空来源字段,不要假定必有值。
  • 区分来源采集深度与 next_cursor;后者只分页读取已完成任务中保存的标准化记录。

探索其他平台

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

Rednote Note Comments API — 常见问题

Rednote Note Comments API 是一个通过指定 Rednote 笔记链接采集一页公开评论的接口,返回标准化评论记录。

运行时要求一个非空 url,其解析后的 hostname 必须是 xiaohongshu.com、xhslink.com 或其子域。虽然不强制具体路径或查询参数,但应提供实际笔记分享链接。

不需要。rednote/note-comments 只使用 Rednote 通用 hostname 校验;更严格的路径和 xsec_token 规则属于另一个 note-detail 契约。

不可以。提交契约只接受 url,provider 只发起一次来源请求,不支持调用方控制来源分页。

通用任务结果读取器可对成功任务中已经保存的 CommentItem 记录分页。这个 SocQ 不透明 cursor 不会再请求一个 Rednote 来源页。

每个成功任务固定收取 1.00 SocQ credit,与单次来源请求返回的评论数量无关。