用 API 把淘宝商品介绍页视频“搬”回来——从注册到落盘全流程

一、为什么要拿商品视频

淘宝详情页里的 9～30 秒主图视频，比 5 张主图更能提高转化。做比价站、选品工具、社媒投放，都需要批量拿到这些视频。官方最稳妥的通道就是淘宝开放平台提供的 ​​taobao.item.get​​​ 与 ​​taobao.item_video​​ 接口，前者顺带取，后者专门拿，返回字段里直接给出 MP4 地址、封面、时长、宽高，可立即下载或二次分发 。

二、账号与应用准备

1. 打开 ​​https://open.taobao.com​​，用企业支付宝或淘宝账号完成实名认证。
2. 控制台 → 创建应用 → 类型选“网站应用”，填回调地址（可填 localhost 做测试）。
3. 审核通过后拿到 ​​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​​。

四、调用核心接口

1. 只想“顺带”拿视频——用 ​​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/..."}​​ 即是主图视频 。

1. 想一次批量拿纯视频——用 ​​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​​，方便后续去重。

六、常见坑与合规提示

1. 签名失败：淘宝要求所有参数 ASCII 升序后再 MD5，大小写敏感；用官方 SDK 可自动处理。
2. 返回空视频：部分类目或老店商品没有主图视频，属于正常情况。
3. 频率超限：免费档 1 000 次/天，超出会报 ​​access_control_exceeded​​，需等 0 点重置或升级付费套餐。
4. 版权与合规：视频版权归卖家或淘宝所有，仅限内部数据分析、官方活动投放，禁止直接二次销售或公开分发，避免侵权 。
5. 接口变更：淘宝每年会下线旧版接口，记得关注开放平台公告，及时迁移到新版 ​​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​​→下载。只要注意签名规则、频率限制与版权边界，就能稳定、合规地把“别人家的视频”变成自己系统的数据资产。祝各位选品、投放、分析一路开挂！