小红书视频比较详情API在线调用数据帮助你更快解决数据抓取

小红书视频比较详情 API 可快速批量获取多视频核心数据，用于竞品分析、内容对比与数据监控，以下是完整调用与使用指南。

一、核心 API 能力（视频详情 / 对比）

1. 主流可用接口（官方 / 第三方）

官方 v4 笔记详情接口（推荐）

地址：https://api.xiaohongshu.com/v4/notes/{note_id}

支持：视频直链、封面、时长、完播率、互动数据（点赞 / 收藏 / 评论 / 分享）、作者信息、标签、发布时间

权限：需开放平台认证、应用创建、权限申请

第三方 item_get_video（快速接入）

地址：https://api-gw.onebound.cn/smallredbook/item_get_video

支持：无水印视频、封面、互动、标题、标签、作者信息

优势：无需官方审核，即用即调，适合快速测试与批量抓取

2. 视频对比核心数据字段

表格

对比维度	关键字段	说明
基础信息	note_id、title、desc、create_time、author_id、author_name	视频唯一标识、标题、简介、发布时间、作者信息
视频信息	video_url、cover_url、duration、resolution	无水印直链、封面、时长、分辨率
互动数据	like_count、collect_count、comment_count、share_count、play_count、finish_rate	点赞、收藏、评论、分享、播放、完播率
内容标签	tags、topics、category	标签、话题、分类

二、在线调用全流程（以第三方 item_get_video 为例）

1. 准备工作

注册第三方平台账号，获取key与secret

提取目标视频note_id（URL 最后一段，如649c46ab000000002702ad36）

2. 接口参数（必填）

表格

参数	类型	说明	示例
key	String	API 密钥	your_api_key
secret	String	密钥	your_api_secret
num_iid	String	笔记 ID	649c46ab000000002702ad36
result_type	String	返回格式	jsonu

3. Python 调用示例（单视频）

python

运行

import requests

# 接口地址
api_url = "https://api-gw.onebound.cn/smallredbook/item_get_video"
# 请求参数
params = {
    "key": "your_api_key",
    "secret": "your_api_secret",
    "num_iid": "649c46ab000000002702ad36",
    "result_type": "jsonu"
}
# 发送请求
response = requests.get(api_url, params=params)
data = response.json()

# 解析数据
if data.get("error_code") == "0000":
    item = data["item"]
    print("标题:", item["title"])
    print("视频链接:", item["video"])
    print("点赞数:", item["like_count"])
    print("评论数:", item["comment_count"])
else:
    print("调用失败:", data.get("error_msg"))

4. 多视频对比调用（批量）

python

运行

import pandas as pd

# 待对比视频ID列表
note_ids = ["649c46ab000000002702ad36", "650d12ef000000001805bc78", "651e34gh000000002906cd89"]
compare_data = []

for note_id in note_ids:
    params["num_iid"] = note_id
    response = requests.get(api_url, params=params)
    data = response.json()
    if data.get("error_code") == "0000":
        item = data["item"]
        compare_data.append({
            "note_id": note_id,
            "title": item["title"],
            "like_count": item["like_count"],
            "collect_count": item["collect_count"],
            "comment_count": item["comment_count"],
            "play_count": item.get("play_count", 0),
            "duration": item["duration"]
        })

# 生成对比表格
df = pd.DataFrame(compare_data)
print(df)
# 保存为CSV
df.to_csv("xiaohongshu_video_compare.csv", index=False, encoding="utf-8-sig")

三、调用限制与合规

1. 频率限制

第三方：默认 100 次 / 分钟，付费可提升

官方 v4：默认 200 次 / 分钟，专业版可申请 500 次 / 分钟

2. 合规要点

仅用于合规场景（数据分析、内容研究），禁止商用侵权

遵守小红书《开放平台服务协议》，不恶意爬取、不干扰平台

数据仅用于内部分析，不公开传播用户隐私信息

四、应用场景（视频对比价值）

竞品分析：批量对比同类视频互动数据，找出高转化内容规律

内容优化：对比自身视频数据，优化标题、标签、时长、封面

数据监控：实时追踪热点视频数据变化，快速响应市场

电商选品：分析商品视频种草效果，辅助选品与推广决策

五、常见问题

获取不到视频直链：检查note_id是否正确，部分视频需权限

调用频率超限：降低请求速度，或升级付费套餐

数据不完整：部分字段需高级权限，或接口版本差异

审核编辑 黄宇