一、为什么要拿商品视频
淘宝详情页里的 9～30 秒主图视频，比 5 张主图更能提高转化。做比价站、选品工具、社媒投放，都需要批量拿到这些视频。官方最稳妥的通道就是淘宝开放平台提供的 taobao.item.get 与 taobao.item_video 接口，前者顺带取，后者专门拿，返回字段里直接给出 MP4 地址、封面、时长、宽高，可立即下载或二次分发 。
二、账号与应用准备
打开 https://open.taobao.com，用企业支付宝或淘宝账号完成实名认证。
控制台 → 创建应用 → 类型选“网站应用”，填回调地址（可填 localhost 做测试）。
审核通过后拿到
App Key与App Secret；在“能力管理”里搜索并申请taobao.item_video权限，免费套餐每天 1 000 次，够小体量试用 。
三、OAuth2 拿令牌
淘宝接口全部走 OAuth2，示例（Python）：
import requests, json, time
APP_KEY = '你的AppKey'
APP_SECRET = '你的AppSecret'
def get_token():
url = 'https://oauth.taobao.com/token'
params = {
'grant_type': 'client_credentials',
'client_id': APP_KEY,
'client_secret': APP_SECRET,
'timestamp': time.strftime("%Y-%m-%d %H:%M:%S"),
'format': 'json'
}
r = requests.post(url, data=params)
return r.json()['access_token']如果是 Web 场景，需要引导用户跳转授权，换取 access_token。
四、调用核心接口
只想“顺带”拿视频——用
taobao.item.get请求示例（GET）：
https://eco.taobao.com/router/rest?method=taobao.item.get &app_key=你的AppKey &sign=签名按照淘宝文档生成 ×tamp=2025-12-15 14:23:00 &format=json &v=2.0 &access_token=上一步得到的token &fields=num_iid,title,video,videos &num_iid=123456789
返回 JSON 里出现 "video": {"url":"https://cloud.video.taobao.com/..."} 即是主图视频 。
想一次批量拿纯视频——用
taobao.item_video官方最新接口名item_video，必传参数只有num_iid和公共业务参数 ：
def get_item_video(token, num_iid):
url = 'https://eco.taobao.com/router/rest'
payload = {
'method': 'taobao.item_video',
'app_key': APP_KEY,
'access_token': token,
'timestamp': time.strftime("%Y-%m-%d %H:%M:%S"),
'format': 'json',
'v': '2.0',
'sign_method': 'md5',
'num_iid': num_iid,
'fields': 'url,duration,cover_url'
}
# 按文档把 payload 参与 sign 计算（略）
r = requests.post(url, data=payload)
return r.json()['item_video_response']['video']返回示例：
{
"url": "https://cloud.video.taobao.com/play/u/123/456/789.mp4",
"cover_url": "https://img.alicdn.com/imgextra/...jpg",
"duration": 15000
}五、下载与存储
拿到 url 后直接 HTTP GET 即可，淘宝没有做额外 Referer 防盗链，但建议加上 User-Agent: Mozilla/5.0 模拟浏览器。
批量场景可用异步协程或消息队列，每下载完一条回写本地库，记录 num_iid、video_path、duration，方便后续去重。
六、常见坑与合规提示
签名失败：淘宝要求所有参数 ASCII 升序后再 MD5，大小写敏感；用官方 SDK 可自动处理。
返回空视频：部分类目或老店商品没有主图视频，属于正常情况。
频率超限：免费档 1 000 次/天，超出会报
access_control_exceeded，需等 0 点重置或升级付费套餐。版权与合规：视频版权归卖家或淘宝所有，仅限内部数据分析、官方活动投放，禁止直接二次销售或公开分发，避免侵权 。
接口变更：淘宝每年会下线旧版接口，记得关注开放平台公告，及时迁移到新版
item_video。
七、完整最小可运行 DEMO（Python3）
pip install requests
import requests, time, hashlib, json, os
APP_KEY = '填你的'
APP_SECRET = '填你的'
NUM_IID = '123456789' # 测试商品
def sign(p):
"""淘宝 MD5 签名"""
p = {k: v for k, v in p.items() if v is not None}
src = APP_SECRET + ''.join([f'{k}{p[k]}' for k in sorted(p)]) + APP_SECRET
return hashlib.md5(src.encode()).hexdigest().upper()
def api(method, token, **kw):
url = 'https://eco.taobao.com/router/rest'
kw.update(method=method, app_key=APP_KEY, access_token=token,
timestamp=time.strftime("%Y-%m-%d %H:%M:%S"), format='json', v='2.0', sign_method='md5')
kw['sign'] = sign(kw)
r = requests.post(url, kw)
r.raise_for_status()
return r.json()
def download(mp4_url, filename):
with requests.get(mp4_url, stream=True, headers={'User-Agent': 'Mozilla/5.0'}) as r:
r.raise_for_status()
with open(filename, 'wb') as f:
for chunk in r.iter_content(chunk_size=8192):
f.write(chunk)
if __name__ == '__main__':
token = get_token() # 上文函数
ret = api('taobao.item_video', token, num_iid=NUM_IID, fields='url,cover_url,duration')
video = ret['item_video_response']['video']
print('获取成功：', video)
download(video['url'], f'{NUM_IID}.mp4')运行后目录下会出现 123456789.mp4，即为该商品的主图视频。
八、结语
通过淘宝官方接口拿商品视频，流程并不复杂：注册→拿 token→调 item_video→下载。只要注意签名规则、频率限制与版权边界，就能稳定、合规地把“别人家的视频”变成自己系统的数据资产。祝各位选品、投放、分析一路开挂！
