淘宝API接口（ item_detail - 淘宝商品详情查询）

m0_37997458

已于 2025-04-28 22:46:56 修改

阅读量6k

点赞数

文章标签：数据库 android

于 2020-09-10 01:45:37 首次发布

本文链接：https://blog.csdn.net/m0_37997458/article/details/108505971

版权

本文档介绍了如何使用淘宝API接口查询商品详情，包括请求参数如API接口名称、商品ID等，以及响应示例和异常情况。同时提供了其他相关商品查询接口的列表。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

欢迎使用淘宝API接口( item_detail - 淘宝商品评论查询 )

你好！这是你使用我们的淘宝API接口获取商品详细接口说明。
在这里插入图片描述

请求参数

api - API接口名称
key - API接口账号
num_iid - 淘宝/天猫商品ID
area_id - 区域编号

响应示例

下面展示同响应示 json.

{
   "result": {
      "status": {
      	 "QQ": "2489204602",
         "msg": "success",
         "code": "200",
         "execution_time": "1.30"
      },
      "item": {
         "trade": {
            "buyEnable": "true",
            "cartEnable": "true",
            "isBanSale4Oversea": "false"
         },
         "num_iid": "909909956137",
         "title": "2025新款【制冷小空调】名创优品手持小风扇小型超长续航上桌面办公室静音学生便携式随身降温神器电风扇迷你",
         "cat_id": "50018922",
         "cat_name": null,
         "brandName": null,
         "sales": "200+",
         "detail_url": "//item.taobao.com/item.htm?id=909909956137",
         "images": [
            "//img.alicdn.com/bao/uploaded/i1/2217561435031/O1CN01hcITt81n2FenTQDMX_!!4611686018427382679-0-item_pic.jpg",
            "//img.alicdn.com/bao/uploaded/i1/2217561435031/O1CN01koPfqM1n2FehJqwT6_!!2217561435031.jpg",
            "//img.alicdn.com/bao/uploaded/i2/2217561435031/O1CN01CqETOu1n2FeaZ3QxP_!!2217561435031.jpg",
            "//img.alicdn.com/bao/uploaded/i3/2217561435031/O1CN01FeNXpa1n2Feb0IXbf_!!2217561435031.jpg",
            "//img.alicdn.com/bao/uploaded/i1/2217561435031/O1CN01zOyFU11n2FegfTZdt_!!2217561435031.jpg"
         ],
         "video": null,
         "video_thumbnail": null,
         "properties_cut": "品牌 / 型号 / 电池容量 / 是否支持喷雾 / 功能 / 放置方式 / 制冷方式 / 材质 / 生产企业 / 控制方式 / 是否支持摇头 / 充满电使用时长 / 颜色分类",
         "properties": [
            {
               "name": "品牌",
               "value": "MINISO/名创优品"
            },
            {
               "name": "型号",
               "value": "F331手持小风扇2025新款空调"
            },
            {
               "name": "电池容量",
               "value": "4800mAh"
            },
            {
               "name": "是否支持喷雾",
               "value": "不支持"
            },
            {
               "name": "功能",
               "value": "制冷"
            },
            {
               "name": "放置方式",
               "value": "桌面式, 手持式, 立式"
            },
            {
               "name": "制冷方式",
               "value": "半导体制冷"
            },
            {
               "name": "材质",
               "value": "ABS"
            },
            {
               "name": "生产企业",
               "value": "MINISO名创优品"
            },
            {
               "name": "控制方式",
               "value": "按键"
            },
            {
               "name": "是否支持摇头",
               "value": "否"
            },
            {
               "name": "充满电使用时长",
               "value": "27小时"
            },
            {
               "name": "颜色分类",
               "value": "介绍→【收藏+加购】顺丰次日达❄️不满意包退❄️3年只换不修, 介绍→【认准国补产品】立减15%❄️工信部筛选❄️品质有保障, 介绍→【上市品牌才真制冷】名创优品正品❄️礼盒装❄️送礼更有面, Ultra【戴森紫】4800mah❄️16°C空调冷风❄️双TEC制冷❄️充1次用10天❄️100档澎湃冷风, Ultra【星光银】4800mah❄️16°C空调冷风❄️双TEC制冷❄️充1次用10天❄️100档澎湃冷风, Ultra【戴森粉】4800mah❄️16°C空调冷风❄️双TEC制冷❄️充1次用10天❄️100档澎湃冷风, Ultra【组合装】立减30元❄️可联系客服换色, Pro【戴森紫】3000mah❄️16°C空调冷风❄️双TEC制冷❄️充1次用7天❄️100档澎湃冷风, Pro【星光银】3000mah❄️16°C空调冷风❄️双TEC制冷❄️充1次用7天❄️100档澎湃冷风, Pro【戴森粉】3000mah❄️16°C空调冷风❄️双TEC制冷❄️充1次用7天❄️100档澎湃冷风, Pro【组合装】立减20元❄️可联系客服换色"
            }
         ],
         "desc_url": "//mdetail.tmall.com/templates/pages/desc?id=909909956137",
         "desc_imgs": [
            "//img.alicdn.com/imgextra/i3/2217561435031/O1CN01jsnb2C1n2FenvA2dR_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i3/2217561435031/O1CN01pMBP9E1n2Fen6ta0p_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i4/2217561435031/O1CN015h2krV1n2FenvDvwj_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i3/2217561435031/O1CN01xeF2dW1n2FenXjdvV_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i3/2217561435031/O1CN01roFnQY1n2FecXRZWe_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i1/2217561435031/O1CN012HTbKO1n2Femd1nKn_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i2/2217561435031/O1CN01Obd7XF1n2FenXlWXV_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i3/2217561435031/O1CN01zqs0pE1n2FenXnGhF_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i4/2217561435031/O1CN01j9tBgC1n2Fen6u38t_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i1/2217561435031/O1CN01mOR9J01n2FeoOzWqj_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i2/2217561435031/O1CN01YBNJVQ1n2FenvCnFb_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i1/2217561435031/O1CN01w1eqAo1n2FekoymXt_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i4/2217561435031/O1CN01UNQs5A1n2FenvCOLb_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i4/2217561435031/O1CN01goxiqf1n2Fei6zupI_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i1/2217561435031/O1CN01g2M6Or1n2Fef5cKmC_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i1/2217561435031/O1CN01rr2dLe1n2Febz1hdM_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i1/2217561435031/O1CN01uQAOEc1n2FeXgFSss_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i3/2217561435031/O1CN01cGcA7V1n2Fen6tupv_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i3/2217561435031/O1CN01uycXC31n2FemN6Fa8_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i2/2217561435031/O1CN011qSETZ1n2FecXRVPJ_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i4/2217561435031/O1CN01DFQ5bb1n2FeXgMJWQ_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i2/2217561435031/O1CN01LGGNq71n2FeeiAb27_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i2/2217561435031/O1CN019kW0OY1n2FeiTcz7W_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i1/2217561435031/O1CN01R2BQaT1n2FenvCBpn_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i4/2217561435031/O1CN01pEK7fB1n2Fen6tupw_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i3/2217561435031/O1CN01Cer3iG1n2FeeRFKYo_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i1/2217561435031/O1CN01oYn9Mb1n2FedwldzN_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i4/2217561435031/O1CN01i5YqC31n2FecXWo8U_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i1/2217561435031/O1CN01B0tBWS1n2FedwlJCv_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i2/2217561435031/O1CN01CQliWl1n2FeipDVyL_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i2/2217561435031/O1CN01ttZnj51n2FehyvBcL_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i3/2217561435031/O1CN016QwuCP1n2Fedmjq1t_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i2/2217561435031/O1CN01rX6nC61n2FeoLZFUU_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i4/2217561435031/O1CN019VaCvO1n2FemilD6a_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i4/2217561435031/O1CN01Bru0U41n2Fedwnn5K_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i2/2217561435031/O1CN01vdZ7D11n2FeceXi5I_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i1/2217561435031/O1CN01wJZDXz1n2Febz6bOx_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i3/2217561435031/O1CN010tV3vt1n2Febz7TQp_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i1/2217561435031/O1CN01p8dbfR1n2Fefy12kW_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i2/2217561435031/O1CN01GTq1JH1n2FeeratbP_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i3/2217561435031/O1CN01qgbf0a1n2Fedmn3cy_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i4/2217561435031/O1CN01AY2CQH1n2Fef5hu74_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i2/2217561435031/O1CN01fuNyOt1n2FeeJSeUj_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i3/2217561435031/O1CN01nvja8X1n2FeeRIYE9_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i2/2217561435031/O1CN01pbNtE41n2FefcpDai_!!2217561435031.jpg",
            "//img.alicdn.com/imgextra/i2/2217561435031/O1CN01DrjVGW1n2FedmcX92_!!2217561435031.jpg"
         ],
         "skus": {
            "quantity": "2200",
            "price": "356 - 852",
            "promotion_price": "165 - 363",
            "activity_price": "148 - 326"
         },
         "sku_base": [
            {
               "skuId": "5938531955177",
               "propPath": "1627207:37695829358;149128818:9934879",
               "price": "356",
               "promotion_price": "165",
               "activity_price": "148",
               "quantity": "200",
               "priceFormatted": "¥356",
               "promotion_priceFormatted": "¥165",
               "activity_priceFormatted": "¥148"
            },
            {
               "skuId": "5939650067883",
               "propPath": "1627207:37726224295;149128818:9934879",
               "price": "356",
               "promotion_price": "165",
               "activity_price": "148",
               "quantity": "200",
               "priceFormatted": "¥356",
               "promotion_priceFormatted": "¥165",
               "activity_priceFormatted": "¥148"
            },
            {
               "skuId": "5938531955178",
               "propPath": "1627207:37695829359;149128818:9934879",
               "price": "356",
               "promotion_price": "165",
               "activity_price": "148",
               "quantity": "200",
               "priceFormatted": "¥356",
               "promotion_priceFormatted": "¥165",
               "activity_priceFormatted": "¥148"
            },
            {
               "skuId": "5938531955179",
               "propPath": "1627207:37695829360;149128818:9934879",
               "price": "416",
               "promotion_price": "198",
               "activity_price": "178",
               "quantity": "200",
               "priceFormatted": "¥416",
               "promotion_priceFormatted": "¥198",
               "activity_priceFormatted": "¥178"
            },
            {
               "skuId": "5938531955180",
               "propPath": "1627207:37695829361;149128818:9934879",
               "price": "416",
               "promotion_price": "198",
               "activity_price": "178",
               "quantity": "200",
               "priceFormatted": "¥416",
               "promotion_priceFormatted": "¥198",
               "activity_priceFormatted": "¥178"
            },
            {
               "skuId": "5938531955181",
               "propPath": "1627207:37695829362;149128818:9934879",
               "price": "416",
               "promotion_price": "198",
               "activity_price": "178",
               "quantity": "200",
               "priceFormatted": "¥416",
               "promotion_priceFormatted": "¥198",
               "activity_priceFormatted": "¥178"
            },
            {
               "skuId": "5938531955182",
               "propPath": "1627207:37695829363;149128818:9934879",
               "price": "852",
               "promotion_price": "363",
               "activity_price": "326",
               "quantity": "200",
               "priceFormatted": "¥852",
               "promotion_priceFormatted": "¥363",
               "activity_priceFormatted": "¥326"
            },
            {
               "skuId": "5938531955183",
               "propPath": "1627207:37695829364;149128818:9934879",
               "price": "356",
               "promotion_price": "165",
               "activity_price": "148",
               "quantity": "200",
               "priceFormatted": "¥356",
               "promotion_priceFormatted": "¥165",
               "activity_priceFormatted": "¥148"
            },
            {
               "skuId": "5938531955184",
               "propPath": "1627207:37695829365;149128818:9934879",
               "price": "356",
               "promotion_price": "165",
               "activity_price": "148",
               "quantity": "200",
               "priceFormatted": "¥356",
               "promotion_priceFormatted": "¥165",
               "activity_priceFormatted": "¥148"
            },
            {
               "skuId": "5770088592915",
               "propPath": "1627207:37695829366;149128818:9934879",
               "price": "356",
               "promotion_price": "165",
               "activity_price": "148",
               "quantity": "200",
               "priceFormatted": "¥356",
               "promotion_priceFormatted": "¥165",
               "activity_priceFormatted": "¥148"
            },
            {
               "skuId": "5938531955186",
               "propPath": "1627207:37695829367;149128818:9934879",
               "price": "752",
               "promotion_price": "307",
               "activity_price": "276",
               "quantity": "200",
               "priceFormatted": "¥752",
               "promotion_priceFormatted": "¥307",
               "activity_priceFormatted": "¥276"
            }
         ],
         "sku_props": [
            {
               "pid": "1627207",
               "name": "颜色分类",
               "values": [
                  {
                     "vid": "37695829358",
                     "name": "介绍→【收藏+加购】顺丰次日达❄️不满意包退❄️3年只换不修",
                     "image": "//img.alicdn.com/bao/uploaded/i2/2217561435031/O1CN01uabROD1n2Fec05VtQ_!!2217561435031.jpg"
                  },
                  {
                     "vid": "37726224295",
                     "name": "介绍→【认准国补产品】立减15%❄️工信部筛选❄️品质有保障",
                     "image": "//img.alicdn.com/bao/uploaded/i2/2217561435031/O1CN01Qwy3FQ1n2FeeBT0J8_!!2217561435031.jpg"
                  },
                  {
                     "vid": "37695829359",
                     "name": "介绍→【上市品牌才真制冷】名创优品正品❄️礼盒装❄️送礼更有面",
                     "image": "//img.alicdn.com/bao/uploaded/i4/2217561435031/O1CN01skIyUz1n2FeczMGQx_!!2217561435031.jpg"
                  },
                  {
                     "vid": "37695829360",
                     "name": "Ultra【戴森紫】4800mah❄️16°C空调冷风❄️双TEC制冷❄️充1次用10天❄️100档澎湃冷风",
                     "image": "//img.alicdn.com/bao/uploaded/i2/2217561435031/O1CN01f1kQkV1n2FeeRqu2M_!!2217561435031.jpg"
                  },
                  {
                     "vid": "37695829361",
                     "name": "Ultra【星光银】4800mah❄️16°C空调冷风❄️双TEC制冷❄️充1次用10天❄️100档澎湃冷风",
                     "image": "//img.alicdn.com/bao/uploaded/i1/2217561435031/O1CN01Zrsxdt1n2FeWXuLl4_!!2217561435031.jpg"
                  },
                  {
                     "vid": "37695829362",
                     "name": "Ultra【戴森粉】4800mah❄️16°C空调冷风❄️双TEC制冷❄️充1次用10天❄️100档澎湃冷风",
                     "image": "//img.alicdn.com/bao/uploaded/i1/2217561435031/O1CN010SCVlx1n2FectEnGc_!!2217561435031.jpg"
                  },
                  {
                     "vid": "37695829363",
                     "name": "Ultra【组合装】立减30元❄️可联系客服换色",
                     "image": "//img.alicdn.com/bao/uploaded/i4/2217561435031/O1CN01UjH9gs1n2FedIKdNE_!!2217561435031.jpg"
                  },
                  {
                     "vid": "37695829364",
                     "name": "Pro【戴森紫】3000mah❄️16°C空调冷风❄️双TEC制冷❄️充1次用7天❄️100档澎湃冷风",
                     "image": "//img.alicdn.com/bao/uploaded/i1/2217561435031/O1CN01H8LaSB1n2FedUsPVG_!!2217561435031.jpg"
                  },
                  {
                     "vid": "37695829365",
                     "name": "Pro【星光银】3000mah❄️16°C空调冷风❄️双TEC制冷❄️充1次用7天❄️100档澎湃冷风",
                     "image": "//img.alicdn.com/bao/uploaded/i4/2217561435031/O1CN01Aqy6IR1n2FebR807z_!!2217561435031.jpg"
                  },
                  {
                     "vid": "37695829366",
                     "name": "Pro【戴森粉】3000mah❄️16°C空调冷风❄️双TEC制冷❄️充1次用7天❄️100档澎湃冷风",
                     "image": "//img.alicdn.com/bao/uploaded/i3/2217561435031/O1CN011UP1Ze1n2FeePdoH9_!!2217561435031.jpg"
                  },
                  {
                     "vid": "37695829367",
                     "name": "Pro【组合装】立减20元❄️可联系客服换色",
                     "image": "//img.alicdn.com/bao/uploaded/i1/2217561435031/O1CN01129bz01n2FeePfQ8B_!!2217561435031.jpg"
                  }
               ]
            },
            {
               "pid": "149128818",
               "name": "电池容量",
               "values": [
                  {
                     "vid": "9934879",
                     "name": "4800mAh"
                  }
               ]
            }
         ],
         "sku_images": {
            "1627207:37695829360": "//img.alicdn.com/bao/uploaded/i2/2217561435031/O1CN01f1kQkV1n2FeeRqu2M_!!2217561435031.jpg",
            "1627207:37695829361": "//img.alicdn.com/bao/uploaded/i1/2217561435031/O1CN01Zrsxdt1n2FeWXuLl4_!!2217561435031.jpg",
            "1627207:37695829362": "//img.alicdn.com/bao/uploaded/i1/2217561435031/O1CN010SCVlx1n2FectEnGc_!!2217561435031.jpg",
            "1627207:37695829363": "//img.alicdn.com/bao/uploaded/i4/2217561435031/O1CN01UjH9gs1n2FedIKdNE_!!2217561435031.jpg",
            "1627207:37695829364": "//img.alicdn.com/bao/uploaded/i1/2217561435031/O1CN01H8LaSB1n2FedUsPVG_!!2217561435031.jpg",
            "1627207:37695829365": "//img.alicdn.com/bao/uploaded/i4/2217561435031/O1CN01Aqy6IR1n2FebR807z_!!2217561435031.jpg",
            "1627207:37695829366": "//img.alicdn.com/bao/uploaded/i3/2217561435031/O1CN011UP1Ze1n2FeePdoH9_!!2217561435031.jpg",
            "1627207:37695829367": "//img.alicdn.com/bao/uploaded/i1/2217561435031/O1CN01129bz01n2FeePfQ8B_!!2217561435031.jpg",
            "1627207:37695829358": "//img.alicdn.com/bao/uploaded/i2/2217561435031/O1CN01uabROD1n2Fec05VtQ_!!2217561435031.jpg",
            "1627207:37695829359": "//img.alicdn.com/bao/uploaded/i4/2217561435031/O1CN01skIyUz1n2FeczMGQx_!!2217561435031.jpg",
            "1627207:37726224295": "//img.alicdn.com/bao/uploaded/i2/2217561435031/O1CN01Qwy3FQ1n2FeeBT0J8_!!2217561435031.jpg"
         }
      },
      "delivery": {
         "from": "广东深圳",
         "to": "东城区",
         "delivery_fee": "0.00",
         "area_id": "110101"
      },
      "seller": {
         "seller_id": "2217561435031",
         "seller_title": "miniso名创优品数码旗舰店",
         "shop_title": "MINISO名创优品数码旗舰店",
         "shop_id": "462521617",
         "shop_url": "//store.taobao.com/shop/view_shop.htm?user_number_id=2217561435031",
         "shop_icon": "//img.alicdn.com/imgextra/i2/2217561435031/O1CN01JGImeN1n2FXZSeT1b_!!2217561435031.png",
         "user_type": "B",
         "evaluates": [
            {
               "title": "物流服务",
               "score": "4.7"
            },
            {
               "title": "卖家服务",
               "score": "4.6"
            },
            {
               "title": "宝贝描述",
               "score": "4.2"
            }
         ]
      }
   }
}

