企业级实战：淘宝商品详情 API简要说明，json数据返回参考

ID_180079054732026-05-17 17:45

企业级实战：淘宝商品详情 API 简要说明

一、接口说明

接口标识 ：taobao.item.get / taobao.item.get_full
作用：通过商品 ID（num_iid）获取淘宝 / 天猫商品完整结构化数据
适用场景：商品中台、ERP 同步、跨平台铺货、价格监控、数据分析
传输格式 ：JSON
鉴权方式 ：AppKey + AppSecret 签名，企业版需店铺授权 session

二、核心请求参数（极简）

num_iid：商品 ID（必传）
fields：指定返回字段（可选）
format=json：数据格式

三、企业级 JSON 返回参考（精简标准结构）

json

复制代码

{
  "item_get_response": {
    "item": {
      "num_iid": 680123456789,
      "title": "2026夏季新款纯棉透气短袖T恤",
      "price": "89.00",
      "promotion_price": "59.00",
      "num": 560,
      "sales": 12860,
      "cid": 50015261,
      "category_name": "女装>T恤",
      "pic_url": "https://img.taobao.com/imgextra/i1/xxx.jpg",
      "location": "广东 广州",
      "nick": "XX品牌旗舰店",
      "seller_id": 123456789,
      "modified": "2026-05-16 10:22:33",
      "sku_list": {
        "sku": [
          {
            "sku_id": 12345678901,
            "price": "59.00",
            "quantity": 120,
            "properties_name": "颜色:白色;尺码:L"
          }
        ]
      },
      "desc": "<p>商品详情描述HTML</p>"
    },
    "request_id": "req_2405161022001234"
  }
}

四、关键字段（企业必用）

num_iid：商品唯一 ID
title：商品标题
price / promotion_price：原价 / 活动价
num：库存
sales：销量
pic_url：主图
sku_list：多规格信息
modified：最后更新时间（增量同步用）
request_id：全链路排错标识

五、企业级稳定性要点（极简）

控制 QPS，避免限流
超时重试（指数退避）
字段非空 + 格式校验
Redis 缓存热点商品
异常日志 + 监控告警
接口异常使用缓存兜底