1688 选品 & 上货 API 解决方案（含 JSON 返回示例）
方案简介
本套 API 体系面向电商自研系统、ERP、选品工具，实现1688 商品数据采集选品 → 商品信息标准化 → 商品转链 / 上货 → 任务状态监控全流程能力。 依托 1688 开放平台 API 接口，完成商品检索、商品详情获取、SKU 阶梯价、供应商信息抓取，筛选出符合规则的货源；再调用商品上货接口，把 1688 货源一键发布至自有店铺（ 独立站），同时支持任务回调、异常告警、日志记录。
能力模块：选品检索 API、商品详情 API、商品预校验 API、批量上货 API、上货任务查询 API
接口 1：商品选品检索 API
接口地址：o0b.cn/anzexi 请求方式：POST 用途：按类目 / 关键词、筛选条件批量拉取商品，用于自动化选品，返回商品基础列表
请求参数示例
{
"keyword": "家用收纳盒",
"categoryId": "123456",
"page": 1,
"pageSize": 20,
"filter": {
"minTrade30d": 100,
"isSuperFactory": true,
"supportDropShip": true,
"maxMoq": 1,
"minProfitRate": 0.2
},
"sort": "trade30d_desc"
}返回 JSON 示例
{
"code": 200,
"msg": "success",
"data": {
"total": 1562,
"page": 1,
"pageSize": 20,
"list": [
{
"productId": "678912345678",
"title": "家用抽屉收纳盒 塑料分格桌面收纳盒 一件代发",
"picUrl": "https://cbu01.alicdn.com/kf/Hxxxx.jpg",
"priceInfo": {
"samplePrice": "3.80",
"batchPrice": "3.20",
"moq": 1
},
"trade30d": 1268,
"supplier": {
"supplierId": "456123",
"shopName": "XX塑料制品厂",
"isSuperFactory": true,
"isTrustPass": true,
"returnRate": "0.02"
},
"supportDropShip": true,
"deliveryTime": "48小时发货",
"score": 86,
"sourceUrl": "https://detail.1688.com/offer/678912345678.html"
}
]
}
}接口 2：商品详情获取 API
接口地址：/api/1688/product/detail 请求方式：POST 用途：获取完整商品信息（SKU、详情图、规格、资质，用于上货前数据组装）
请求参数
{
"productId": "678912345678"
}返回 JSON 示例
{
"code": 200,
"msg": "success",
"data": {
"productId": "678912345678",
"title": "家用抽屉收纳盒 塑料分格桌面收纳盒 一件代发",
"subTitle": "多规格可选 加厚PP材质",
"mainImages": [
"https://cbu01.alicdn.com/kf/Haaa.jpg",
"https://cbu01.alicdn.com/kf/Hbbb.jpg"
],
"descImages": [
"https://cbu01.alicdn.com/kf/Hccc.jpg"
],
"skuList": [
{
"skuId": "1001",
"spec": "25*15cm",
"price": "3.80",
"stock": 12000,
"moq": 1
},
{
"skuId": "1002",
"spec": "30*20cm",
"price": "4.50",
"stock": 8600,
"moq": 1
}
],
"attributeList": [
{"name": "材质", "value": "PP塑料"},
{"name": "产地", "value": "浙江台州"}
],
"supplier": {
"supplierId": "456123",
"shopName": "XX塑料制品厂",
"contactName": "王经理",
"deliveryPromise": "48小时内发货"
},
"qualification": {
"hasQualityReport": true,
"has3C": false
},
"logistics": {
"freightTemplateId": "FT001",
"defaultFreight": "4.5"
}
}
}接口 3：商品预校验 API（上货前置校验）
接口地址：/api/1688/product/preCheck 用途：上架前校验图片合规、敏感词、资质缺失、库存风险，提前拦截不能上架商品
请求参数
{
"productId": "678912345678",
"targetShopType": "douyin",
"checkItem": ["image","keyword","qualification","stock"]
}返回 JSON 示例
{
"code": 200,
"msg": "success",
"data": {
"pass": true,
"riskList": [],
"warnList": [
{"type": "image", "msg": "详情图含1688水印，建议自动去除"}
]
}
}接口 4：批量上货 API
接口地址：/api/1688/product/batchPublish 请求方式：POST 用途：批量将 1688 商品数据发布到目标店铺，返回任务 ID 异步处理
请求参数
{
"taskName": "收纳盒品类批量上货",
"targetShopId": "SHOP_001",
"targetShopType": "douyin",
"productList": [
{
"productId": "678912345678",
"priceRate": 1.6,
"publishCategoryId": "886611",
"autoWatermarkRemove": true
}
],
"callbackUrl": "shturl.cc/NlEJ8M5vWLKfqd14otrZJRnuOt"
}返回 JSON 示例
{
"code": 200,
"msg": "任务创建成功",
"data": {
"taskId": "TASK_20261028_001",
"totalCount": 1,
"successCount": 1,
"failCount": 0
}
}接口 5：上货任务查询 API
接口地址：/api/1688/product/publishTask 用途：轮询查看上货进度、成功 / 失败明细、失败原因
请求参数
{
"taskId": "TASK_20261028_001"
}返回 JSON 示例
{
"code": 200,
"msg": "success",
"data": {
"taskId": "TASK_20261028_001",
"taskStatus": "processing",
"total": 1,
"published": 0,
"fail": 0,
"detailList": [
{
"productId": "678912345678",
"status": "processing",
"targetProductId": null,
"errorMsg": ""
}
]
}
}接口 6：上货回调通知 JSON（推送至业务方 callback 地址）
{
"taskId": "TASK_20261028_001",
"event": "publish_finish",
"timestamp": "2026-10-28 14:46:55",
"data": {
"total": 1,
"success": 1,
"fail": 0,
"successList": [
{
"sourceProductId": "678912345678",
"targetProductId": "3526114589",
"publishTime": "2026-10-28 14:46:52"
}
],
"failList": []
}
}