获取淘宝商品详情API响应数据解析参数说明（价格、商品标题、商品url，主图、详情等）
获取淘宝商品详情API是常用的电商平台接口，应用场景主要包括商家店铺商品管理、第三方电商运营工具开发、商品比价与导购平台搭建、电商市场数据分析调研、商品库存与价格实时监控、跨平台商品信息同步这几类。
下面是一个调用实例，响应数据如下：
"item": { "num_iid": "652874751412", "title": "奶油风布艺沙发现代简约轻奢小户型客厅直排可拆洗沙发原木可定制", "desc_short": "", "price": "480.00", "total_price": 0, "suggestive_price": 0, "orginal_price": "480.00", "nick": "佑安居", "num": 1513, "min_num": 0, "detail_url": "https://item.taobao.com/item.htm?id=652874751412", "pic_url": "//img.alicdn.com/imgextra/i4/2568161054/O1CN01aYBriY1Jem9UDtt9e_!!2568161054.jpg", "brand": "#0 工厂", "brandId": null, "rootCatId": null, "cid": "50020632", "crumbs": [], "created_time": "", "modified_time": "", "delist_time": "", "desc": "<div style=\"width: 750.0px;height: 10575.0px;overflow: hidden;\">\n<div style=\"width: 750.0px;height: 10575.0px;overflow: hidden;\"><img src=\"https://img.alicdn.com/imgextra/i3/2568161054/O1CN01LFmSOU1Jem9QOjMPb_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i3/2568161054/O1CN014vyOOT1Jem9DpHz3Y_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i1/2568161054/O1CN01B3PpsA1Jem9N8V7uf_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i2/2568161054/O1CN015JbyeY1Jem9MZshUt_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i1/2568161054/O1CN01HXSoxx1Jem9RvgzHN_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i3/2568161054/O1CN01IEultA1Jem9MdEx8R_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i3/2568161054/O1CN0176K98O1Jem9QOjE69_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i4/2568161054/O1CN013Pxp1O1Jem9RvgeTv_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i1/2568161054/O1CN01SfyZ8M1Jem9QOi1Gx_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i4/2568161054/O1CN01bb1POa1Jem9Sdgve2_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i3/2568161054/O1CN018Eo9dV1Jem9KV0y79_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i1/2568161054/O1CN01vuEofr1Jem9Nzy9xY_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i4/2568161054/O1CN01qw9sAi1Jem8wkNKpy_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i1/2568161054/O1CN01HeFhFw1Jem8rLnjBY_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i2/2568161054/O1CN01SNgjoi1Jem9QOil15_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i2/2568161054/O1CN01RXf3RA1Jem9DpHVwj_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i4/2568161054/O1CN01gZmZjt1Jem9ISThgm_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i2/2568161054/O1CN01YL0FHM1Jem9PQTjX9_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i4/2568161054/O1CN01UhsEhZ1Jem8yvJIhZ_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"></div>\n</div>", "desc_img": [ "https://img.alicdn.com/imgextra/i3/2568161054/O1CN01LFmSOU1Jem9QOjMPb_!!2568161054.jpg", "https://img.alicdn.com/imgextra/i3/2568161054/O1CN014vyOOT1Jem9DpHz3Y_!!2568161054.jpg", "https://img.alicdn.com/imgextra/i1/2568161054/O1CN01B3PpsA1Jem9N8V7uf_!!2568161054.jpg", "https://img.alicdn.com/imgextra/i2/2568161054/O1CN015JbyeY1Jem9MZshUt_!!2568161054.jpg", "https://img.alicdn.com/imgextra/i1/2568161054/O1CN01HXSoxx1Jem9RvgzHN_!!2568161054.jpg", "https://img.alicdn.com/imgextra/i3/2568161054/O1CN01IEultA1Jem9MdEx8R_!!2568161054.jpg", "https://img.alicdn.com/imgextra/i3/2568161054/O1CN0176K98O1Jem9QOjE69_!!2568161054.jpg", "https://img.alicdn.com/imgextra/i4/2568161054/O1CN013Pxp1O1Jem9RvgeTv_!!2568161054.jpg", "https://img.alicdn.com/imgextra/i1/2568161054/O1CN01SfyZ8M1Jem9QOi1Gx_!!2568161054.jpg", "https://img.alicdn.com/imgextra/i4/2568161054/O1CN01bb1POa1Jem9Sdgve2_!!2568161054.jpg", "https://img.alicdn.com/imgextra/i3/2568161054/O1CN018Eo9dV1Jem9KV0y79_!!2568161054.jpg", "https://img.alicdn.com/imgextra/i1/2568161054/O1CN01vuEofr1Jem9Nzy9xY_!!2568161054.jpg", "https://img.alicdn.com/imgextra/i4/2568161054/O1CN01qw9sAi1Jem8wkNKpy_!!2568161054.jpg", "https://img.alicdn.com/imgextra/i1/2568161054/O1CN01HeFhFw1Jem8rLnjBY_!!2568161054.jpg", "https://img.alicdn.com/imgextra/i2/2568161054/O1CN01SNgjoi1Jem9QOil15_!!2568161054.jpg", "https://img.alicdn.com/imgextra/i2/2568161054/O1CN01RXf3RA1Jem9DpHVwj_!!2568161054.jpg", "https://img.alicdn.com/imgextra/i4/2568161054/O1CN01gZmZjt1Jem9ISThgm_!!2568161054.jpg", "https://img.alicdn.com/imgextra/i2/2568161054/O1CN01YL0FHM1Jem9PQTjX9_!!2568161054.jpg", "https://img.alicdn.com/imgextra/i4/2568161054/O1CN01UhsEhZ1Jem8yvJIhZ_!!2568161054.jpg"
], "item_imgs": [
{ "url": "//img.alicdn.com/imgextra/i4/2568161054/O1CN01aYBriY1Jem9UDtt9e_!!2568161054.jpg"
},
{ "url": "//img.alicdn.com/imgextra/i3/2568161054/O1CN01kjOfNb1Jem9DmWn8Y_!!2568161054.jpg"
},
{ "url": "//img.alicdn.com/imgextra/i1/2568161054/O1CN01HoB9ha1Jem9DmWn8r_!!2568161054.jpg"
},
{ "url": "//img.alicdn.com/imgextra/i4/2568161054/O1CN011PjP2P1Jem9MXEUFT_!!2568161054.jpg"
},
{ "url": "//img.alicdn.com/imgextra/i3/2568161054/O1CN01KUfBFL1Jem9KTTMn1_!!2568161054.jpg"
}
], "item_weight": "", "item_size": "", "location": "江苏南通", "post_fee": null, "express_fee": null, "ems_fee": "", "shipping_to": "", "has_discount": "", "video": { "url": ""
}, "is_virtual": "", "sample_id": "", "is_promotion": "", "props_name": "31480:14306495906:几人坐:脚踏90*60*48cm;31480:14306495907:几人坐:双人165*95*67cm;31480:14306495908:几人坐:三人210*95*67cm;31480:14306495909:几人坐:单人100*95*67cm;31480:21480914361:几人坐:四人位240*95*67cm;31480:21480914362:几人坐:大四人320*95*76cm;31480:1387571900:几人坐:3米贵妃沙发;31480:32527954:几人坐:定制尺寸;1627207:28321:颜色分类:乳白色 尺寸颜色可定制", "prop_imgs": { "prop_img": [
{ "properties": "1627207:28321", "url": "http://img.alicdn.com/imgextra/i1/2568161054/O1CN017GTZ4h1Jem9Qra1ap_!!2568161054.jpg"
}
]
}, "property_alias": "", "props": [
{ "name": "品牌", "value": "#0 工厂"
},
{ "name": "型号", "value": "520"
},
{ "name": "材质", "value": "木"
},
{ "name": "木质材质", "value": "松木"
},
{ "name": "面料", "value": "绒布"
},
{ "name": "风格", "value": "北欧"
},
{ "name": "几人坐", "value": "脚踏90*60*48cm,双人165*95*67cm,三人210*95*67cm,单人100*95*67cm,四人位240*95*67cm,大四人320*95*76cm,3米贵妃沙发,定制尺寸"
},
{ "name": "颜色分类", "value": "乳白色"
},
{ "name": "填充物", "value": "海绵"
},
{ "name": "结构工艺", "value": "木质工艺"
},
{ "name": "是否可定制", "value": "是"
},
{ "name": "沙发组合形式", "value": "U形"
},
{ "name": "是否可拆洗", "value": "是"
},
{ "name": "适用对象", "value": "成年人"
},
{ "name": "是否带储物空间", "value": "否"
},
{ "name": "产地", "value": "上海"
},
{ "name": "地市", "value": "上海市"
},
{ "name": "区县", "value": "奉贤区"
},
{ "name": "是否组装", "value": "否"
},
{ "name": "出租车是否可运输", "value": "否"
},
{ "name": "坐垫硬度等级", "value": "软"
},
{ "name": "款式定位", "value": "经济型"
}
], "total_sold": "1", "skus": { "sku": [
{ "price": 3000, "total_price": 0, "orginal_price": 3000, "properties": "31480:32527954;1627207:28321", "properties_name": "31480:32527954:几人坐:定制尺寸;1627207:28321:颜色分类:乳白色 尺寸颜色可定制", "quantity": "200", "sku_id": 5039985183003
},
{ "price": 968, "total_price": 0, "orginal_price": 968, "properties": "31480:14306495909;1627207:28321", "properties_name": "31480:14306495909:几人坐:单人100*95*67cm;1627207:28321:颜色分类:乳白色 尺寸颜色可定制", "quantity": "200", "sku_id": 4881047531346
},
{ "price": 2388, "total_price": 0, "orginal_price": 2388, "properties": "31480:21480914361;1627207:28321", "properties_name": "31480:21480914361:几人坐:四人位240*95*67cm;1627207:28321:颜色分类:乳白色 尺寸颜色可定制", "quantity": "200", "sku_id": 5039985183001
},
{ "price": 3188, "total_price": 0, "orginal_price": 3188, "properties": "31480:21480914362;1627207:28321", "properties_name": "31480:21480914362:几人坐:大四人320*95*76cm;1627207:28321:颜色分类:乳白色 尺寸颜色可定制", "quantity": "200", "sku_id": 5039985183002
},
{ "price": 1688, "total_price": 0, "orginal_price": 1688, "properties": "31480:14306495907;1627207:28321", "properties_name": "31480:14306495907:几人坐:双人165*95*67cm;1627207:28321:颜色分类:乳白色 尺寸颜色可定制", "quantity": "129", "sku_id": 4881047531344
},
{ "price": 2088, "total_price": 0, "orginal_price": 2088, "properties": "31480:14306495908;1627207:28321", "properties_name": "31480:14306495908:几人坐:三人210*95*67cm;1627207:28321:颜色分类:乳白色 尺寸颜色可定制", "quantity": "184", "sku_id": 4881047531345
},
{ "price": 480, "total_price": 0, "orginal_price": 480, "properties": "31480:14306495906;1627207:28321", "properties_name": "31480:14306495906:几人坐:脚踏90*60*48cm;1627207:28321:颜色分类:乳白色 尺寸颜色可定制", "quantity": "200", "sku_id": 4881047531343
},
{ "price": 3400, "total_price": 0, "orginal_price": 3400, "properties": "31480:1387571900;1627207:28321", "properties_name": "31480:1387571900:几人坐:3米贵妃沙发;1627207:28321:颜色分类:乳白色 尺寸颜色可定制", "quantity": "200", "sku_id": 5039984824000
}
]
}, "seller_id": "2568161054", "sales": 1, "shop_id": "567158267", "props_list": { "31480:14306495906": "几人坐:脚踏90*60*48cm", "31480:14306495907": "几人坐:双人165*95*67cm", "31480:14306495908": "几人坐:三人210*95*67cm", "31480:14306495909": "几人坐:单人100*95*67cm", "31480:21480914361": "几人坐:四人位240*95*67cm", "31480:21480914362": "几人坐:大四人320*95*76cm", "31480:1387571900": "几人坐:3米贵妃沙发", "31480:32527954": "几人坐:定制尺寸", "1627207:28321": "颜色分类:乳白色 尺寸颜色可定制"
}, "seller_info": { "nick": "佑安居", "zhuy": "https://shop567158267.taobao.com/", "shop_name": "佑安居"
}, "tmall": false, "error": "", "warning": "", "url_log": [], "fav_count": null, "fans_count": null, "freight": null, "props_imgs": { "prop_img": [
{ "properties": "1627207:28321", "url": "http://img.alicdn.com/imgextra/i1/2568161054/O1CN017GTZ4h1Jem9Qra1ap_!!2568161054.jpg"
}
]
}, "_ddf": "lh", "props_img": { "1627207:28321": "http://img.alicdn.com/imgextra/i1/2568161054/O1CN017GTZ4h1Jem9Qra1ap_!!2568161054.jpg"
}
}, "secache": "b33991a591383282e2a0685e02db4e2b", "secache_time": 1760941933, "secache_date": "2025-10-20 14:32:13", "translate_status": "", "translate_time": 0, "language": { "default_lang": "cn", "current_lang": "cn"
},num_iid：商品id（唯一标识）
title：商品标题
price：商品价格
nick：店铺昵称
detail_url：商品链接
pic_ur：商品主图
brand：品牌
cid：商品类目id
desc：商品详情
desc_img：详情图
item_imgs：商品主图
location：生产地
props_name：商品sku
props：商品属性
skus：商品sku
seller_info：店铺信息
API请求示例
curl
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.服务器.cn/taobao/item_get_pro/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=652874751412"
注意事项
1. 权限与认证
必须先完成淘宝开放平台的开发者认证，申请对应 API 的调用权限，获取合法的
appkey和appsecret。调用时需按规范生成签名，确保请求身份合法，未通过认证或签名错误会直接被拒绝。
2. 调用频率与流量控制
严格遵守平台设定的调用频率限制（如单账号每秒调用次数），超出限制会触发限流，导致短期无法调用。
高并发场景需提前申请扩容，避免因流量峰值触发平台风控。
3. 参数规范
需传入正确的必填参数（如商品 ID
item_id），参数格式、数据类型需符合 API 文档要求，缺失或错误会返回参数异常。非必填参数按需传递，避免传入无效或违规参数，增加请求失败概率。
4. 数据使用合规
调用获取的商品数据仅可用于申请时报备的场景，不可用于倒卖、恶意爬取或侵犯商家 / 平台权益的用途。
需遵守淘宝平台的数据安全规定，不泄露、不篡改获取的商品信息。
5. 错误处理与重试
需提前适配常见错误码（如权限不足、商品不存在），避免直接抛出异常影响业务。
重试机制需合理设置间隔（如 1-3 秒），避免频繁重试加重平台负担，触发更严格的限制。
6. 版本兼容性
关注 API 版本更新通知，旧版本可能会被逐步停用，需及时升级至最新稳定版本，避免因版本淘汰导致调用失效。
