小红书笔记评论 API 简明文档（含 JSON 样例）
前言
一、接口简介
小红书笔记评论 API 用于获取单条笔记下的主评论、楼中楼子评论、用户信息、互动数据，支持分页与排序，是舆情分析、内容调研、用户反馈采集的常用接口。
接口采用 HTTPS 请求，基于 Token 鉴权，使用游标分页，不依赖传统页码。
二、基础调用信息
接口地址：
/api/v1/note/comment/list请求方式：POST
鉴权方式：请求头携带
Authorization: Bearer 访问令牌分页规则：使用
cursor游标翻页，has_more判断是否还有下一页单页条数：默认 20 条，最大支持 50 条
三、请求入参示例
json
{
"note_id": "649c46ab000000002702ad36", "cursor": "", "page_size": 20, "sort": "hot", "need_sub_comment": true}
参数说明
note_id：笔记唯一 ID，必填cursor：分页游标，第一页传空字符串page_size：单页评论数量sort：排序方式，hot热门、time最新need_sub_comment：是否返回楼中楼子评论
四、原始返回 JSON 示例
json
{
"code": 200,
"msg": "success",
"data": {
"note_id": "649c46ab000000002702ad36",
"total_comment": 1256,
"cursor": "crs_20260609_001",
"has_more": true,
"comments": [
{
"comment_id": "com_1122334455",
"content": "使用感很棒，性价比很高，已经回购啦",
"create_time": 1744289620,
"like_count": 326,
"reply_count": 18,
"is_top": true,
"user": {
"user_id": "u_589abc789",
"nickname": "护肤爱好者",
"avatar": "https://sns-avatar-qc.xhscdn.com/avatar/abc123.jpg"
},
"sub_comments": [
{
"comment_id": "sub_998877",
"content": "请问在哪里入手的？",
"create_time": 1744290120,
"like_count": 12,
"reply_user_id": "u_589abc789",
"user": {
"user_id": "u_321def654",
"nickname": "新手小白",
"avatar": "https://sns-avatar-qc.xhscdn.com/avatar/def456.jpg"
}
}
]
}
]
}}五、核心字段说明
顶层状态
code：200 表示请求成功；非 200 为异常total_comment：笔记评论总数cursor：下一页分页游标has_more：true代表还有更多数据
主评论字段
comment_id：评论唯一标识content：评论内容create_time：发布时间（Unix 时间戳）like_count：点赞数，reply_count：回复数is_top：是否为置顶评论user：评论者账号信息（ID、昵称、头像）
子评论字段
sub_comments：楼中楼回复列表reply_user_id：回复目标用户 ID
六、异常返回示例
1. Token 失效
json
{
"code": 401,
"msg": "token已过期，请重新授权",
"data": {}}2. 接口限流
json
{
"code": 429,
"msg": "请求过于频繁，请稍后再试",
"data": {}}3. 无效笔记 ID
json
{
"code": 400,
"msg": "note_id不存在",
"data": {}}七、简单开发要点
时间戳需手动转换为标准日期格式，方便统计展示；
遍历解析时做好空值判断，避免子评论为空导致程序报错；
循环读取
cursor直到has_more=false，完成全量评论抓取；控制调用频率，规避接口限流。
八、应用场景
笔记口碑分析、用户问答收集、竞品内容监控、评论关键词提取。
