以下是关于淘宝商品详情API接口的详细说明及稳定版JSON数据示例参考:
一、商品详情API接口调用流程
- 注册与认证
- 注册开发者账号并完成实名认证。
- 创建应用,获取
App Key
和App Secret
(调用接口的身份凭证),需妥善保管。
- 权限申请
- 在应用管理页面申请
taobao.item.get
(商品详情接口)权限,部分高级接口需提交业务场景说明,审核通过后方可使用。
- 在应用管理页面申请
- 构造请求
- 请求地址:
- 请求参数(以获取单个商品详情为例):
params = {
"method": "taobao.item.get", # 接口名称
"app_key": "your_app_key", # 替换为你的App Key
"num_iid": "123456789", # 商品ID(必填)
"fields": "num_iid,title,price,pic_url,skus", # 指定返回字段
"timestamp": "2025-03-31 12:00:00", # 请求时间戳(需动态生成)
"format": "json", # 返回格式
"v": "2.0", # API版本
"sign_method": "md5", # 签名算法
"sign": "生成的签名" # 需按规则生成(见下文)
}
- 签名生成规则:
将参数按字典序排序后拼接,加上App Secret
,进行MD5加密并转为大写。例如:def generate_sign(params, app_secret):
sorted_params = sorted(params.items())
sign_str = "".join([f"{k}{v}" for k, v in sorted_params if k != "sign"])
sign_str += app_secret
return hashlib.md5(sign_str.encode()).hexdigest().upper()
- 发送请求与接收响应
- 使用HTTP库(如Python的
requests
)发送GET请求,接收JSON格式的响应数据。
- 使用HTTP库(如Python的
二、稳定版JSON数据示例
{ | |
"taobao_response": { | |
"code": 200, // 返回码(200表示成功) | |
"msg": "success", // 返回信息 | |
"request_id": "123e4567-e89b-12d3-a456-426614174001", // 唯一请求标识符 | |
"item_get_response": { | |
"item": { | |
"num_iid": "123456789", // 商品ID | |
"title": "夏季新款男士短袖T恤圆领纯棉上衣", // 商品标题 | |
"price": "59.90", // 当前售价(单位:元) | |
"original_price": "99.00", // 原价(如无促销则为空) | |
"num": 100, // 库存数量(部分接口可能不返回) | |
"detail_url": "https://item.taobao.com/item.htm?id=123456789", // 详情页链接 | |
"pic_url": [ // 商品主图URL列表 | |
"//img.alicdn.com/imgextra/i1/123456789/O1CN01abcd123456789_1.jpg", | |
"//img.alicdn.com/imgextra/i1/123456789/O1CN01abcd123456789_2.jpg" | |
], | |
"desc": "<div>商品描述内容(可能包含HTML标签)...</div>", // 商品描述 | |
"props": [ // 商品属性列表 | |
{"name": "品牌", "value": "某品牌"}, | |
{"name": "颜色", "value": "白色"}, | |
{"name": "尺码", "value": "M/L/XL"} | |
], | |
"skus": { // SKU信息(不同规格的价格、库存等) | |
"sku": [ | |
{ | |
"sku_id": "sku_1", | |
"price": "59.90", | |
"quantity": 50, // 库存 | |
"properties": "颜色:白色;尺码:M" | |
}, | |
{ | |
"sku_id": "sku_2", | |
"price": "59.90", | |
"quantity": 30, | |
"properties": "颜色:黑色;尺码:L" | |
} | |
] | |
}, | |
"seller_info": { // 卖家信息 | |
"nick": "店铺名称", // 卖家昵称 | |
"shop_id": "987654321", // 店铺ID | |
"shop_name": "某品牌旗舰店" | |
}, | |
"coupon_info": { // 优惠券信息(如有) | |
"amount": "10.00", // 优惠券金额 | |
"start_time": "2025-03-31 00:00:00", // 生效时间 | |
"end_time": "2025-04-30 23:59:59" // 失效时间 | |
}, | |
"promotions": [ // 促销活动(如有) | |
{ | |
"type": "满减", | |
"desc": "满100元减20元" | |
} | |
] | |
} | |
} | |
} | |
} |
三、关键字段说明
字段名 | 类型 | 描述 |
---|---|---|
num_iid | String | 商品唯一ID |
title | String | 商品标题 |
price | String | 当前售价(单位:元) |
original_price | String | 原价(如无促销则为空) |
detail_url | String | 商品详情页链接 |
pic_url | Array | 商品主图URL列表 |
skus | Object | SKU信息(不同规格的价格、库存、属性等) |
props | Array | 商品属性列表(如品牌、颜色、尺码) |
seller_info | Object | 卖家信息(昵称、店铺ID、店铺名称) |
coupon_info | Object | 优惠券信息(金额、生效/失效时间) |
promotions | Array | 促销活动列表(类型、描述) |
如有进一步需求(如批量获取商品详情、获取评论数据等),可参考开放平台的其他API接口