获取淘宝商品视频API接口解析：通过商品链接url获取商品视频item_video

​

 请求代码示例

# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 请求示例 url 默认请求参数已经做URL编码
url = "https://api-gw.onebound.cn/taobao/item_video/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=906637149849"
headers = {
    "Accept-Encoding": "gzip",
    "Connection": "close"
}
if __name__ == "__main__":
    r = requests.get(url, headers=headers)
    json_obj = r.json()
    print(json_obj)

响应示例

taobao.item_video是用来获取商品视频的API，商品详情页一般都会有商品视频，通过API可以实现自动化批量获取商品的视频。

淘宝商品视频 API（taobao.item_video）是API平台提供的接口，用于获取商品详情页中的主图视频或其他关联视频。该接口支持通过商品 ID（num_iid）直接请求视频资源，返回包含视频 URL、封面图、时长等信息的结构化数据。开发者需在淘宝开放平台注册并创建应用，获取 AppKey 和 AppSecret 进行签名认证后调用，支持 HTTP/HTTPS 请求，响应格式为 JSON 或 XML。

公共参数

请求地址: api-gw.onebound.cn/taobao/item…

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

请求参数

请求参数：num_iid=906637149849

参数说明：num_iid:淘宝商品ID

响应参数

Version: Date:2025-06-17

名称	类型	必须	示例值	描述
item	item[]	1		宝贝视频数据【仅保障视频参数】
num_iid	Bigint	1	906637149849	宝贝ID
title	String	0	【爆款推荐】巨好看！软底人字拖
detail_url	String	1	item.taobao.com/item.htm?id…	宝贝链接
price	Float	0	45.9	价格
orginal_price	String	0	45.9	原价
num	Int	0	3836	库存
pic_url	String	0	img.alicdn.com/imgextra/i1…	宝贝图片
brand	String	0	南在南方	品牌名称
cid	Int	0	201276457
props	Mix	0	[{ "name": "产地","value": "中国" }]	商品属性
item_imgs	Mix	0	item_imgs[]	商品图片
video	String	1	cloud.video.taobao.com/play/u/1814…	商品视频
seller_id	Int	0	181441304	卖家ID

​