前言
在批发选品、供应链管理、多平台铺货的业务场景中，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 } } }
