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

一、为什么要拿商品视频

淘宝详情页里的 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→下载。只要注意签名规则、频率限制与版权边界，就能稳定、合规地把“别人家的视频”变成自己系统的数据资产。祝各位选品、投放、分析一路开挂！