我给你一套最实用、能直接复制跑通的淘宝商品详情 API（
taobao.item.get）日常调用示例 + 完整参数参考，你开发时直接套用即可。一、接口基础信息
接口名：
taobao.item.get地址：
https://eco.taobao.com/router/rest请求方式：
POST版本：
v=2.0格式：
format=json
二、日常调用完整参数（最常用版）
1. 公共参数（必传）
plaintext
method = taobao.item.get app_key = 你的AppKey timestamp = 2026-03-20 15:30:00 format = json v = 2.0 sign = 自动生成的SHA256签名 sign_method = hmac-sha256 （部分环境可不传）
2. 业务参数（必传）
plaintext
num_iid = 689123456789 # 商品ID fields = num_iid,title,price,pic_url,sku,props_name,detail_url,sold_quantity,volume
这是日常开发最常用的 fields，不多不少，稳定、速度快、权限好通过。
三、真实可运行调用示例（Python）
python
运行
import requestsimport hashlibfrom datetime import datetimedef sign_api(params, app_secret):
# 参数按字母排序
sorted_params = sorted(params.items())
# 拼接
raw = ''.join(f"{k}{v}" for k, v in sorted_params)
raw = app_secret + raw + app_secret # 标准TOP签名
# SHA256加密并大写
return hashlib.sha256(raw.encode()).hexdigest().upper()def taobao_item_get(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,pic_url,sku,props_name,detail_url,sold_quantity,volume"
}
params["sign"] = sign_api(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 = taobao_item_get(APP_KEY, APP_SECRET, NUM_IID)
print(result)四、日常最实用 fields 参数（直接复制）
1. 极简版（速度最快、最稳定）
plaintext
num_iid,title,price,pic_url,detail_url
2. 标准版（日常业务 90% 场景）
plaintext
num_iid,title,price,pic_url,sku,props_name,detail_url,sold_quantity,volume
3. 完整版（含商品详情、主图列表）
plaintext
num_iid,title,price,pic_url,item_imgs,sku,props_name,desc,detail_url,sold_quantity,volume
五、标准返回 JSON 示例（日常结构）
json
{
"item_get_response": {
"item": {
"num_iid": 689123456789,
"title": "2026新款春季连衣裙女显瘦气质长裙",
"price": "139.00",
"pic_url": "https://img.alicdn.com/imgextra/i1/xxx.jpg",
"detail_url": "https://item.taobao.com/item.htm?id=689123456789",
"sold_quantity": 1230,
"volume": 320,
"props_name": "品牌:XX;材质:聚酯纤维;风格:通勤;",
"sku": [
{
"sku_id": 123456789,
"properties_name": "颜色:黑色;尺码:L",
"price": "139.00",
"quantity": 135
}
]
},
"request_id": "2lsqk7v1m92o"
}}六、日常调用最佳实践（稳定不被限流）
QPS 控制在 1～2 次 / 秒
批量任务拆分成小批次，每批次间隔 1 秒
超时设置 3～5 秒
只请求需要的 fields，不要全量拉取
热点商品缓存 10 分钟～2 小时
遇到 429 限流：指数退避重试 1s→2s→4s
