跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像AI 生图工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Python

小红书笔记详情 API 数据结构与调用方式解析

小红书笔记详情 API 面向官方合作方提供数据标准化接口,支持 HTTPS/gRPC 协议及 GET/POST 请求。核心鉴权采用 AppKey+AppSecret 签名与 OAuth2.0 令牌双重机制。返回数据结构包含基础、内容、互动、作者四大模块,含图片视频媒体资源及脱敏信息。调用需遵循频率限制与合规要求,禁止爬虫或数据贩卖,仅用于合作场景展示。

Ne0发布于 2026/3/16更新于 2026/7/2551 浏览
小红书笔记详情 API 数据结构与调用方式解析

小红书笔记详情 API 数据结构与调用方式解析

小红书笔记详情 API 是面向官方合作方/授权开发者提供笔记核心数据的标准化接口,主要用于合规场景下的内容展示、数据分析(需授权)等需求。该接口的设计围绕数据标准化、权限管控、内容合规三大核心,其数据结构与调用方式具有鲜明的内容社区属性。

一、接口基础信息

1. 接口访问前提

  • 权限限制:小红书笔记详情 API 不对外开放,仅对通过企业资质审核的合作方(如品牌服务商、合规内容平台)开放,个人开发者无法申请。
  • 调用协议:支持 HTTPS 协议,保障数据传输安全;高并发场景可申请 gRPC 协议支持。
  • 请求方式:以 GET 为主(只读查询),部分带用户个性化参数的请求支持 POST。
  • 数据格式:默认返回 JSON 格式,支持 Protobuf 二进制格式(需申请开通,传输效率更高)。

2. 核心鉴权方式

小红书 API 采用双重鉴权机制,防止非法调用:

  1. 基础鉴权:AppKey + AppSecret 签名机制
    • 开发者通过官方平台获取 AppKey(应用标识)和 AppSecret(密钥)。
    • 请求时需对参数按规则排序,通过 HMAC-SHA256 算法生成签名(sign 参数),服务端校验签名有效性。
    • 签名参数必须包含 timestamp(时间戳),且时间戳与服务器时间偏差不超过 ±5 分钟,防止重放攻击。
  2. 用户级鉴权:OAuth2.0 令牌机制
    • 若需获取笔记的个性化数据(如用户是否点赞、收藏该笔记),需通过用户授权获取 access_token,并在请求头中携带。

二、核心数据结构

小红书笔记详情 API 返回的数据结构包含基础信息、内容信息、互动信息、作者信息四大模块,字段设计兼顾内容展示与合规要求。以下是标准化的 JSON 数据结构示例及字段说明:

{
  "code": 0,
  "msg": "success",
  "data": {
    "note_id": "648a7b2f0000000012345678",
    "title": "夏日清爽穿搭指南 | 平价 T 恤分享",
    "desc": "这几件 T 恤真的巨舒服!均价 50r,学生党冲...",
    "content": 
     
     
     
     
       
     
       
        
        
      
       
         
         
         
      
    
     
       
       
       
       
       
    
     
       
       
       
       
    
     
       
       
       
    
     
     
  

"<p>哈喽姐妹们👋 今天给大家分享...</p>"
,
"create_time"
:
1719984000
,
"update_time"
:
1719985200
,
"note_type"
:
"normal"
,
"category"
:
"fashion"
,
"tags"
:
[
"夏日穿搭"
,
"平价 T 恤"
,
"学生党"
]
,
"media"
:
{
"images"
:
[
"https://xxx.xiaohongshu.com/xxx/1.jpg"
,
"https://xxx.xiaohongshu.com/xxx/2.jpg"
]
,
"video"
:
{
"play_url"
:
"https://xxx.xiaohongshu.com/xxx/video.mp4"
,
"cover_url"
:
"https://xxx.xiaohongshu.com/xxx/cover.jpg"
,
"duration"
:
15.5
}
}
,
"author"
:
{
"user_id"
:
"12345678"
,
"nickname"
:
"穿搭小能手"
,
"avatar"
:
"https://xxx.xiaohongshu.com/xxx/avatar.jpg"
,
"level"
:
5
,
"is_verified"
:
true
}
,
"interaction"
:
{
"like_count"
:
12580
,
"collect_count"
:
3620
,
"comment_count"
:
890
,
"share_count"
:
120
}
,
"location"
:
{
"name"
:
"上海市徐汇区"
,
"latitude"
:
31.197
,
"longitude"
:
121.436
}
,
"status"
:
"published"
,
"is_commercial"
:
false
}
}
关键字段说明
模块核心字段字段用途
基础信息note_id、title笔记唯一标识与核心标题,用于内容定位
内容信息content、media笔记正文(富文本)与媒体资源(图片/视频),是内容展示的核心
作者信息author(脱敏)仅返回公开信息,隐藏手机号、精确地址等隐私数据
互动信息like_count 等反映笔记热度,用于数据分析与内容推荐
合规字段is_commercial、status标识商业笔记与内容状态,防止违规内容传播

