接口定位与核心能力

• 功能概述：专用于获取小红书笔记视频的详细元数据，支持电商场景（如竞品分析、内容优化、个性化推荐）。
• 核心数据字段：
  • 视频无水印直链、封面图URL、时长（秒）、标题、描述文本。
  • 标签体系（含多级分类）、互动数据（真实点赞/评论/收藏数）。
  • 作者信息（昵称、UID、城市）、发布时间。
• 典型场景：美妆品牌通过抓取竞品高赞视频标签优化自身脚本，家居品牌分析用户行为调整投放策略。

调用流程与参数

• 必要参数：
  • key &  secret：在小红书开放平台注册开发者账号并创建应用后获取的API密钥对。
  • num_iid：笔记唯一ID（从笔记URL末尾提取，如  https://xhslink.com/xxx?num_iid=649c46ab...）。
  • result_type：建议设为  jsonu 以获取中文友好格式。
• 请求示例（Python）：

  pythonimport requestsapi_url = "https://api-gw.onebound.cn/smallredbook/item_get_video"params = {    "key": "<your_api_key>",    "secret": "<your_api_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})")

• 返回数据结构示例：

  json{  "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"  }}

合规与限制

• 调用限制：
  • 默认QPS为10，企业用户可申请扩容至100+；建议添加随机延迟（0.5-2秒）模拟人工操作。
  • 笔记不存在时返回错误码2000，权限不足返回403，限流返回503。
• 数据使用边界：
  • 禁止爬取用户隐私（如IP、精确地理位置）；视频仅限内部分析，商用需作者授权。
  • 直链有效期通常7天，需及时下载或缓存。

替代方案对比

实战技巧

• 竞品监控：定时抓取前10竞品视频数据，分析标签组合与互动规律。
• 个性化推荐：基于用户画像（如“油皮护肤”+“学生党”）定向推送高潜力视频（点赞>1000）。
• 错误处理：通过错误码定位问题（如笔记删除、权限不足），结合重试机制与代理IP应对限流。

官方文档参考：阿里云开发者社区、小红书开放平台（需登录开发者账号查看完整权限说明）。建议优先使用官方API，确保合规性与数据稳定性；非官方方案需评估法律风险，避免大规模采集。