Rednote Comment Replies
Rednote 评论回复是某篇笔记中嵌套在指定评论下的公开回应，可携带回复正文、作者信息、时间以及可用的关系或互动字段。标准化记录适合查看一个已知对话分支，同时避免把来源评论 ID 与已保存结果的分页游标混为一谈。
主要特性
- 成对锁定会话同时提交公开笔记 URL 和属于该笔记的评论 ID，明确指定需要读取的对话分支。
- 单页回复采集执行一次来源请求并保存该页返回的回复，不向提交参数暴露 provider cursor 或结果数量上限。
- 统一回复正文以通用 CommentItem 结构读取回复 ID、公开正文、来源 URL、发布时间和采集时间。
- 公开作者信息在每条回复旁保留可用的作者 ID、用户名、名称、主页 URL、头像和账号标记。
- 对话关系字段把可用的 parent_id、post_id 与公开点赞数和回复数一并保留，便于按会话关系处理。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
url | 必填 | 必填公开 URL；host 必须是 xiaohongshu.com、xhslink.com 或它们的子域名。本 endpoint 不额外要求笔记 path 格式或 xsec_token 查询参数。 |
comment_id | 必填 | 来源评论的必填标识符，长度 1 到 256，仅接受 ASCII 字母、数字、冒号、下划线或连字符。 |
如何使用
提交互相匹配的 Rednote 笔记 URL 和评论 ID，再通过 SocQ 异步任务流程读取单页回复结果。
- 选择公开的 xiaohongshu.com 或 xhslink.com 笔记 URL，并核实同一笔记中的兼容评论 ID。
- 向 /v1/rednote/comment-replies POST url 和 comment_id，并保存返回的 task_id。
- 任务处于 queued、running 或 retrying 时轮询 GET /v1/tasks/{task_id}，在 succeeded 或 failed 时停止。
- 成功后读取 data.results.items；仅在翻阅 SocQ 已保存回复行时使用 data.results.next_cursor。
curl -X POST "https://api.socq.ai/v1/rednote/comment-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"url\":\"$REDNOTE_NOTE_URL\",\"comment_id\":\"$REDNOTE_COMMENT_ID\"}"
# 轮询 GET /v1/tasks/{task_id}
# 状态变为 succeeded 后读取 data.results.items最佳使用场景
- 聚焦对话审阅： 查看一条指定评论分支的公开回复正文与时间，避免把整篇笔记下的回应混在一起。
- 参与者信息补充： 准备人工查看或内容治理研究记录时，把每条回复与可用的标准化作者身份关联起来。
- 会话关系映射： 在字段存在时，使用回复 ID、parent_id 和 post_id 把保存记录重新连接到来源评论和笔记。
- 时点回应快照： 将 collected_at 与可见点赞数或回复数一起保存，使不同时间的采集保持为可区分的观察值。
使用建议
- 确认 comment_id 属于所提交的笔记 URL；endpoint 会校验两个字段各自的格式，但不会在来源请求前证明它们互相匹配。
- 使用 xiaohongshu.com、xhslink.com 或其可接受子域名上的完整公开 URL；该 validator 不要求特定笔记 path 或 xsec_token 查询参数。
- 确保 comment_id 符合 1 到 256 个 ASCII 标识字符的规则，不要用内部数据库 ID 或 SocQ task_id 代替。
- 把其它采集结果中的评论 ID 视为条件性输入：标准化评论 ID 是可空字段，提交前应先确认确实存在可用值。
- 不要在提交 payload 中加入 results_limit 或来源 cursor；该 endpoint 只执行一次 provider 请求并读取一个来源页。
- 区分任务结果 next_cursor 与 comment_id；前者仅在任务成功后翻阅 SocQ 已保存的标准化记录。
- 为身份、关系、时间和指标字段保留空值处理，并在其它产品中展示公开回复正文前进行转义。