淘宝开放平台提供了多种API接口用于获取商品详情信息，主要通过 淘宝开放平台（Taobao Open Platform, TOP） 的 taobao.tbk.item.info.get（淘宝客商品详情）或 taobao.item.get（标准商品API）等接口实现。以下是关键信息及JSON返回示例：
1. 常用API接口
(1) 淘宝客商品详情接口（推荐）
- 接口名称:
taobao.tbk.item.info.get - 适用场景: 通过商品ID获取详情（需申请淘宝客权限）。
- 请求方式: HTTPS POST
- 关键参数:
num_iids: 商品ID（支持多个，用逗号分隔）platform: 链接形式（1=PC，2=无线，默认1）
(2) 标准商品API
- 接口名称:
taobao.item.get - 适用场景: 商家自用或需要更详细的商品信息（需权限）。
- 关键参数:
num_iid: 商品IDfields: 返回字段（如title,price,pic_url等）
2. JSON返回示例
以下是调用淘宝客接口后的简化JSON返回结构：
json { "tbk_item_info_get_response": { "results": { "n_tbk_item": [ { "num_iid": "650088223456", "title": "2023新款夏季连衣裙女法式复古裙", "pict_url": "https://img.alicdn.com/bao/xxx.jpg", "small_images": { "string": [ "https://img.alicdn.com/i1/xxx.jpg", "https://img.alicdn.com/i2/xxx.jpg" ] }, "reserve_price": "199.00", "zk_final_price": "129.00", "item_url": "https://item.taobao.com/item.htm?id=650088223456", "seller_id": "12345678", "shop_title": "某某旗舰店", "volume": "2000", "provcity": "浙江 杭州" } ] }, "request_id": "abc123xyz" } }
3. 关键字段说明
| 字段名 | 说明 |
num_iid |
商品ID |
title |
商品标题 |
pict_url |
主图URL |
small_images |
商品详情页图片列表 |
reserve_price |
原价 |
zk_final_price |
折后价（淘宝客价格） |
item_url |
商品落地页URL |
volume |
30天销量 |
provcity |
发货地 |
4. 开发注意事项
- 权限申请：
- 淘宝客接口需在淘宝联盟后台申请权限。
- 标准商品API可能需要企业资质或特定权限。
- API调用限制：
- 免费版有QPS限制（如每秒5次），企业版可申请提高配额。
- 签名与安全：
- 请求需包含
app_key、timestamp、sign等参数，签名算法见官方文档。
- 沙箱环境：
- 测试时可使用沙箱环境（需单独申请）。
5. 代码示例（Python）
python import requests url = "https://eco.taobao.com/router/rest" params = { "method": "taobao.tbk.item.info.get", "app_key": "你的AppKey", "timestamp": "2023-01-01 12:00:00", "format": "json", "v": "2.0", "sign_method": "md5", "num_iids": "650088223456", "platform": "2", "sign": "生成的签名" } response = requests.get(url, params=params) print(response.json())
