一：公共参数
请求地址: taobao/item_get_pro
跨境电商平台接口提供商 数据采集公司 数据接口定制服务 企业级数据服务商
接口作用：返回商品全量详情，包含基础信息、价格、库存、SKU、图片、促销、物流、售后、店铺等完整数据，比普通版更全。
返回格式：JSON（默认）/XML
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| 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版本 |
二、返回总结构（JSON）
{
"item": {
"num_iid": "520813250866",
"title": "三刃木折叠刀过安检创意迷你钥匙扣钥匙刀军刀随身多功能小刀包邮",
"price": "25.8",
"orginal_price": "25.80",
"nick": "欢乐购客栈",
"num": 16840,
"detail_url": "https://item.taobao.com/item.htm?id=520813250866",
"pic_url": "//img.alicdn.com/imgextra/i4/2596264565/O1CN01mbmuAB1jaogMUWhv8_!!2596264565.jpg",
"brand": "三刃木",
"brandId": "4036703",
"rootCatId": 50013886,
"cid": 50014822,
"desc": "<p>小店所有产品都支持刻字...</p>",
"item_imgs": [
{"url": "//img.alicdn.com/imgextra/i4/2596264565/O1CN01mbmuAB1jaogMUWhv8_!!2596264565.jpg"}
],
"props_name": "1627207:1347647754:颜色分类:长方形带开瓶器+送工具刀卡+链子;...",
"prop_imgs": {
"prop_img": [
{"properties": "1627207:1347647754", "url": "//img.alicdn.com/..."}
]
}
}
}三、与普通版区别
高级版（item_get_pro）：含SKU 全量、规格图、促销明细、售后规则、店铺评分等，数据完整。
普通版（item_get）：仅返回基础标题、主图、价格、销量，无 SKU 明细、无促销、无售后。
四、Python调用示例
import requests
import time
import hashlib
APP_KEY = "你的App Key"
APP_SECRET = "你的App Secret"
API_URL = "https://o0b.cn/ibrad"
def generate_sign(params):
"""生成淘宝API签名"""
sorted_params = sorted(params.items())
sign_str = "".join(f"{k}{v}" for k, v in sorted_params)
sign_str = APP_SECRET + sign_str + APP_SECRET
return hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper()
def get_item_detail(item_id, fields=None):
"""
获取淘宝商品详情
:param item_id: 商品数字ID
:param fields: 指定返回字段，None返回默认字段
"""
params = {
"method": "taobao.item.get",
"app_key": APP_KEY,
"timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
"format": "json",
"v": "2.0",
"sign_method": "md5",
"num_iid": item_id
}
if fields:
params["fields"] = fields
params["sign"] = generate_sign(params)
try:
response = requests.get(API_URL, params=params, timeout=10)
result = response.json()
if "error_response" in result:
error = result["error_response"]
print(f"调用失败 [{error['code']}]: {error['msg']}")
return None
return result["item_get_response"]["item"]
except Exception as e:
print(f"请求异常: {str(e)}")
return None
# 使用示例
if __name__ == "__main__":
# 基础字段
item = get_item_detail("652874751412")
# 指定完整字段
full_fields = "num_iid,title,price,original_price,nick,pic_url,item_imgs,props_name,skus,desc,detail_url,comment_count,sales"
item_full = get_item_detail("652874751412", full_fields)
if item_full:
print(f"商品: {item_full['title']}")
print(f"价格: ¥{item_full['price']}")
print(f"库存: {item_full.get('num', 'N/A')}件")
print(f"销量: {item_full.get('sales', 'N/A')}件")五、常见问题
total_sold=0：商品暂无销量，新上架或未成交。
zk_final_price 为空：无优惠券 / 无活动，取 price 作为到手价。
sku_list 为空：商品无多规格，为单品。
