?
一、接口核心能力
smallredbook.item_get_video 是小紅書官方開放的筆記視頻詳情接口，具備以下核心能力：
- 視頻元數(shù)據(jù)獲取：支持提取無水印視頻直鏈、封面圖、時長等基礎(chǔ)信息。
- 內(nèi)容深度解析：精準(zhǔn)抓取筆記文本描述、標(biāo)簽體系（含多級分類）、互動數(shù)據(jù)（點(diǎn)贊/收藏/評論真實(shí)值）。
- 用戶畫像關(guān)聯(lián)：返回作者昵稱、城市、UID等基礎(chǔ)信息，支持構(gòu)建用戶行為圖譜。
- 電商場景賦能：覆蓋商品視頻展示、競品動態(tài)監(jiān)控、內(nèi)容營銷策略優(yōu)化等高頻需求。
典型應(yīng)用案例：某國際美妝品牌通過該接口抓取競品TOP100視頻，分析高互動內(nèi)容標(biāo)簽組合規(guī)律，優(yōu)化后自家產(chǎn)品視頻完播率提升38%，種草轉(zhuǎn)化率提高22%。
二、API調(diào)用全流程-參數(shù)領(lǐng)取
1. 必備參數(shù)
| 參數(shù)名 | 類型 | 說明 | 示例值 |
|---------|--------|--------------------------|----------------------------|
| 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", # 目標(biāo)筆記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}（點(diǎn)贊{likes}）")
else:
print(f"錯誤：{data['reason']}（代碼{data['error_code']}）")3. 核心返回字段解析
{
"item": {
"video": "http://sns-video-qc.xhscdn.com/stream/xxx.mp4", // 無水印視頻直鏈
"title": "變形金剛4經(jīng)典片段", // 筆記標(biāo)題
"desc": "柱子哥的魅力無人能擋", // 視頻描述
"tag_list": [{"name": "變形金剛", "type": "topic"}], // 內(nèi)容標(biāo)簽
"interact_info": {
"liked_count": "4100", // 真實(shí)點(diǎn)贊數(shù)（非顯示值）
"comment_count": "237"
},
"nick": "電影剪輯俠", // 作者昵稱
"time": "2023-06-28 22:41:47" // 發(fā)布時間
}
}三、電商場景實(shí)戰(zhàn)技巧
1. 商品視頻監(jiān)控（競品分析）
# 定時任務(wù)：每天抓取TOP10競品視頻數(shù)據(jù)
import schedule
import time
from datetime import datetime
def fetch_api(num_iid):
# 調(diào)用API邏輯（同上）
pass
def save_to_db(data):
# 數(shù)據(jù)庫存儲邏輯
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)數(shù)據(jù)價值：通過持續(xù)監(jiān)控競品視頻表現(xiàn)，某家居品牌發(fā)現(xiàn)"小戶型收納"類內(nèi)容在周末晚間互動率比工作日高45%，據(jù)此調(diào)整投放策略后ROI提升31%。
2. 個性化推薦（內(nèi)容分發(fā)）
- 標(biāo)簽匹配：將
tag_list與用戶畫像交叉分析（如"油皮護(hù)膚"+"學(xué)生黨"定向推送） - 互動優(yōu)先：優(yōu)先展示
liked_count>1000的高潛力視頻
成功案例：某母嬰品牌通過該接口篩選"輔食制作"標(biāo)簽視頻，結(jié)合用戶孕期階段推送，相關(guān)內(nèi)容轉(zhuǎn)化率提升27%，客單價提高19%。
四、合規(guī)與反爬注意事項(xiàng)
1. 調(diào)用限制
- 阿里云接口：默認(rèn)QPS=10，企業(yè)用戶可申請擴(kuò)容至100+
- 頻率控制：建議添加隨機(jī)延遲（0.5-2秒），模擬人工操作
2. 數(shù)據(jù)使用邊界
- 禁止爬取用戶隱私數(shù)據(jù)（如IP、精確地理位置）
- 視頻僅限內(nèi)部分析，商用需獲得作者授權(quán)
3. 錯誤碼處理
| 錯誤碼 | 含義 | 解決方案 |
|--------|-----------------------|------------------------------|
| 2000 | 筆記不存在（刪除/下架）| 檢查URL有效性 |
| 403 | API權(quán)限不足 | 核對key/secret有效性 |
| 503 | 限流 | 增加代理IP或延遲30秒后重試 |
五、替代方案對比（非API場景）
| 方法 | 優(yōu)點(diǎn) | 缺點(diǎn) | 適用場景 |
|------------|-----------------------|-------------------------------|------------------------|
| API直連 | 合法、穩(wěn)定、無水印 | 需申請資質(zhì)，限制QPS | 企業(yè)級長期監(jiān)控 |
| 小程序解析 | 無需編程，即用即走 | 依賴第三方工具，易失效 | 臨時下載少量視頻 |
| 瀏覽器抓包 | 繞過API限制 | 需逆向JS，反爬風(fēng)險高 | 技術(shù)驗(yàn)證/學(xué)術(shù)研究 |
| 錄屏法 | 無技術(shù)門檻 | 畫質(zhì)損失、含水印 | 個人非商用保存 |
推薦策略：優(yōu)先使用官方API（如smallredbook.item_get_video），合規(guī)性和穩(wěn)定性最佳；非官方方案需評估法律風(fēng)險，避免大規(guī)模采集。
六、常見問題解答
Q1：如何獲取筆記ID？
A：小紅書APP內(nèi)點(diǎn)擊視頻→右上角"..."→復(fù)制鏈接，URL末尾即為num_iid（如https://xhslink.com/xxx?num_iid=649c46ab...）。
Q2：返回的視頻鏈接有時效性嗎？
A：直鏈有效期通常為7天，建議獲取后立即下載或緩存。2023年Q3數(shù)據(jù)顯示，過期鏈接占比達(dá)12%，需特別注意。
Q3：能否批量獲取多個視頻？
A：支持循環(huán)調(diào)用，但需控制頻率（建議≤50次/分鐘），避免觸發(fā)風(fēng)控。某電商團(tuán)隊測試表明，超過80次/分鐘時被封禁概率提升至67%。
