小红书笔记详情 API 业务场景与标准 JSON 返回示例
一、接口简介
小红书笔记详情 API 为平台开放数据接口，通过传入
note_id笔记 ID，HTTPS+Token 鉴权拉取笔记全部公开信息，包含文案、图文视频、作者、互动数据、话题标签，适用于种草分析、竞品监控、达人评估等合规业务。二、常用业务场景
爆款内容拆解：提取标题、文案、标签、互动数据，总结流量逻辑
竞品种草监控：定时抓取竞品新品笔记，分析卖点与口碑
达人投放评估：单篇笔记点赞 / 收藏 / 评论数据，计算种草转化能力
品牌舆情采集：汇总品牌相关笔记，挖掘用户真实使用反馈
运营素材收集：批量获取笔记图文、种草文案用于内容参考
三、标准完整 JSON 返回示例
1、请求成功（图文笔记完整版，标准生产结构）
json
{
"code": 200,
"msg": "success",
"request_id": "req_202606221420008899",
"data": {
"note_id": "649c46ab000000002702ad36",
"note_type": "image",
"title": "油皮本命防晒｜清爽不搓泥，平价好物分享",
"content": "夏天出油多的姐妹一定要试试这款防晒，成膜快不闷痘，全身涂都不心疼～",
"create_time": 1744289620,
"tags": ["防晒", "油皮护肤", "平价美妆"],
"images": [
"https://sns-img-qc.xhscdn.com/img_01.jpg",
"https://sns-img-qc.xhscdn.com/img_02.jpg"
],
"video": {
"has_video": false,
"video_url": "",
"cover_url": ""
},
"statistics": {
"like_count": 6892,
"collect_count": 4230,
"comment_count": 546,
"share_count": 216,
"view_count": 96800
},
"author": {
"user_id": "u_589abc789",
"nickname": "油痘肌护肤日记",
"avatar": "https://sns-avatar-qc.xhscdn.com/avatar.jpg",
"fans_count": 156000,
"note_count": 326
},
"location": {
"name": "成都"
}
}}2、视频笔记差异化片段（仅替换 media 部分）
json
"note_type": "video","images": ["https://sns-img-qc.xhscdn.com/video_cover.jpg"],"video": {
"has_video": true, "video_url": "https://sns-video-qc.xhscdn.com/demo.mp4", "cover_url": "https://sns-img-qc.xhscdn.com/video_cover.jpg", "duration": 62}
3、异常错误 JSON 示例
json
// Token过期无权限{
"code": 401,
"msg": "token invalid or expired",
"request_id": "req_202606221421001122"}// 调用频率限流{
"code": 429,
"msg": "request too frequent, please retry later",
"request_id": "req_202606221421003344"}// 笔记ID无效/笔记已删除{
"code": 400,
"msg": "note_id not exists",
"request_id": "req_202606221421005566"}四、核心字段简要说明
顶层状态
code：状态码 200 正常；401 鉴权失败；429 限流；400 参数错误笔记基础
note_id唯一笔记 ID；note_typeimage 图文 /video 视频；create_timeUnix 时间戳媒体资源
images图片数组；video视频链接、封面、时长互动统计
statistics点赞、收藏、评论、分享、浏览量，流量核心指标作者信息
author用户 ID、昵称、头像、粉丝、发布笔记总数附加信息
tags话题标签；location发布定位
五、开发简单提示
video、location、images存在空值，解析需做空判断，避免程序报错create_time时间戳需转换为标准日期格式展示接口存在 QPS 限制，批量采集需增加请求间隔防止 429 限流
仅可用于合规数据分析，禁止爬虫、倒卖平台用户数据
