Rednote Note Comments
Rednote 笔记评论是围绕某一公开笔记产生的回复，可包含评论正文、作者身份、发布时间、上下文关联和可见互动数。它们适合用于整理指定笔记下的公开讨论，同时保留每条观察的来源与采集时间。
主要特性
- 兼容 Rednote 分享链接可提交 xiaohongshu.com、xhslink.com 或其子域上的一个链接；note-comments 校验不会强制特定路径、查询参数或 xsec_token。
- 稳定的评论记录以 CommentItem 1.0 结构返回评论 ID、正文、来源链接、时间以及可用作者身份，方便统一处理。
- 笔记与上下文关联来源提供时保留 post_id 与 parent_id，使评论能够关联到目标笔记及可用的父级上下文。
- 带时间锚点的互动字段将可用 likes_count、replies_count 与 collected_at 一并返回，不把缺失值写成零，也不暗示已覆盖完整回复树。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
url | 必填 | 必填的非空链接。运行时接受 xiaohongshu.com、xhslink.com 及其子域，不强制路径或 xsec_token；请使用实际笔记分享链接，以便来源服务解析到正确笔记。 |
如何使用
提交一个受支持的 Rednote 笔记分享链接，跟踪异步任务，并读取已保存的标准化评论。
- 复制 xiaohongshu.com 或 xhslink.com 上目标笔记的实际分享链接。
- 向 /v1/rednote/note-comments POST url，并保存响应中的 task_id。
- 轮询 /v1/tasks/{task_id}，直到任务成功或返回失败。
- 读取 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最佳使用场景
- 定性回复编码： 围绕一个指定笔记查看公开评论正文与可用作者上下文，归纳问题、反应或反复出现的讨论主题。
- 可追溯评论归档： 保存评论 ID、来源 URL、post_id、parent_id、published_at 和 collected_at，构建能追溯来源的研究记录。
- 互动快照复核： 比较返回评论中可用的点赞数和回复数，并以采集时间标记每次观察。
使用建议
- 应复制目标笔记的完整分享链接；仅通过 hostname 校验，不代表来源服务一定能解析无关路径。
- 不要虚构或单独要求 xsec_token；该规则属于 note-detail 契约，不属于 rednote/note-comments。
- 提交时不要发送 results_limit 或来源 cursor；此契约只有 url，来源侧只发起一次请求。
- 将 parent_id、post_id、时间、作者属性和互动指标视为可空来源字段，不要假定必有值。
- 区分来源采集深度与 next_cursor；后者只分页读取已完成任务中保存的标准化记录。