一、接口核心能力
smallredbook.item_get_video
是小红书官方开放的笔记视频详情接口,具备以下核心能力:
- 视频元数据获取:支持提取无水印视频直链、封面图、时长等基础信息。
- 内容深度解析:精准抓取笔记文本描述、标签体系(含多级分类)、互动数据(点赞/收藏/评论真实值)。
- 用户画像关联:返回作者昵称、城市、UID等基础信息,支持构建用户行为图谱。
- 电商场景赋能:覆盖商品视频展示、竞品动态监控、内容营销策略优化等高频需求。
典型应用案例:某国际美妆品牌通过该接口抓取竞品TOP100视频,分析高互动内容标签组合规律,优化后自家产品视频完播率提升38%,种草转化率提高22%。
二、API调用全流程
1. 必备参数
| 参数名 | 类型 | 说明 | 示例值 |
|---------|--------|--------------------------|----------------------------|
| key | String | 阿里云/第三方平台申请的API密钥 | <your_api_key>
|
| secret | String | 密钥对中的Secret | <your_api_secret>
|
| num_iid | String | 笔记ID(URL最后一段) | 649c46ab000000002702ad36
|
2. 请求示例(Python)
import requests api_url = "https://api-gw.onebound.cn/smallredbook/item_get_video" params = { "key": "your_key", "secret": "your_secret", "num_iid": "649c46ab000000002702ad36", # 目标笔记ID "result_type": "jsonu" # 中文友好格式 } response = requests.get(api_url, params=params) data = response.json() if data["error_code"] == "0000": video_url = data["item"]["video"] # 直接下载的MP4链接 title = data["item"]["title"] likes = data["item"]["interact_info"]["liked_count"] print(f"获取成功:{title}(点赞{likes})") else: print(f"错误:{data['reason']}(代码{data['error_code']})")
3. 核心返回字段解析
{ "item": { "video": "http://sns-video-qc.xhscdn.com/stream/xxx.mp4", // 无水印视频直链 "title": "变形金刚4经典片段", // 笔记标题 "desc": "柱子哥的魅力无人能挡", // 视频描述 "tag_list": [{"name": "变形金刚", "type": "topic"}], // 内容标签 "interact_info": { "liked_count": "4100", // 真实点赞数(非显示值) "comment_count": "237" }, "nick": "电影剪辑侠", // 作者昵称 "time": "2023-06-28 22:41:47" // 发布时间 } }
三、电商场景实战技巧
1. 商品视频监控(竞品分析)
# 定时任务:每天抓取TOP10竞品视频数据 import schedule import time from datetime import datetime def fetch_api(num_iid): # 调用API逻辑(同上) pass def save_to_db(data): # 数据库存储逻辑 pass def monitor_competitors(): competitor_ids = ["64a0xxxx", "64b1xxxx"] # 竞品笔记ID for num_iid in competitor_ids: data = fetch_api(num_iid) save_to_db({ "date": datetime.now(), "video_url": data["video"], "likes": data["liked_count"], "tags": data["tag_list"] }) schedule.every(1).day.at("00:00").do(monitor_competitors) while True: schedule.run_pending() time.sleep(1)
数据价值:通过持续监控竞品视频表现,某家居品牌发现"小户型收纳"类内容在周末晚间互动率比工作日高45%,据此调整投放策略后ROI提升31%。
2. 个性化推荐(内容分发)
- 标签匹配:将
tag_list
与用户画像交叉分析(如"油皮护肤"+"学生党"定向推送) - 互动优先:优先展示
liked_count>1000
的高潜力视频
成功案例:某母婴品牌通过该接口筛选"辅食制作"标签视频,结合用户孕期阶段推送,相关内容转化率提升27%,客单价提高19%。
四、合规与反爬注意事项
1. 调用限制
- 阿里云接口:默认QPS=10,企业用户可申请扩容至100+
- 频率控制:建议添加随机延迟(0.5-2秒),模拟人工操作
2. 数据使用边界
- 禁止爬取用户隐私数据(如IP、精确地理位置)
- 视频仅限内部分析,商用需获得作者授权
3. 错误码处理
| 错误码 | 含义 | 解决方案 |
|--------|-----------------------|------------------------------|
| 2000 | 笔记不存在(删除/下架)| 检查URL有效性 |
| 403 | API权限不足 | 核对key/secret有效性 |
| 503 | 限流 | 增加代理IP或延迟30秒后重试 |
五、替代方案对比(非API场景)
| 方法 | 优点 | 缺点 | 适用场景 |
|------------|-----------------------|-------------------------------|------------------------|
| API直连 | 合法、稳定、无水印 | 需申请资质,限制QPS | 企业级长期监控 |
| 小程序解析 | 无需编程,即用即走 | 依赖第三方工具,易失效 | 临时下载少量视频 |
| 浏览器抓包 | 绕过API限制 | 需逆向JS,反爬风险高 | 技术验证/学术研究 |
| 录屏法 | 无技术门槛 | 画质损失、含水印 | 个人非商用保存 |
推荐策略:优先使用官方API(如smallredbook.item_get_video
),合规性和稳定性最佳;非官方方案需评估法律风险,避免大规模采集。
六、常见问题解答
Q1:如何获取笔记ID?
A:小红书APP内点击视频→右上角"..."→复制链接,URL末尾即为num_iid
(如https://xhslink.com/xxx?num_iid=649c46ab...
)。
Q2:返回的视频链接有时效性吗?
A:直链有效期通常为7天,建议获取后立即下载或缓存。2023年Q3数据显示,过期链接占比达12%,需特别注意。
Q3:能否批量获取多个视频?
A:支持循环调用,但需控制频率(建议≤50次/分钟),避免触发风控。某电商团队测试表明,超过80次/分钟时被封禁概率提升至67%。