三、接口调用方式

1. 标准请求示例

(1)请求 URL
https://openapi.xiaohongshu.com/v2/note/detail
(2)请求参数

分为公共参数(所有接口必填)和业务参数(当前接口必填):

参数类型参数名说明
公共参数app_key应用唯一标识(官方分配)
公共参数sign签名值(通过 AppSecret 生成)
公共参数timestamp当前时间戳(秒级)
公共参数access_token用户授权令牌(非必填,仅个性化查询需要)
业务参数note_id笔记 ID(必填,需查询的笔记唯一标识)
(3)请求头示例
Headers: {
  "Content-Type": "application/json",
  "User-Agent": "Xiaohongshu-OpenAPI-SDK/1.0.0"
}
(4)签名生成逻辑(Python 伪代码)
import hashlib
import hmac
import time

def generate_sign(app_secret, params):
    # 1. 按参数名 ASCII 升序排序
    sorted_params = sorted(params.items(), key=lambda x: x[0])
    # 2. 拼接为 key=value 格式的字符串
    sign_str = "&".join([f"{k}={v}" for k, v in sorted_params])
    # 3. 拼接 AppSecret 并生成 HMAC-SHA256 签名
    sign = hmac.new(app_secret.encode("utf-8"), sign_str.encode("utf-8"), hashlib.sha256).hexdigest()
    return sign

# 调用示例
params = {
    "app_key": "your_app_key",
    "note_id": "648a7b2f0000000012345678",
    "timestamp": str(int(time.time()))
}
sign = generate_sign("your_app_secret", params)
params["sign"] = sign

2. 响应处理

(1)成功响应

返回 code=0,data 字段包含完整的笔记详情数据,示例见上文数据结构部分。

(2)常见错误响应
错误码错误信息原因分析与解决方案
1001app_key invalidAppKey 无效,检查是否为官方分配的有效密钥
1002sign verify failed签名错误,检查签名算法、参数排序是否正确
1003request frequency limit调用频率超限,降低请求 QPS 或申请提升限额
2001note_id invalid笔记 ID 不存在或已被删除
2002permission denied无权限访问该笔记(如私密笔记)

四、接口调用限制与合规要求

  1. 频率限制
    • 单 AppKey 有日调用限额和秒级 QPS 限制(如基础版 1000 次/日、10QPS),超出限制返回 1003 错误。
    • 禁止批量抓取笔记数据,仅允许按需查询单条笔记详情。
  2. 数据用途限制
    • 调用所得数据仅允许用于合作场景内的展示,禁止用于爬虫、竞品分析、数据贩卖等违规用途。
    • 引用笔记内容时需注明'来源小红书',并遵守平台版权规则。
  3. 隐私合规
    • 不得存储或传播作者的脱敏信息,不得通过接口数据反向识别用户身份。

目录

  1. 小红书笔记详情 API 数据结构与调用方式解析
  2. 一、接口基础信息
  3. 1. 接口访问前提
  4. 2. 核心鉴权方式
  5. 二、核心数据结构
  6. 关键字段说明
  7. 三、接口调用方式
  8. 1. 标准请求示例
  9. (1)请求 URL
  10. (2)请求参数
  11. (3)请求头示例
  12. (4)签名生成逻辑(Python 伪代码)
  13. 调用示例
  14. 2. 响应处理
  15. (1)成功响应
  16. (2)常见错误响应
  17. 四、接口调用限制与合规要求
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • MuJoCo 足式机器人强化学习:URDF 转 XML 配置指南
  • Git 安全撤回已 commit 但未 push 的更改
  • Mac 平台 Homebrew 安装配置及常用命令详解
  • VirtualBox 创建虚拟机并安装 Ubuntu 系统指南
  • 内容创作模式解析:UGC、PGC、PUGC、AIGC 等概念详解
  • Chatbot UI:开源 AI 聊天应用框架
  • WebDAV + Rclone:安全约束下的跨平台文件传输实践
  • IMDB 情感分类实战:Word2Vec + 逻辑回归完整解析
  • Ubuntu 22.04 离线部署 Qwen3-4B 模型:vLLM 与 Docker 多卡配置指南
  • DeepSeek 各版本说明与优缺点分析
  • AI 时代,为何架构师反而更稀缺了?
  • 给本地 AI 助手装「超级插件市场」:OpenClaw 技能实战指南
  • PANTONE 潘通色标薄全系列 AI 色板库
  • Redis 配置密码不生效的排查与解决方案
  • 机器人系统设计核心:从架构拆解到工程落地实践
  • MiniMax 海螺 AI 视频:图片与文本生成高质量视频
  • Ubuntu 22.04 基于 ROS2 Humble 的 PX4 无人机仿真环境搭建
  • Trae AI 编程工具使用指南及竞品对比分析
  • VSCode Java 环境配置:解决 JDK 版本不一致问题
  • 算法基础:前缀和技巧与区间求和优化

相关免费在线工具

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online