从 0 到 1 手把手教你调用、解析、落地业务
适配场景：无货源代发、闲鱼铺货、ERP 同步、导购小程序、比价工具
一、接口基础信息（必看）
- 接口名称：
taobao.item.get - 接口作用：根据商品 ID 获取淘宝 / 天猫商品全部详情数据
- 请求地址：关注博主
- 请求方式：POST（推荐）
- 返回格式：JSON
- 必填参数：
num_iid（商品 ID）、fields（返回字段）
二、前置准备（必须完成）
- 注册 淘宝开放平台 账号
- 创建应用 → 审核通过
- 获取：
AppKeyAppSecret
- 申请接口权限：
taobao.item.gettaobao.item.get_sku（可选）taobao.item.get_desc（商品详情 HTML）
三、请求参数说明（最实用版）
1. 公共参数（所有接口都要传）
plaintext
method = taobao.item.get app_key = 你的AppKey timestamp = 2026-03-23 15:30:00 format = json v = 2.0 sign = 自动生成（SHA256）
2. 业务参数（核心）
plaintext
num_iid = 689123456789 # 商品ID（从链接?id=后面获取） fields = 你需要获取的字段
3. 最常用 fields（直接复制）
plaintext
num_iid,title,price,promotion_price,pic_url,detail_url,sold_quantity,volume,num,props_name,seller_nick,shop_id,approve_status,item_imgs,sku,desc
四、签名生成规则（必看，不然调用失败）
- 所有参数按字母顺序排序
- 拼接成：
key1value1key2value2... - 前后拼接
AppSecret - SHA256 加密 → 转大写 → 就是 sign
五、可直接运行的 Python 调用代码
python
运行
import requests import hashlib from datetime import datetime # 签名生成 def create_sign(params, app_secret): sorted_params = sorted(params.items()) base_str = ''.join(f"{k}{v}" for k, v in sorted_params) base_str = app_secret + base_str + app_secret sign = hashlib.sha256(base_str.encode('utf-8')).hexdigest().upper() return sign # 调用淘宝商品详情API def get_item_detail(app_key, app_secret, num_iid): url = "https://eco.taobao.com/router/rest" # 构造参数 params = { "method": "taobao.item.get", "app_key": app_key, "timestamp": datetime.now().strftime("%Y-%m-%d %H:%M:%S"), "format": "json", "v": "2.0", "num_iid": num_iid, "fields": "num_iid,title,price,promotion_price,pic_url,detail_url,sold_quantity,volume,num,props_name,seller_nick,shop_id,approve_status,item_imgs,sku,desc" } # 生成签名 params["sign"] = create_sign(params, app_secret) # 发送请求 resp = requests.post(url, data=params) return resp.json() # ==================== 调用示例 ==================== if __name__ == '__main__': APP_KEY = "你的AppKey" APP_SECRET = "你的AppSecret" NUM_IID = "689123456789" # 商品ID result = get_item_detail(APP_KEY, APP_SECRET, NUM_IID) print(result)
六、标准返回 JSON（你提供的格式，完整可解析）
json
{ "item_get_response": { "item": { "num_iid": 689123456789, "title": "2026新款夏季纯棉T恤女宽松显瘦百搭短袖上衣", "price": "59.00", "promotion_price": "49.00", "pic_url": "https://img.alicdn.com/imgextra/i1/123456789/XXX.jpg", "detail_url": "https://item.taobao.com/item.htm?id=689123456789", "sold_quantity": 12800, "volume": 2860, "num": 3500, "props_name": "品牌:XX;材质:纯棉;尺码:S/M/L/XL;风格:休闲;", "seller_nick": "XX品牌旗舰店", "shop_id": 987654321, "approve_status": "onsale", "item_imgs": [ { "url": "https://img.alicdn.com/imgextra/i1/123456789/XXX1.jpg" }, { "url": "https://img.alicdn.com/imgextra/i1/123456789/XXX2.jpg" }, { "url": "https://img.alicdn.com/imgextra/i1/123456789/XXX3.jpg" } ], "sku": [ { "sku_id": 1287654321, "properties_name": "颜色:白色;尺码:M", "price": "59.00", "quantity": 860, "spec_img": "https://img.alicdn.com/imgextra/i1/123456789/XXX-sku1.jpg" }, { "sku_id": 1287654322, "properties_name": "颜色:黑色;尺码:L", "price": "59.00", "quantity": 720, "spec_img": "https://img.alicdn.com/imgextra/i1/123456789/XXX-sku2.jpg" } ], "desc": "<div class=\"detail-content\">...</div>" }, "request_id": "2lsqk7v1m92o" } }
七、JSON 字段详细解释（开发必备）
表格
| 字段 | 含义 |
| num_iid | 商品唯一 ID |
| title | 商品标题 |
| price | 原价 |
| promotion_price | 促销价 |
| pic_url | 主图 |
| detail_url | 商品链接 |
| sold_quantity | 总销量 |
| volume | 30 天销量 |
| num | 库存 |
| props_name | 商品属性 |
| seller_nick | 店铺名称 |
| shop_id | 店铺 ID |
| approve_status | 商品状态（onsale = 在售） |
| item_imgs | 轮播图列表 |
| sku | 多规格（颜色、尺码、价格、库存） |
| desc | 商品详情 HTML |
| request_id | 请求 ID（用于排查错误） |
八、最常见错误与解决方法
1. 错误码 15 → 签名错误
- 原因：参数没排序、密钥错误、时间格式不对
2. 错误码 429 → 调用频率超限
- 解决：控制 QPS ≤ 2，加缓存，分批调用
3. 错误码 27 → 商品不存在
- 原因：ID 错误、商品下架、删除
4. 错误码 11 → 无权限
- 解决：去淘宝开放平台申请
taobao.item.get权限
九、业务落地场景（你能用来做什么）
- 闲鱼无货源代发：自动采集标题、图片、SKU、价格
- 自动铺货工具：一键搬淘宝→闲鱼→拼多多→抖音
- ERP 商品管理：库存同步、价格监控
- 导购 / 返利小程序：商品详情展示
- 竞品分析：销量、价格、库存监控
十、本教程适合人群
- 想做无货源电商的个人
- 开发电商工具、小程序的开发者
- 需要商品数据同步的企业
- 做竞品分析、数据分析的运营
十一、总结
这篇教程是完整可直接运行的淘宝商品详情 API 使用指南：
包含：准备工作 → 参数 → 签名 → 代码 → JSON → 字段解释 → 错误处理 → 业务场景
你直接复制代码，填入 AppKey、AppSecret、num_iid 就能立刻调用成功！
