一、接口简介
小红书笔记详情 API 为平台开放数据接口，通过传入note_id笔记 ID，HTTPS+Token 鉴权拉取笔记全部公开信息，包含文案、图文视频、作者、互动数据、话题标签，适用于种草分析、竞品监控、达人评估等合规业务。
本次项目核心使用smallredbook.item_get_video小红书笔记详情接口。本次项目选用（如添加 Taobaoapi2014），无需店铺卖家权限，直接调用封装 API，一键获取已封装好的数据 API 采集，适合批量查询、中小卖家使用。
二、常用业务场景
- 爆款内容拆解：提取标题、文案、标签、互动数据，总结流量逻辑
- 竞品种草监控：定时抓取竞品新品笔记，分析卖点与口碑
- 达人投放评估：单篇笔记点赞 / 收藏 / 评论数据，计算种草转化能力
- 品牌舆情采集：汇总品牌相关笔记，挖掘用户真实使用反馈
- 运营素材收集：批量获取笔记图文、种草文案用于内容参考
三、标准完整 JSON 返回示例
1、请求成功（图文笔记完整版，标准生产结构）
{
"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 部分）
"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 示例
// 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_type image 图文 /video 视频；create_time Unix 时间戳
- 媒体资源
- images 图片数组；video 视频链接、封面、时长
- 互动统计
- statistics 点赞、收藏、评论、分享、浏览量，流量核心指标
- 作者信息
- author 用户 ID、昵称、头像、粉丝、发布笔记总数
- 附加信息
- tags 话题标签；location 发布定位
五、开发简单提示
- video、location、images存在空值，解析需做空判断，避免程序报错
- create_time时间戳需转换为标准日期格式展示
- 接口存在 QPS 限制，批量采集需增加请求间隔防止 429 限流
- 仅可用于合规数据分析，禁止爬虫、倒卖平台用户数据