异常示例

下面展示同响应示 json.

{
  "result": {
    "status": {
      "msg": "error",
      "code": 401,
      "sub_code": "invalid-parameter:key"
    }
  }
}

其他API列表

———— Item Related 商品相关接口 ————
item_detail - 淘宝商品详情查询
item_detail_simple - 淘宝商品详情查询（简版）
item_review - 淘宝商品评论查询
item_fee - 淘宝商品快递费用查询
item_sku - 淘宝商品SKU详细信息查询
———— Search Related 搜索相关接口 ————
item_search - 淘宝商品列表搜索
item_search_filters - 淘宝商品搜索筛选
item_image_search - 按图搜索淘宝商品（拍立淘）
item_search_tejia - 天天特价
———— Shop 店铺相关接口 ————
shop_search - 淘宝店铺列表搜索
shop_recommended - 获取推荐店铺列表
shop_detail - 淘宝店铺详情查询
shop_item - 淘宝店铺商品列表
shop_item_cats - 淘宝店铺分类列表
———— 爱逛街接口 ————
search_guang - 爱逛街搜索
recommended_guang - 爱逛街推荐商品列表
item_guang - 爱逛街商品详情查询
———— 优惠券接口 ————
coupon_items_search_by_cat - 优惠券搜索接口
coupon_item_recommended_items - 有优惠券商品推荐接口
item_coupons - 商品优惠券接口
coupon_item_details - 优惠券详细接口
———— 其他接口 ————
search_keyword_suggest - 关键词推荐
ip_info - IP 信息查询