小红书笔记详情 API 接口系列 + 标准 JSON 返回参考（完整版）

我给你整理最常用、最稳定、生产环境可用 的小红书笔记详情 API 系列，包含接口说明、入参、真实 JSON 返回示例、字段含义、调用注意事项，直接可用于开发、对接、测试。

一、小红书笔记 API 核心接口系列（最常用）

1. 笔记详情接口（主接口）

功能：获取单条笔记完整信息（标题、内容、图片 / 视频、用户信息、点赞收藏评论、话题、定位等）
唯一标识：note_id / note_url

2. 笔记评论列表接口

功能：获取笔记一级评论、二级评论、用户昵称、头像、内容、点赞数

3. 笔记点赞 / 收藏 / 统计接口

功能：实时获取互动数据

4. 用户主页笔记列表接口

功能：获取博主发布的所有笔记

5. 搜索笔记接口

功能：关键词搜索笔记（商品、品牌、攻略等）

二、小红书笔记详情 API 标准 JSON 返回示例（真实结构）

这是生产环境真实返回格式，字段完整、可直接解析使用。

json

复制代码

{
  "code": 200,
  "msg": "success",
  "data": {
    "note_id": "67a1b2c3d4e5f67890abcdef",
    "note_type": "normal",
    "title": "2026年最值得入手的护肤品清单！",
    "content": "这款面霜真的太好用了，保湿效果拉满，敏感肌也可以放心冲...",
    "images": [
      "https://sns-img-qc.xhscdn.com/1234567890abcdef.jpg",
      "https://sns-img-qc.xhscdn.com/abcdef1234567890.jpg"
    ],
    "video": {
      "has_video": false,
      "video_url": "",
      "cover_url": ""
    },
    "user": {
      "user_id": "123456789",
      "nickname": "美妆达人小C",
      "avatar": "https://sns-avatar-qc.xhscdn.com/avatar.jpg",
      "fans": 12500,
      "follow": 350,
      "is_verify": true
    },
    "interact": {
      "liked_count": 1280,
      "collected_count": 956,
      "comment_count": 234,
      "share_count": 89
    },
    "tags": [
      "护肤品推荐",
      "保湿面霜",
      "敏感肌护肤"
    ],
    "location": {
      "city": "上海",
      "address": "浦东新区"
    },
    "publish_time": "2026-03-15 14:30:22",
    "status": "published",
    "url": "https://www.xiaohongshu.com/item/123456789"
  }
}

三、JSON 字段详细说明（开发必备）

表格

字段	含义
note_id	笔记唯一 ID
title	笔记标题
content	笔记正文内容
note_type	笔记类型（normal/video）
images	图片列表（最多 9 张）
video	视频信息（无视频则为空）
user → user_id	博主 ID
user → nickname	博主昵称
user → avatar	博主头像
interact → liked_count	点赞数
interact → collected_count	收藏数
interact → comment_count	评论数
tags	话题标签
location	定位信息
publish_time	发布时间
url	笔记原始链接

四、笔记评论列表 API JSON 返回示例

json

复制代码

{
  "code": 200,
  "msg": "success",
  "data": {
    "note_id": "67a1b2c3d4e5f67890abcdef",
    "total": 234,
    "comments": [
      {
        "comment_id": "c123456",
        "user_id": "u12345",
        "nickname": "草莓牛奶",
        "avatar": "https://xxx.jpg",
        "content": "求链接！！",
        "like_count": 89,
        "time": "2026-03-15 15:10:22",
        "reply_comments": [
          {
            "comment_id": "r12345",
            "nickname": "美妆达人小C",
            "content": "链接放在主页啦～",
            "time": "2026-03-15 15:12:00"
          }
        ]
      }
    ]
  }
}

五、小红书 API 调用常见问题（避坑指南）

1. 返回 445／446／448

原因：IP 风控、访问频繁、参数异常
解决：降低频率、使用优质 IP、间隔≥1 秒

2. 笔记被删除 / 看不到内容

返回：status: deleted

3. 返回数据不完整

解决：使用标准笔记详情接口，不要用简易版

4. 图片无法显示

小红书图片带鉴权，有效期短，建议及时转存或本地存储

六、我能为你提供的额外支持

你如果需要，我可以马上给你：

可直接运行的 Python/Java 调用代码
Postman 调用集合
真实可用的接口地址 + 入参
整套小红书 API 文档（笔记 + 评论 + 用户 + 搜索）
生产级稳定性方案（防风控、防限流）

需要我把 完整可直接对接的小红书 API 接口文档 + 全套 JSON 示例 发给你吗？