首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >小红书笔记评论 API:核心场景与 JSON 返回示例

小红书笔记评论 API:核心场景与 JSON 返回示例

原创
作者头像
Anzexi58
修改2026-06-15 14:33:26
修改2026-06-15 14:33:26
1840
举报
文章被收录于专栏:API接口开发API接口开发

一、接口简介

小红书笔记评论API 是开放平台核心数据接口,基于HTTPS+Token 鉴权,用游标分页获取笔记下主评论、楼中楼、用户信息与互动数据,是舆情监控、内容分析、竞品调研的合规数据渠道。

二、实战 JSON 返回示例(成功 + 失败)

1. 成功返回(完整脱敏样例)

代码语言:javascript
复制
{
    "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)
代码语言:javascript
复制
{
    "code": 401,
    "msg": "Invalid or expired token",
    "request_id": "req_202606151420005678"
}
(2)接口限流(code=429)
代码语言:javascript
复制
{
    "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。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 二、实战 JSON 返回示例(成功 + 失败)
    • 1. 成功返回(完整脱敏样例)
    • 2. 失败返回(常见错误)
      • (1)Token 失效(code=401)
      • (2)接口限流(code=429)
  • 三、关键字段说明
  • 四、开发要点
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档