taoxi商品详情｜商品属性｜包装规格信息 API接口

淘宝开放平台（TOP）提供 taobao.item.get（标准版）与 taobao.item.get_pro（高级版）两个核心 API 接口，可一次性获取商品详情、完整属性、SKU 规格及包装规格信息，是官方推荐的合规数据方案。

一、核心接口：taobao.item.get/taobao.item.get_pro

接口标识

• API 名称: taobao.item.get (基础) / taobao.item.get_pro (高级)
• 请求地址: https://o0b.cn/ibrad
• 返回格式: JSON
• 必填参数: num_iid (商品 ID)

可获取数据（含包装与规格）

表格

数据模块	关键字段	包装 / 规格相关
商品基础信息	num_iid, title, price, pic_url	-
商品标准属性	props_name, prop_list	品牌、材质、尺寸、重量、产地、包装方式
SKU 规格	sku_list → properties_name, quantity, price	颜色、尺码、规格组合、单 SKU 包装
包装 / 物流信息	packing_list, weight, size, volume	包装清单、毛重、长宽高、包装体积
商品详情	desc (HTML)	详情页内包装说明

二、专用规格接口（辅助）

• taobao.item.desc.get：获取商品规格组与可选值（如颜色 / 尺码）
• taobao.item.sku.get：查询 SKU 的价格、库存、属性、条码

三、调用流程（极简）

1. 入驻：淘宝开放平台注册 → 创建应用 → 获取 AppKey / AppSecret

2. 授权：申请 item.get / item.get_pro 接口权限

3. 构造请求

   • 公共参数：method, app_key, timestamp, sign, format=json
   • 业务参数：num_iid=商品ID

四、返回示例（包装规格）

{
  "item_get_response": {
    "item": {
      "num_iid": 678901234567,
      "title": "XX品牌 500ml 瓶装矿泉水",
      "props_name": "品牌:XX;材质:PET;净含量:500ml;包装种类:瓶装;包装规格:1瓶/份,24瓶/箱",
      "weight": 0.55, // 千克（含瓶）
      "size": "6.5x6.5x23 cm",
      "packing_list": "矿泉水×1, 瓶身×1",
      "sku_list": [
        {
          "properties_name": "包装规格:单瓶",
          "price": "2.00",
          "quantity": 1000
        },
        {
          "properties_name": "包装规格:24瓶整箱",
          "price": "45.00",
          "quantity": 100
        }
      ]
    }
  }
}

五、关键说明

• 包装规格：通常在 props_name、size、weight、packing_list 及 SKU 属性中返回。
• 权限：item.get 基础可用；整箱 / 批发包装需企业认证 + 类目权限。
• 频率：个人≈500 次 / 天；企业可申请更高 QPS。

六、推荐方案

• 全量信息：优先使用 taobao.item.get_pro（一次拿到详情 + 属性 + 包装 + SKU）。
• 仅规格：用 taobao.item.spec.get + taobao.item.sku.get。