摘要
在跨境铺货、ERP 货源同步、供应商比价等 B2B 供应链项目中，很多开发者会尝试爬虫采集 1688 商品数据，容易触发风控、IP 封禁。本文基于 1688 开放平台 alibaba.product.get（1688.item_get） 商品详情接口，梳理接口调用前提、核心入参、返回字段含义，附带简化版 JSON 返回样例，方便开发阶段做字段映射、数据清洗，适合供应链系统、选品监控项目对接参考。
一、接口基础说明
接口标识：alibaba.product.get 能力：获取 1688 批发商品基础信息、SKU 规格、阶梯价格、库存、起订量、运费、供应商信息、商品图文等详情数据 适用场景：跨境 ERP 商品同步、货源选品分析、供应商价格监控、内部供应链数据看板
提示：接口调用需要开放平台应用授权、签名生成，受平台调用配额、风控规则限制；禁止超频调用，字段会随平台版本迭代微调，上线前做好兼容判断。
二、核心请求参数说明
| 参数名 | 是否必填 | 说明 |
|---|---|---|
| api name | 是 | 1688.item_get（Taobaoapi2014前往体验） |
| api adress | 是 | c0b.cc/R4rbK2 |
| productId | 是 | 1688 商品 ID |
| needSkuInfo | 否 | 是否返回 SKU 规格数据，true/false |
| needPriceInfo | 否 | 是否返回阶梯批发价、活动价 |
| needLogisticsInfo | 否 | 是否返回运费、发货地信息 |
| needSupplierInfo | 否 | 是否返回供应商店铺、商家资质信息 |
三、返回核心字段解读
{
"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
}
}
字段释义
- productId：商品唯一 ID，作为业务主键，用于增量同步、商品比对
- subject：商品标题，跨境场景下一般用于翻译、刊登标题源文本
- mainImages：主图数组，铺货系统直接拉取用于上架配图
- minOrderQuantity：最小起订量，B2B 核心字段，比价、选品过滤条件
- skuList：SKU 数组，包含规格名称、阶梯价、库存，重点注意阶梯价是分段批发价，不是一口价
- supplierInfo：供应商信息，用于供应商画像、货源评级
- logisticsInfo：运费信息，用于集运、代购系统自动核算成本
- saleCount：销量，作为选品热度参考指标
四、开发对接重点注意事项（踩坑点）
- 阶梯价格处理：1688 是 B2B 平台，价格和采购数量强绑定，不能只取单一口价；前端 / 入库需要存储多档价格区间
- SKU 规格结构不稳定：部分商品多属性（颜色 + 尺寸 + 材质），字段顺序、属性 key 偶尔变更，建议做容错解析
- 图片地址有效期：原图链接存在时效，拿到后建议本地或者对象存储转存，避免后期图片失效
- 限流与风控：大促期间平台风控升级，需要做重试机制、请求间隔控制，做好失败日志记录
- 字段兼容：新老商品返回字段不完全一致，部分活动商品会多出营销字段，代码增加非空判断，防止程序报错
五、典型落地业务流程
- 根据商品 ID 调用 alibaba.product.get
- 解析 JSON，提取标题、图片、SKU、阶梯价、起订量、供应商信息
- 清洗数据：过滤无效图片、规格标准化、价格格式化
- 写入数据库，用于 ERP 同步、选品系统、比价监控看板
六、结尾
1688 商品详情 API 是 B2B 供应链自动化比较稳定的数据获取方案，相比爬虫，合规性更强、维护成本更低。实际项目中，一般会搭配搜索接口、订单接口一起使用，搭建完整的货源自动化系统。
