一文读懂1688商品详情API：返回字段解读（附 JSON 样例）

摘要

在跨境铺货、ERP 货源同步、供应商比价等 B2B 供应链项目中，很多开发者会尝试爬虫采集 1688 商品数据，容易触发风控、IP 封禁。本文基于 1688 开放平台 alibaba.product.get（1688.item_get） 商品详情接口，梳理接口调用前提、核心入参、返回字段含义，附带简化版 JSON 返回样例，方便开发阶段做字段映射、数据清洗，适合供应链系统、选品监控项目对接参考。

一、接口基础说明

接口标识：alibaba.product.get 能力：获取 1688 批发商品基础信息、SKU 规格、阶梯价格、库存、起订量、运费、供应商信息、商品图文等详情数据 适用场景：跨境 ERP 商品同步、货源选品分析、供应商价格监控、内部供应链数据看板。

二、核心请求参数说明

三、返回核心字段解读

{
  "code": 0,
  "msg": "success",
  "data": {
    "productId": "688123456789",
    "subject": "纯棉长袖打底衫 多色可选",
    "desc": "面料：精梳棉，适合秋冬内搭，支持贴牌定制",
    "mainImages": [
      "https://xxx.1688.com/img1.jpg",
      "https://xxx.1688.com/img2.jpg"
    ],
    "detailUrl": "https://detail.1688.com/offer/688123456789.html",
    "province": "浙江省",
    "city": "杭州市",
    "deliveryTime": "48小时",
    "minOrderQuantity": 2,
    "skuList": [
      {
        "skuId": "sku001",
        "spec": "黑色 / M码",
        "priceList": [
          {"quantityStart":2,"price":18.5},
          {"quantityStart":50,"price":16.2},
          {"quantityStart":200,"price":14.8}
        ],
        "stockQuantity": 1250
      }
    ],
    "supplierInfo": {
      "supplierId": "123456",
      "companyName": "杭州XX服饰有限公司",
      "shopName": "XX服饰源头工厂店"
    },
    "logisticsInfo": {
      "freightType": "按件计费",
      "defaultFreight": 5
    },
    "saleCount": 3260
  }
}

字段释义

1. productId：商品唯一 ID，作为业务主键，用于增量同步、商品比对
2. subject：商品标题，跨境场景下一般用于翻译、刊登标题源文本
3. mainImages：主图数组，铺货系统直接拉取用于上架配图
4. minOrderQuantity：最小起订量，B2B 核心字段，比价、选品过滤条件
5. skuList：SKU 数组，包含规格名称、阶梯价、库存，重点注意阶梯价是分段批发价，不是一口价
6. supplierInfo：供应商信息，用于供应商画像、货源评级
7. logisticsInfo：运费信息，用于集运、代购系统自动核算成本
8. saleCount：销量，作为选品热度参考指标

四、开发对接重点注意事项（踩坑点）

1. 阶梯价格处理：1688 是 B2B 平台，价格和采购数量强绑定，不能只取单一口价；前端 / 入库需要存储多档价格区间
2. SKU 规格结构不稳定：部分商品多属性（颜色 + 尺寸 + 材质），字段顺序、属性 key 偶尔变更，建议做容错解析
3. 图片地址有效期：原图链接存在时效，拿到后建议本地或者对象存储转存，避免后期图片失效
4. 限流与风控：大促期间平台风控升级，需要做重试机制、请求间隔控制，做好失败日志记录
5. 字段兼容：新老商品返回字段不完全一致，部分活动商品会多出营销字段，代码增加非空判断，防止程序报错

五、典型落地业务流程

1. 根据商品 ID 调用 alibaba.product.get
2. 解析 JSON，提取标题、图片、SKU、阶梯价、起订量、供应商信息
3. 清洗数据：过滤无效图片、规格标准化、价格格式化
4. 写入数据库，用于 ERP 同步、选品系统、比价监控看板

六、结尾

1688 商品详情 API 是 B2B 供应链自动化比较稳定的数据获取方案，相比爬虫，合规性更强、维护成本更低。实际项目中，一般会搭配搜索接口、订单接口一起使用，搭建完整的货源自动化系统。