小红书笔记详情API介绍、应用场景及JSON返回示例
一、接口概述
小红书笔记详情API是用于获取单条小红书笔记完整数据的接口。通过传入笔记ID，可获取笔记标题、正文、图片视频、发布时间、标签、作者信息、点赞收藏评论等全部公开数据。接口采用Token鉴权、HTTPS请求，是小红书内容分析最常用的基础接口。
二、主要业务场景
爆款笔记分析：拆解热门笔记文案、标签、互动数据，总结爆款规律。
竞品监控：实时监控竞品发布的种草笔记、数据表现。
达人数据分析：统计单篇笔记互动率，判断达人带货质量。
品牌口碑采集：收集用户真实种草、评价，用于产品优化。
内容素材整理：批量获取图文素材、文案用于运营参考。
三、JSON返回实战示例（简洁标准）
成功返回
{
"code": 200,
"msg": "success",
"data": {
"note_id": "649c46ab000000002702ad36",
"title": "秋冬保湿面霜推荐｜干皮救命神器",
"content": "质地水润超好吸收，保湿持久不闷痘，干皮秋冬必备！",
"create_time": 1745001234,
"note_type": "image",
"tags": ["护肤", "面霜", "干皮保湿"],
"images": [
"https://sns-img.xhscdn.com/xxx1.jpg",
"https://sns-img.xhscdn.com/xxx2.jpg"
],
"video_url": "",
"like_count": 5200,
"collect_count": 3100,
"comment_count": 420,
"share_count": 130,
"author": {
"user_id": "u12345678",
"nickname": "护肤小达人",
"fans_count": 98000
}
}
}错误返回示例
// 令牌失效
{
"code": 401,
"msg": "token invalid"
}
// 请求限流
{
"code": 429,
"msg": "request too frequent"
}
// 笔记不存在
{
"code": 400,
"msg": "note id error"
}四、核心字段说明
note_id：笔记唯一标识，请求必填参数
title、content：笔记标题和正文内容
note_type：笔记类型，图文/视频
images、video_url：素材地址
tags：笔记话题标签
like/collect/comment：笔记各项互动数据
author：作者账号信息与粉丝量
create_time：发布时间戳
五、开发注意事项
接口需Token鉴权，调用频率有限制，高频请求会触发429限流；图片、视频字段可能为空，开发时需做容错处理；时间戳需要格式化展示。所有数据仅可用于合规数据分析。
