小红书笔记详情 API 数据结构与调用方式解析
小红书笔记详情 API 是面向官方合作方/授权开发者提供笔记核心数据的标准化接口,主要用于合规场景下的内容展示、数据分析(需授权)等需求。该接口的设计围绕数据标准化、权限管控、内容合规三大核心,其数据结构与调用方式具有鲜明的内容社区属性。
一、接口基础信息
1. 接口访问前提
- 权限限制:小红书笔记详情 API 不对外开放,仅对通过企业资质审核的合作方(如品牌服务商、合规内容平台)开放,个人开发者无法申请。
- 调用协议:支持 HTTPS 协议,保障数据传输安全;高并发场景可申请 gRPC 协议支持。
- 请求方式:以 GET 为主(只读查询),部分带用户个性化参数的请求支持 POST。
- 数据格式:默认返回 JSON 格式,支持 Protobuf 二进制格式(需申请开通,传输效率更高)。
2. 核心鉴权方式
小红书 API 采用双重鉴权机制,防止非法调用:
- 基础鉴权:AppKey + AppSecret 签名机制
- 开发者通过官方平台获取 AppKey(应用标识)和 AppSecret(密钥)。
- 请求时需对参数按规则排序,通过 HMAC-SHA256 算法生成签名(sign 参数),服务端校验签名有效性。
- 签名参数必须包含 timestamp(时间戳),且时间戳与服务器时间偏差不超过 ±5 分钟,防止重放攻击。
- 用户级鉴权:OAuth2.0 令牌机制
- 若需获取笔记的个性化数据(如用户是否点赞、收藏该笔记),需通过用户授权获取 access_token,并在请求头中携带。
二、核心数据结构
小红书笔记详情 API 返回的数据结构包含基础信息、内容信息、互动信息、作者信息四大模块,字段设计兼顾内容展示与合规要求。以下是标准化的 JSON 数据结构示例及字段说明:
{
"code": 0,
"msg": "success",
"data": {
"note_id": "648a7b2f0000000012345678",
"title": "夏日清爽穿搭指南 | 平价 T 恤分享",
"desc": "这几件 T 恤真的巨舒服!均价 50r,学生党冲...",
"content": "<p>哈喽姐妹们👋 今天给大家分享...</p>"


