小红书笔记视频详情接口深度解析：smallredbook.item_get_video_pro

GET https://api-gw.onebound.cn/smallredbook/item_get_video_pro

import requestsimport jsonimport timedef get_video_pro_detail(api_key, api_secret, num_iid, xsec_token=None):
    """
    调用 item_get_video_pro 获取小红书笔记视频详情
    """
    api_url = "https://api-gw.onebound.cn/smallredbook/item_get_video_pro"
    
    params = {
        "key": api_key,
        "secret": api_secret,
        "num_iid": num_iid,
        "result_type": "jsonu",  # 中文友好格式
        "fields": "title,desc,video,cover,duration,tag_list,interact_info,user_info,time"
    }
    
    if xsec_token:
        params["xsec_token"] = xsec_token
    
    headers = {
        "Accept-Encoding": "gzip",
        "Connection": "close",
        "User-Agent": "Mozilla/5.0 (compatible; DataBot/1.0)"
    }
    
    try:
        # 添加随机延迟，模拟人工操作
        time.sleep(0.5)
        
        response = requests.get(api_url, params=params, headers=headers, timeout=30)
        response.raise_for_status()
        
        data = response.json()
        
        if data.get("error_code") == "0000":
            return data.get("item")
        else:
            print(f"API 错误: {data.get('reason')} (代码: {data.get('error_code')})")
            return None
            
    except requests.exceptions.RequestException as e:
        print(f"请求异常: {e}")
        return None# ===== 使用示例 =====if __name__ == "__main__":
    API_KEY = "YOUR_API_KEY"
    API_SECRET = "YOUR_API_SECRET"
    NOTE_ID = "649c46ab000000002702ad36"
    
    result = get_video_pro_detail(API_KEY, API_SECRET, NOTE_ID)
    
    if result:
        print("=" * 50)
        print(f"📌 标题: {result.get('title')}")
        print(f"📝 描述: {result.get('desc', '无描述')[:100]}...")
        print(f"🎬 视频链接: {result.get('video')}")
        print(f"🖼️ 封面图: {result.get('cover')}")
        print(f"⏱️ 时长: {result.get('duration', '未知')} 秒")
        print(f"👤 作者: {result.get('nick')}")
        
        interact = result.get("interact_info", {})
        print(f"❤️ 点赞: {interact.get('liked_count', 0)}")
        print(f"💬 评论: {interact.get('comment_count', 0)}")
        print(f"⭐ 收藏: {interact.get('collected_count', 0)}")
        
        tags = result.get("tag_list", [])
        print(f"🏷️ 标签: {', '.join([t.get('name') for t in tags[:5]])}")

{
  "item": {
    "title": "夏日清透底妆教程 | 油皮亲妈",
    "desc": "今天分享一个适合油皮的清透底妆方法...",
    "video": "http://sns-video-qc.xhscdn.com/stream/xxx/1080p.mp4",
    "video_sd": "http://sns-video-qc.xhscdn.com/stream/xxx/480p.mp4",
    "cover": "http://sns-img-qc.xhscdn.com/xxx.jpg",
    "cover_frames": [
      "http://sns-img-qc.xhscdn.com/frame1.jpg",
      "http://sns-img-qc.xhscdn.com/frame2.jpg"
    ],
    "duration": 186.5,
    "width": 1080,
    "height": 1920,
    "tag_list": [
      {"name": "美妆", "type": "category", "level": 1},
      {"name": "底妆", "type": "category", "level": 2},
      {"name": "油皮护肤", "type": "topic"},
      {"name": "学生党", "type": "user_group"}
    ],
    "interact_info": {
      "liked_count": "12580",
      "comment_count": "342",
      "collected_count": "1890",
      "share_count": "567"
    },
    "user_info": {
      "nick": "美妆小达人",
      "uid": "5f8a2b1c0000000001000000",
      "city": "上海",
      "follower_count": "128000"
    },
    "time": "2025-06-15 14:30:00",
    "last_update": "2025-06-16 09:00:00"
  }}

def monitor_competitor_videos(brand_keywords, top_n=100):
    """
    监控竞品高互动视频，分析标签组合规律
    """
    # 某美妆品牌实战：抓取竞品 TOP100 视频
    # 分析高互动内容标签组合，优化自家视频脚本
    # 实测效果：完播率提升 38%，种草转化率提高 22% [^6^][^7^]
    pass

质量分 = (点赞数 × 1 + 收藏数 × 2 + 评论数 × 3) / 视频时长(秒)