天猫商品详情数据解析：规格、SKU、详情图与价格的JSON结构详解

ID_18007905473

532人浏览 · 2026-03-06 14:21:55

ID_18007905473 · 2026-03-06 14:21:55 发布

前言

在电商运营中，商品详情数据是构建商品展示页、优化搜索排名、制定价格策略的核心依据。天猫开放平台通过API接口提供结构化的商品详情数据，其中规格、SKU、详情图及价格信息是开发者最关注的字段。本文将以天猫商品详情API返回的JSON数据为例，解析关键字段的结构与应用场景。

一、JSON数据基础结构

天猫商品详情API（如tmall.item.get）返回的JSON数据通常包含以下层级：

json{
  "item": {
    "num_iid": "807896883625",
    "title": "奶黄色polo衫翻领短袖正肩T恤2024新款上衣女v领修身收腰半袖短款",
    "price": 39.9,
    "orginal_price": 42.72,
    "skus": [...],
    "images": [...],
    "props": [...],
    "promotions": [...]
  }
}

item：根对象，包含商品所有核心信息。
num_iid：商品唯一ID，用于定位具体商品。
title：商品标题，需包含关键词以提升搜索排名。
price：当前售价，单位为元。
orginal_price：商品原价，用于价格对比展示。

二、SKU数据结构与价格体系

SKU（库存量单位）是商品规格的细化组合，直接关联库存与价格。天猫API返回的SKU数据示例：

json"skus": [
  {
    "sku_id": "sku_id_1",
    "price": 39.9,
    "stock": 100,
    "properties": "颜色:奶黄色;尺码:L",
    "outer_id": "商家自定义编码"
  },
  {
    "sku_id": "sku_id_2",
    "price": 42.72,
    "stock": 50,
    "properties": "颜色:白色;尺码:M"
  }
]

sku_id：SKU唯一标识，用于区分不同规格组合。
price：该规格的当前售价，可能因促销活动与商品基础价不同。
stock：实时库存数量，需注意部分商家可能隐藏真实库存。
properties：规格属性键值对，如颜色、尺码，格式为属性名:属性值。

应用场景：

前端展示：用户选择规格后动态更新价格与库存。
库存预警：当stock低于阈值时触发补货提醒。
价格策略：分析不同SKU的定价差异，优化利润结构。

三、商品详情图数据结构

商品图片是用户决策的关键因素，天猫API返回的图片数据包含主图与详情图：

json"images": [
  "//img.alicdn.com/imgextra/i3/2211428221162/O1CN01ZpGgOG1KSFCAUN9VE_!!0-item_pic.jpg",
  "//img.alicdn.com/imgextra/i1/2211428221162/O1CN01nMmqRw1KSFC670Mp6_!!2211428221162.jpg"
],
"desc": "<div><img src=\"http://img.alicdn.com/imgextra/i1/2211428221162/O1CN01LfDDKX1KSFC8O5vIg_!!2211428221162.jpg\" /></div>"

images：商品主图列表，通常包含5-10张图片，展示不同角度或场景。
desc：商品详情页HTML，包含<img>标签引用的详情图，需解析后获取图片URL。

优化建议：

图片加载速度：使用CDN加速或压缩图片体积。
图片一致性：确保images与desc中的图片风格统一。
懒加载：对详情图实施懒加载，提升页面性能。

四、促销信息数据结构

促销活动直接影响用户购买决策，天猫API返回的促销数据示例：

json"promotions": [
  {
    "type": "满减",
    "desc": "满200减20",
    "start_time": "2026-03-01 00:00:00",
    "end_time": "2026-03-10 23:59:59"
  },
  {
    "type": "折扣",
    "desc": "8折优惠",
    "applicable_skus": ["sku_id_1"]
  }
]

type：促销类型，如满减、折扣、优惠券等。
desc：促销活动描述，需在前端清晰展示。
applicable_skus：适用SKU列表，部分促销仅针对特定规格。

应用场景：

促销标签：在商品列表页标注“满减”“折扣”等标签。
价格计算：根据促销规则动态计算最终售价。
活动倒计时：对限时促销展示剩余时间，制造紧迫感。

五、完整JSON数据示例

以下是一个包含规格、SKU、详情图与促销信息的完整JSON示例：

json{
  "item": {
    "num_iid": "807896883625",
    "title": "奶黄色polo衫翻领短袖正肩T恤2024新款上衣女v领修身收腰半袖短款",
    "price": 39.9,
    "orginal_price": 42.72,
    "skus": [
      {
        "sku_id": "sku_id_1",
        "price": 39.9,
        "stock": 100,
        "properties": "颜色:奶黄色;尺码:L"
      },
      {
        "sku_id": "sku_id_2",
        "price": 42.72,
        "stock": 50,
        "properties": "颜色:白色;尺码:M"
      }
    ],
    "images": [
      "//img.alicdn.com/imgextra/i3/2211428221162/O1CN01ZpGgOG1KSFCAUN9VE_!!0-item_pic.jpg",
      "//img.alicdn.com/imgextra/i1/2211428221162/O1CN01nMmqRw1KSFC670Mp6_!!2211428221162.jpg"
    ],
    "desc": "<div><img src=\"http://img.alicdn.com/imgextra/i1/2211428221162/O1CN01LfDDKX1KSFC8O5vIg_!!2211428221162.jpg\" /></div>",
    "promotions": [
      {
        "type": "满减",
        "desc": "满200减20",
        "start_time": "2026-03-01 00:00:00",
        "end_time": "2026-03-10 23:59:59"
      }
    ]
  }
}