技术实战：1688商品详情API接入指南与JSON返回参考
前言
在批发选品、供应链管理、多平台铺货的业务场景中，1688商品详情API是电商从业者最核心的结构化数据入口。它无需搭建复杂的反爬体系，就能稳定获取全维度的1688商品信息，大幅降低批发选品、货源监控类业务的开发门槛，是打通1688货源数据与自有电商系统的必备工具。
一、接口核心覆盖的数据范围
这套接口可以返回国内批发电商业务开发中几乎所有需要的1688商品核心字段，完全适配货源筛选、价格监控、供应链分析等多种场景：
基础标识：商品唯一ID、商品标题、所属供应商ID、供应商名称、店铺诚信通状态、商品发布时间
价格体系：阶梯批发价、单件零售价、大货定制价、限时促销价、平台满减抵扣金额，所有价格数据支持分钟级更新
交易属性：30天累计销量、复购率、起订量要求、发货地、承诺发货时效、是否支持7天无理由退换
规格库存：全SKU列表、每个子规格的对应批发价、实时可售库存、颜色/尺寸/型号等属性明细
素材资源：多尺寸主图数组、详情图列表、商品详情页A+素材链接、工厂实拍短视频地址
附加信息：商品参数详情、加工定制服务说明、物流运费模板、诚信保障标识、关联代发推广链接
二、最简接入操作步骤
新手跟着3步就能完成基础调用，没有复杂的前置依赖：
登录1688开放平台，创建开发者应用，开通商品详情查询接口权限，获取专属的App Key和App Secret（o0b.cn/anzexi）
按照官方规范生成合法签名，将所有非空请求参数按字典序排序后拼接密钥，通过MD5加密生成验签值
用HTTPS POST方式将请求提交到1688API网关，传入目标商品ID，即可直接返回标准JSON格式的结构化商品数据
三、可直接参考的成功返回JSON示例
这是脱敏后的标准返回结构，完全匹配1688开放平台官方商品详情接口的原生返回格式，核心字段都标注了业务含义，可直接用于开发调试参考：
{
"code": 0,
"msg": "success",
"request_id": "req_2026081410362745",
"data": {
"offer_id": 6789012345,
"title": "2026新款夏季纯棉短袖T恤 男士宽松大码 工厂直供支持定制logo",
"supplier_info": {
"member_id": 987654321,
"company_name": "广州服饰源头工厂",
"shop_name": "诚信通服饰工厂店",
"is_chengtong": true,
"credit_level": "AAA",
"main_business": "男装T恤定制、现货批发"
},
"price_info": {
"retail_price": "39.90",
"step_price": [
{"quantity": 1, "price": "29.90"},
{"quantity": 100, "price": "24.90"},
{"quantity": 500, "price": "19.90"}
],
"promotion_price": "27.90",
"promotion_desc": "限时满100件立减200元活动"
},
"sales_info": {
"month_sales": 126800,
"reorder_rate": "38%",
"total_views": 1568900
},
"stock_info": {
"total_stock": 126000,
"is_on_sale": true,
"moq": 1,
"delivery_place": "广东广州",
"delivery_time": "48小时内发货"
},
"image_info": {
"main_images": [
"https://img.1688.com/123/456/abc123_1.jpg",
"https://img.1688.com/123/456/abc123_2.jpg",
"https://img.1688.com/123/456/abc123_3.jpg"
],
"detail_images": [
"https://img.1688.com/123/456/def456_1.jpg",
"https://img.1688.com/123/456/def456_2.jpg"
],
"factory_video": "https://v.1688.com/123/ghi789.mp4"
},
"sku_list": [
{
"sku_id": 678901234501,
"spec_text": "白色 M",
"sku_price": "29.90",
"sku_stock": 26000
},
{
"sku_id": 678901234502,
"spec_text": "黑色 XL",
"sku_price": "29.90",
"sku_stock": 32000
},
{
"sku_id": 678901234503,
"spec_text": "定制logo 均码",
"sku_price": "19.90",
"sku_stock": 68000
}
],
"product_params": [
{"name": "面料成分", "value": "100%纯棉"},
{"name": "版型", "value": "宽松落肩款"},
{"name": "工艺", "value": "印花/刺绣定制"}
],
"custom_service": {
"support_custom": true,
"min_custom_num": 50,
"custom_cycle": "7天"
},
"after_sale": {
"support_return": true,
"return_days": 7,
"support_insurance": true
}
}
}