小红书笔记评论 API：核心场景与 JSON 返回示例
一、接口简介
小红书笔记评论 API 是开放平台核心数据接口，基于HTTPS+Token 鉴权，用游标分页获取笔记下主评论、楼中楼、用户信息与互动数据，是舆情监控、内容分析、竞品调研的合规数据渠道。
二、核心实战场景
品牌舆情监控：实时抓取品牌相关笔记评论，识别 “过敏、假货、拔草” 等负面词，触发预警；统计正负向口碑占比，生成日报。
竞品爆款拆解：批量拉取竞品热门笔记评论，提炼高频痛点与种草关键词，反推自家内容选题与产品优化方向。
达人合作评估：统计达人笔记评论量、互动率、“求链接” 转化意愿，量化合作效果，辅助达人筛选。
内容运营优化：从评论挖掘高频问题（如 “油皮能用吗”），优化笔记置顶引导与内容补充，提升转化率。
用户 FAQ 收集：整理评论区常见疑问（价格、用法、肤质适配），构建知识库，提升客服效率。
三、实战 JSON 返回示例（成功 + 失败）
1. 成功返回（完整脱敏样例）
json
{
"code": 200,
"msg": "success",
"request_id": "req_202606151420001234",
"data": {
"note_id": "649c46ab000000002702ad36",
"total_comment": 1256,
"cursor": "crs_20260615_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"
},
"reply_comments": [
{
"comment_id": "rpl_667788",
"content": "敏感肌能用吗？",
"create_time": 1744289700,
"like_count": 45,
"user": {
"nickname": "敏感肌小C"
}
}
]
},
{
"comment_id": "com_6677889900",
"content": "求链接！多少钱入的？",
"create_time": 1744290100,
"like_count": 89,
"reply_count": 6,
"is_top": false,
"user": {
"user_id": "u_123def456",
"nickname": "草莓奶盖不加糖",
"avatar": "https://sns-avatar-qc.xhscdn.com/avatar/def456.jpg"
},
"reply_comments": []
}
]
}}2. 失败返回（常见错误）
（1）Token 失效（code=401）
json
{
"code": 401, "msg": "Invalid or expired token", "request_id": "req_202606151420005678"}
（2）接口限流（code=429）
json
{
"code": 429, "msg": "Too many requests, please try again later", "request_id": "req_202606151420009012"}
四、关键字段说明
表格
| 字段 | 说明 |
|---|---|
note_id | 笔记唯一 ID（请求必传） |
total_comment | 笔记总评论数 |
cursor | 分页游标（下一页请求参数） |
has_more | 是否有下一页（true/false） |
comment_id | 评论唯一 ID |
content | 评论正文 |
create_time | 评论时间（Unix 时间戳，需格式化） |
like_count | 评论点赞数 |
reply_count | 评论回复数 |
is_top | 是否置顶评论 |
user.nickname | 评论者昵称（脱敏） |
reply_comments | 楼中楼子评论数组 |
五、开发要点
分页规则：用
cursor翻页，循环至has_more=false，单页最大 50 条。时间处理：
create_time为时间戳，需转yyyy-MM-dd HH:mm:ss。限流规避：控制 QPS，加缓存，避免高频调用触发 429。
合规提醒：仅用于授权数据采集，禁止爬虫非公开数据。
