1688商品详情API接口解析（附 JSON 样例）

一、前言

在做跨境铺货、供应链比价、竞品商品信息采集的项目中，很多开发人员一开始会选择爬虫抓取 1688 商品详情页。但爬虫方案短板很明显：页面结构经常改版、验证码拦截、IP 封禁、图片防盗链，维护成本持续走高。

1688 开放平台提供官方商品详情 API，通过标准化接口获取商品标题、价格区间、规格、主图、详情图、起批量、供应商信息等结构化数据。数据稳定、返回标准 JSON，适合替代爬虫，用于 1688 货源采集、商品信息同步、供应商价格监控、Ozon/Temu 跨境刊登等业务场景。

接口标识：1688.item_get（1688商品详情API，taobaoapi2014前往体验）

请求网关： c0b.cc/R4rbK2 （HTTPS，支持 GET/POST）

请求方式：GET / POST

入参：num_iid商品 ID，公共参数 签名串

核心返回：商品基础信息、多阶梯批发价、SKU 规格、实时库存、起批量、一件代发标识、供应商信息、发货时效、图文参数、运费模板

核心业务适用：私域 ERP 进销存同步、代购集运自动采购前置校验、货源成本核算、库存预警、私域商城 铺货、供应商筛选。

适用业务场景

1. 跨境电商铺货，批量拉取 1688 货源信息刊登到海外店铺
2. 供应链比价，监控供应商报价、起订量变动
3. 商品素材采集：主图、属性、详情描述
4. 供应商商品档案入库，搭建货源数据库
5. 联动 1688 商品列表 API，批量采集全店商品详情

二、接口基础信息

请求核心参数

三、返回数据结构与 JSON 样例

顶层字段包含状态码、消息；data 为商品主体信息，包含基础信息、价格、规格、图片、供应商、交易属性。

{
    "code": 0,
    "msg": "success",
    "data": {
        "item_id": "678912345678",
        "title": "纯棉短袖T恤 男女同款 多色可选 支持小批量定制",
        "subject": "纯棉短袖T恤",
        "main_images": [
            "https://cbu01.alicdn.com/kf/Hxxxx.jpg",
            "https://cbu01.alicdn.com/kf/Hxxxx2.jpg"
        ],
        "detail_url": "https://detail.1688.com/offer/678912345678.html",
        "price_range": "15.00 - 28.00",
        "price_list": [
            {"quantity_start": 1, "price": "28.00"},
            {"quantity_start": 50, "price": "22.00"},
            {"quantity_start": 200, "price": "15.00"}
        ],
        "min_order_quantity": 1,
        "attributes": [
            {"name": "面料", "value": "纯棉"},
            {"name": "版型", "value": "宽松"},
            {"name": "颜色", "value": "黑/白/灰/蓝"}
        ],
        "supplier_info": {
            "supplier_id": "123456789",
            "company_name": "XX服饰有限公司",
            "shop_name": "XX服饰源头工厂店"
        },
        "stock": 12000,
        "publish_time": "2025-11-20",
        "delivery_time": "48小时内发货",
        "is_custom": true
    }
}

返回字段释义

四、接入开发实战要点

1. 签名机制：1688 开放平台接口请求必须做签名校验，参数拼接 + AppSecret 加密，签名错误直接返回鉴权失败。
2. 字段按需筛选：通过 fields 参数只拉取业务需要字段，例如跨境刊登只需要标题、图片、价格、属性，过滤冗余详情 HTML，降低带宽消耗。
3. 限流控制：接口有 QPS 限制，批量采集需要做队列限速，避免触发平台流控。
4. 图片处理：1688 图片存在防盗链，跨境刊登场景需要下载图片转存到自有对象存储。
5. 阶梯价解析：1688 核心特点是阶梯报价，业务代码需要解析 price_list，按采购量匹配对应价格。

五、接入踩坑总结

1. 商品 ID 混淆：1688 商品 offer id 和店铺 ID 不能混用，传错直接返回空数据。
2. 权限范围限制：部分商品属于私密 / 定向报价商品，应用权限不足无法读取价格。
3. 签名时间戳问题：请求 timestamp 和服务器时间偏差过大，签名校验失败。
4. 下架商品：商品下架后，接口可能返回空 data 或者提示商品不存在。

六、业务拓展

拿到商品详情数据后，可以搭配 1688 商品列表 API 批量遍历供应商店铺商品，把货源数据清洗后，直接用于跨境店铺刊登、供应链价格监控系统。