小紅書視頻比較詳情 API 可快速批量獲取多視頻核心數(shù)據(jù)，用于競品分析、內(nèi)容對比與數(shù)據(jù)監(jiān)控，以下是完整調(diào)用與使用指南。

一、核心 API 能力（視頻詳情 / 對比）

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

官方 v4 筆記詳情接口（推薦）

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

支持：視頻直鏈、封面、時長、完播率、互動數(shù)據(jù)（點(diǎn)贊 / 收藏 / 評論 / 分享）、作者信息、標(biāo)簽、發(fā)布時間

權(quán)限：需開放平臺認(rèn)證、應(yīng)用創(chuàng)建、權(quán)限申請

第三方 item_get_video（快速接入）

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

支持：無水印視頻、封面、互動、標(biāo)題、標(biāo)簽、作者信息

優(yōu)勢：無需官方審核，即用即調(diào)，適合快速測試與批量抓取

2. 視頻對比核心數(shù)據(jù)字段

表格

二、在線調(diào)用全流程（以第三方 item_get_video 為例）

1. 準(zhǔn)備工作

注冊第三方平臺賬號，獲取key與secret

提取目標(biāo)視頻note_id（URL 最后一段，如649c46ab000000002702ad36）

2. 接口參數(shù)（必填）

表格

3. Python 調(diào)用示例（單視頻）

python

運(yùn)行

import requests

# 接口地址
api_url = "https://api-gw.onebound.cn/smallredbook/item_get_video"
# 請求參數(shù)
params = {
    "key": "your_api_key",
    "secret": "your_api_secret",
    "num_iid": "649c46ab000000002702ad36",
    "result_type": "jsonu"
}
# 發(fā)送請求
response = requests.get(api_url, params=params)
data = response.json()

# 解析數(shù)據(jù)
if data.get("error_code") == "0000":
    item = data["item"]
    print("標(biāo)題:", item["title"])
    print("視頻鏈接:", item["video"])
    print("點(diǎn)贊數(shù):", item["like_count"])
    print("評論數(shù):", item["comment_count"])
else:
    print("調(diào)用失敗:", data.get("error_msg"))

4. 多視頻對比調(diào)用（批量）

python

運(yùn)行

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")

三、調(diào)用限制與合規(guī)

1. 頻率限制

第三方：默認(rèn) 100 次 / 分鐘，付費(fèi)可提升

官方 v4：默認(rèn) 200 次 / 分鐘，專業(yè)版可申請 500 次 / 分鐘

2. 合規(guī)要點(diǎn)

僅用于合規(guī)場景（數(shù)據(jù)分析、內(nèi)容研究），禁止商用侵權(quán)

遵守小紅書《開放平臺服務(wù)協(xié)議》，不惡意爬取、不干擾平臺

數(shù)據(jù)僅用于內(nèi)部分析，不公開傳播用戶隱私信息

四、應(yīng)用場景（視頻對比價值）

競品分析：批量對比同類視頻互動數(shù)據(jù)，找出高轉(zhuǎn)化內(nèi)容規(guī)律

內(nèi)容優(yōu)化：對比自身視頻數(shù)據(jù)，優(yōu)化標(biāo)題、標(biāo)簽、時長、封面

數(shù)據(jù)監(jiān)控：實(shí)時追蹤熱點(diǎn)視頻數(shù)據(jù)變化，快速響應(yīng)市場

電商選品：分析商品視頻種草效果，輔助選品與推廣決策

五、常見問題

獲取不到視頻直鏈：檢查note_id是否正確，部分視頻需權(quán)限

調(diào)用頻率超限：降低請求速度，或升級付費(fèi)套餐

數(shù)據(jù)不完整：部分字段需高級權(quán)限，或接口版本差異

審核編輯 黃宇