引言淘宝商品详情接口是淘宝的核心数据接口可通过商品 ID 获取标题、价格、SKU 规格、props_name属性、库存、图文详情、店铺信息等标准化结构化数据。该接口主要用于ERP 进销存同步、多平台铺货搬家、竞品价格监控、比价导购、跨境反向海淘、电商数据分析等场景为电商系统开发、自动化运营、选品分析提供稳定合规的数据支撑。API名淘宝item_get/item_get_protaobao.item_get公共参数名称类型必须描述keyString是调用key必须以GET方式拼接在URL中secretString是调用密钥api_nameString是API接口名称包括在请求地址中[item_search,item_get,item_search_shop等]cacheString否[yes,no]默认yes将调用缓存的数据速度比较快result_typeString否[json,jsonu,xml,serialize,var_export]返回数据格式默认为jsonjsonu输出的内容中文可以直接阅读langString否[cn,en,ru]翻译语言默认cn简体中文versionString否API版本请求参数请求参数num_iid652874751412is_promotion1参数说明num_iid:淘宝商品IDis_promotion:是否获取取促销价响应参数名称类型必须示例值描述itemitem[]1宝贝详情数据【部分商品获取不到药品、五金、天猫国际、百亿补贴类等】num_iidBigint1520813250866宝贝IDtitleString1三刃木折叠刀过安检创意迷你钥匙扣钥匙刀军刀随身多功能小刀包邮宝贝标题desc_shortString0商品简介promotion_priceInt0优惠价priceFloat125.8价格(当商品价格为0时当前值为-1)价格来自于未登入的划线价格会有个别商品价格无法与页面匹配total_priceFloat00suggestive_priceFloat00orginal_priceString025.80原价nickString0欢乐购客栈掌柜昵称numInt03836库存(没有精确是模糊值)min_numInt00最小购买数detail_urlString0http://item.taobao.com/item.htm?id520813250866宝贝链接pic_urlString1//gd2.alicdn.com/imgextra/i4/2596264565/TB2p30elFXXXXXQXpXXXXXXXXXX_!!2596264565.jpg宝贝图片brandString0三刃木品牌名称brandIdInt08879363品牌IDrootCatIdInt050013886顶级分类IDcidInt150014822created_timeString0modified_timeString0delist_timeString0descString0商品详情【暂时不支持】desc_imgMix0[]商品详情图片【暂时不支持】item_imgsMix0item_imgs[]商品图片locationString0发货地videovideo[]0商品视频【部分商品获取不到】is_virtualString0props_nameString01627207:1347647754:颜色分类:长方形带开瓶器送工具刀卡链子;1627207:1347647753:颜色分类:椭圆形带开瓶器送工具刀卡链子;商品属性名。格式为pid1:vid1:name1:value1;pid1:vid2:name2:value2。prop_imgsprop_imgs[]0商品属性图片列表property_aliasString020509:9974422:36;1627207:28326:红色;20509:9975710:38;1627207:28326:红色;20509:9981357:40;1627207:28326:红色销售属性值别名。格式为pid1:vid1:alias1;pid1:vid2:alia2。propsMix0[{ name: 产地,value: 中国 }]商品属性total_soldInt0skusskus[]0商品规格信息列表seller_idInt02844096782卖家IDsalesInt0138销量shop_idInt0151372205店铺IDprops_listMix0{20509:9974422: 尺码:36}商品属性seller_infoseller_info[]1卖家信息tmallBoolean0false是否天猫errorString0错误信息warningString0警告信息url_logMix0[]favcountInt00fanscountInt00methodString0item_tmall:pget_itempromo_typeString0props_imgMix01627207:28326: //img.alicdn.com/imgextra/i2/2844096782/O1CN01VrjpXt1zyCc9DvERE_!!2844096782.jpg属性图片shop_itemMix0[]relate_itemsMix0[]API测试实例商品详情页面响应示例item: { num_iid: 899330283965, title: 2025新款睡衣女夏季短袖长裤两件套莫代尔薄款大尺码开衫家居服套装, desc_short: , price: 75.00, total_price: 0, suggestive_price: 0, orginal_price: 75.00, nick: 至臻尚品坊, num: 432, min_num: 0, detail_url: https://item.taobao.com/item.htm?id899330283965, pic_url: //img.alicdn.com/imgextra/i2/475611098/O1CN01rak0Wv1JyvvDQsMe8_!!475611098.jpg, brand: 无品牌/无注册商标, brandId: null, rootCatId: null, cid: 50012772, crumbs: [], created_time: , modified_time: , delist_time: , desc: img align \absmiddle\ src\https://img.alicdn.com/imgextra/i3/475611098/O1CN01bIcBq61JyvvDFzyDJ_!!475611098.png\ img align \absmiddle\ src\https://img.alicdn.com/imgextra/i1/475611098/O1CN01Y51NOP1JyvvEZGmO6_!!475611098.png\ img align \absmiddle\ src\https://img.alicdn.com/imgextra/i3/475611098/O1CN01GE2ElA1JyvvEZHFUb_!!475611098.png\ img align \absmiddle\ src\https://img.alicdn.com/imgextra/i3/475611098/O1CN01o7WvWI1JyvvCnVCh7_!!475611098.png\ img align \absmiddle\ src\https://img.alicdn.com/imgextra/i3/475611098/O1CN01pa5Ckx1JyvvEyO6JV_!!475611098.png\ img align \absmiddle\ src\https://img.alicdn.com/imgextra/i4/475611098/O1CN01Oe56aK1JyvvDG0hyo_!!475611098.png\ img align \absmiddle\ src\https://img.alicdn.com/imgextra/i3/475611098/O1CN01BhXyXg1Jyvv6PuqC9_!!475611098.png\ img align \absmiddle\ src\https://img.alicdn.com/imgextra/i1/475611098/O1CN01LTQq991JyvvDcvA6z_!!475611098.png\ img align \absmiddle\ src\https://img.alicdn.com/imgextra/i2/475611098/O1CN01Huaz9a1JyvvCdGaeN_!!475611098.png\ img align \absmiddle\ src\https://img.alicdn.com/imgextra/i3/475611098/O1CN01QYIrbu1JyvvDG2zOZ_!!475611098.png\ img align \absmiddle\ src\https://img.alicdn.com/imgextra/i4/475611098/O1CN017zSSvG1JyvvAgwec8_!!475611098.png\ img align \absmiddle\ src\https://img.alicdn.com/imgextra/i2/475611098/O1CN014Q1NUv1JyvvE29OvS_!!475611098.png\ img align \absmiddle\ src\https://img.alicdn.com/imgextra/i2/475611098/O1CN018o8ofV1JyvvAgwzPa_!!475611098.png\ img align \absmiddle\ src\https://img.alicdn.com/imgextra/i2/475611098/O1CN01J07f9S1JyvvEZHv5m_!!475611098.png\ img align \absmiddle\ src\https://img.alicdn.com/imgextra/i2/475611098/O1CN01lX9wAO1JyvvDCiN9k_!!475611098.png\ img align \absmiddle\ src\https://img.alicdn.com/imgextra/i1/475611098/O1CN01tr9BF21JyvvCdJk4x_!!475611098.png\ img align \absmiddle\ src\https://img.alicdn.com/imgextra/i4/475611098/O1CN01kXcJri1JyvvAgvJUL_!!475611098.png\ img src\https://www.o0b.cn/i.php?t.pngridgw-1.6a0534a3054d5p1965854574ki_keyt1778726051\ style\display:none\ /, desc_img: [ https://img.alicdn.com/imgextra/i3/475611098/O1CN01bIcBq61JyvvDFzyDJ_!!475611098.png, https://img.alicdn.com/imgextra/i1/475611098/O1CN01Y51NOP1JyvvEZGmO6_!!475611098.png, https://img.alicdn.com/imgextra/i3/475611098/O1CN01GE2ElA1JyvvEZHFUb_!!475611098.png, https://img.alicdn.com/imgextra/i3/475611098/O1CN01o7WvWI1JyvvCnVCh7_!!475611098.png, https://img.alicdn.com/imgextra/i3/475611098/O1CN01pa5Ckx1JyvvEyO6JV_!!475611098.png, https://img.alicdn.com/imgextra/i4/475611098/O1CN01Oe56aK1JyvvDG0hyo_!!475611098.png, https://img.alicdn.com/imgextra/i3/475611098/O1CN01BhXyXg1Jyvv6PuqC9_!!475611098.png, https://img.alicdn.com/imgextra/i1/475611098/O1CN01LTQq991JyvvDcvA6z_!!475611098.png, https://img.alicdn.com/imgextra/i2/475611098/O1CN01Huaz9a1JyvvCdGaeN_!!475611098.png, https://img.alicdn.com/imgextra/i3/475611098/O1CN01QYIrbu1JyvvDG2zOZ_!!475611098.png, https://img.alicdn.com/imgextra/i4/475611098/O1CN017zSSvG1JyvvAgwec8_!!475611098.png, https://img.alicdn.com/imgextra/i2/475611098/O1CN014Q1NUv1JyvvE29OvS_!!475611098.png, https://img.alicdn.com/imgextra/i2/475611098/O1CN018o8ofV1JyvvAgwzPa_!!475611098.png, https://img.alicdn.com/imgextra/i2/475611098/O1CN01J07f9S1JyvvEZHv5m_!!475611098.png, https://img.alicdn.com/imgextra/i2/475611098/O1CN01lX9wAO1JyvvDCiN9k_!!475611098.png, https://img.alicdn.com/imgextra/i1/475611098/O1CN01tr9BF21JyvvCdJk4x_!!475611098.png, https://img.alicdn.com/imgextra/i4/475611098/O1CN01kXcJri1JyvvAgvJUL_!!475611098.png ], item_imgs: [ { url: //img.alicdn.com/imgextra/i2/475611098/O1CN01rak0Wv1JyvvDQsMe8_!!475611098.jpg }, { url: //img.alicdn.com/imgextra/i2/475611098/O1CN01kd7uwK1JyvvAghovR_!!475611098.jpg }, { url: //img.alicdn.com/imgextra/i4/475611098/O1CN01Kzwas91JyvvBSggVb_!!475611098.jpg }, { url: //img.alicdn.com/imgextra/i4/475611098/O1CN01hIOIoL1JyvvE564nX_!!475611098.jpg }, { url: //img.alicdn.com/imgextra/i1/475611098/O1CN01TUnbqd1JyvvE550Gh_!!475611098.jpg } ], item_weight: , item_size: , location: 广东中山, post_fee: null, express_fee: null, ems_fee: , shipping_to: , has_discount: false, video: { url: https://cloud.video.taobao.com/play/u/475611098/p/2/e/6/t/1/512163578977.mp4?appKey38829 }, is_virtual: , sample_id: , is_promotion: false, props_name: 20509:28314:尺码:S 体重115以内;20509:28315:尺码:M 体重115-135;20509:28316:尺码:L 体重135-155;1627207:28334:颜色分类:灰色;1627207:39931775:颜色分类:豆沙粉, prop_imgs: { prop_img: [ { properties: 1627207:28334, url: https://img.alicdn.com/imgextra/i2/475611098/O1CN01rak0Wv1JyvvDQsMe8_!!475611098.jpg }, { properties: 1627207:39931775, url: https://img.alicdn.com/imgextra/i2/475611098/O1CN01kd7uwK1JyvvAghovR_!!475611098.jpg } ] }, property_alias: , props: [ { name: 品牌, value: 无品牌/无注册商标 }, { name: 风格, value: 简约风 }, { name: 上市年份季节, value: 2025年夏季 }, { name: 裤长, value: 长裤 }, { name: 面料, value: 莫代尔 }, { name: 适用人群, value: 青年 }, { name: 裤门襟, value: 皮筋 }, { name: 适用场景, value: 休闲 }, { name: 适用季节, value: 夏季 }, { name: 厚薄, value: 薄款 }, { name: 袖长, value: 短袖 }, { name: 裙长, value: 长裙 }, { name: 领型, value: 小翻领 }, { name: 图案, value: 纯色 }, { name: 适用性别, value: 女 }, { name: 尺码, value: S,M,L }, { name: 颜色分类, value: 灰色,豆沙粉 } ], total_sold: 9, skus: { sku: [ { price: 75, total_price: 0, orginal_price: 75, properties: 20509:28314;1627207:28334, properties_name: 20509:28314:尺码:S 体重115以内;1627207:28334:颜色分类:灰色, quantity: 58, sku_id: 5923187631738 }, { price: 75, total_price: 0, orginal_price: 75, properties: 20509:28315;1627207:28334, properties_name: 20509:28315:尺码:M 体重115-135;1627207:28334:颜色分类:灰色, quantity: 62, sku_id: 5923187631739 }, { price: 75, total_price: 0, orginal_price: 75, properties: 20509:28316;1627207:28334, properties_name: 20509:28316:尺码:L 体重135-155;1627207:28334:颜色分类:灰色, quantity: 75, sku_id: 5923187631740 }, { price: 75, total_price: 0, orginal_price: 75, properties: 20509:28314;1627207:39931775, properties_name: 20509:28314:尺码:S 体重115以内;1627207:39931775:颜色分类:豆沙粉, quantity: 82, sku_id: 5923187631741 }, { price: 75, total_price: 0, orginal_price: 75, properties: 20509:28315;1627207:39931775, properties_name: 20509:28315:尺码:M 体重115-135;1627207:39931775:颜色分类:豆沙粉, quantity: 74, sku_id: 5923187631742 }, { price: 75, total_price: 0, orginal_price: 75, properties: 20509:28316;1627207:39931775, properties_name: 20509:28316:尺码:L 体重135-155;1627207:39931775:颜色分类:豆沙粉, quantity: 81, sku_id: 5923187631743 } ] }, seller_id: 475611098, sales: 9, shop_id: 104010583, props_list: { 20509:28314: 尺码:S 体重115以内, 20509:28315: 尺码:M 体重115-135, 20509:28316: 尺码:L 体重135-155, 1627207:28334: 颜色分类:灰色, 1627207:39931775: 颜色分类:豆沙粉 }, seller_info: { nick: 至臻尚品坊, item_score: 4.9 , score_p: 4.9 , delivery_score: 4.8 , zhuy: https://shop104010583.taobao.com/, shop_name: 至臻尚品坊 }, tmall: false, error: , warning: , url_log: [], fav_count: null, fans_count: null, freight: null, props_imgs: { prop_img: [ { properties: 1627207:28334, url: https://img.alicdn.com/imgextra/i2/475611098/O1CN01rak0Wv1JyvvDQsMe8_!!475611098.jpg }, { properties: 1627207:39931775, url: https://img.alicdn.com/imgextra/i2/475611098/O1CN01kd7uwK1JyvvAghovR_!!475611098.jpg } ] }, _ddf: ykn, promo_type: null, props_img: { 1627207:28334: https://img.alicdn.com/imgextra/i2/475611098/O1CN01rak0Wv1JyvvDQsMe8_!!475611098.jpg, 1627207:39931775: https://img.alicdn.com/imgextra/i2/475611098/O1CN01kd7uwK1JyvvAghovR_!!475611098.jpg }, format_check: ok, shop_item: [], relate_items: [] },