小红书笔记视频详情接口解析与实战指南一、接口核心能力 smallredbook.item_get_video 是小

一、接口核心能力

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%。

小红书笔记视频详情接口解析与实战指南