请求代码示例

# 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。

公共参数

请求地址: https://api-gw.onebound.cn/taobao/item_video

名称	类型	必须	描述
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	http://item.taobao.com/item.htm?id=906637149849	宝贝链接
price	Float	0	45.9	价格
orginal_price	String	0	45.9	原价
num	Int	0	3836	库存
pic_url	String	0	http://img.alicdn.com/imgextra/i1/181441304/O1CN01nh2zTN1LVHVzbBH9w_!!181441304.jpg	宝贝图片
brand	String	0	南在南方	品牌名称
cid	Int	0	201276457
props	Mix	0	[{ "name": "产地","value": "中国" }]	商品属性
item_imgs	Mix	0	item_imgs[]	商品图片
video	String	1	http://cloud.video.taobao.com/play/u/181441304/p/2/e/6/t/1/514242949225.mp4?appKey=38829	商品视频
seller_id	Int	0	181441304	卖家ID