×

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

知名用户18007905473 知名用户18007905473 发表于2026-05-16 15:31:55 浏览9 评论0

抢沙发发表评论

企业级实战：淘宝商品详情 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：全链路排错标识

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

  1. 控制 QPS，避免限流

  2. 超时重试（指数退避）

  3. 字段非空 + 格式校验

  4. Redis 缓存热点商品

  5. 异常日志 + 监控告警

  6. 接口异常使用缓存兜底


群贤毕至

访客