首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >小红书笔记详情API业务场景与标准JSON返回示例

小红书笔记详情API业务场景与标准JSON返回示例

原创
作者头像
wx19970108018
发布2026-07-01 14:45:52
发布2026-07-01 14:45:52
1180
举报

一、接口简介

小红书笔记详情 API 为平台开放数据接口,通过传入note_id笔记 ID,HTTPS+Token 鉴权拉取笔记全部公开信息,包含文案、图文视频、作者、互动数据、话题标签,适用于种草分析、竞品监控、达人评估等合规业务。 本次项目核心使用smallredbook.item_get_video小红书笔记详情接口。本次项目选用(如添加 Taobaoapi2014),无需店铺卖家权限,直接调用封装 API,一键获取已封装好的数据 API 采集,适合批量查询、中小卖家使用。

二、常用业务场景

  1. 爆款内容拆解:提取标题、文案、标签、互动数据,总结流量逻辑
  2. 竞品种草监控:定时抓取竞品新品笔记,分析卖点与口碑
  3. 达人投放评估:单篇笔记点赞 / 收藏 / 评论数据,计算种草转化能力
  4. 品牌舆情采集:汇总品牌相关笔记,挖掘用户真实使用反馈
  5. 运营素材收集:批量获取笔记图文、种草文案用于内容参考

三、标准完整 JSON 返回示例

1、请求成功(图文笔记完整版,标准生产结构)

代码语言:javascript
复制
json 代码解读复制代码{
    "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 部分)

代码语言:javascript
复制
json 代码解读复制代码"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 示例

代码语言:javascript
复制
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"
}

四、核心字段简要说明

  1. 顶层状态
  2. code:状态码 200 正常;401 鉴权失败;429 限流;400 参数错误
  3. 笔记基础
  4. note_id 唯一笔记 ID;note_type image 图文 /video 视频;create_time Unix 时间戳
  5. 媒体资源
  6. images 图片数组;video 视频链接、封面、时长
  7. 互动统计
  8. statistics 点赞、收藏、评论、分享、浏览量,流量核心指标
  9. 作者信息
  10. author 用户 ID、昵称、头像、粉丝、发布笔记总数
  11. 附加信息
  12. tags 话题标签;location 发布定位

五、开发简单提示

  1. video、location、images存在空值,解析需做空判断,避免程序报错
  2. create_time时间戳需转换为标准日期格式展示
  3. 接口存在 QPS 限制,批量采集需增加请求间隔防止 429 限流
  4. 仅可用于合规数据分析,禁止爬虫、倒卖平台用户数据

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 一、接口简介
  • 二、常用业务场景
  • 三、标准完整 JSON 返回示例
  • 1、请求成功(图文笔记完整版,标准生产结构)
  • 2、视频笔记差异化片段(仅替换 media 部分)
  • 3、异常错误 JSON 示例
  • 四、核心字段简要说明
  • 五、开发简单提示
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档