分析中 已回复 待规划 {{opt.name}}

分析中 已回复 待规划

阿里巴巴1688商品详情API返回值全面解析——商品基本信息

1688商品详情API的返回值以JSON格式封装，结构清晰、字段丰富。商品基本信息是整个返回值的核心骨架，直接决定了你能否精准获取商品的"身份证"。以下从六大维度逐层拆解。

一、返回值顶层结构

json{
  "request_id": "xxxxxxx",
  "code": 200,
  "message": "success",
  "result": {
    "product": { ... }  // 商品基本信息全在这里
  }
}

二、商品基本信息字段全解析

📦 1. 商品身份信息

💰 2. 价格体系（批发场景核心）

⚠️ 批发场景特别注意：1688的价格是阶梯批发价，1件和100件可能完全不同。部分接口还返回min_order_quantity（最小起批量，如10），这是1688区别于零售平台的关键特征。

📊 3. 库存与销售数据

🖼️ 4. 图片信息

📋 5. SKU规格信息（多规格商品必看）

json"sku_list": [
  {
    "sku_id": "987654321012",
    "sku_spec": "白色-L",
    "sku_price": "19.90",
    "sku_stock": 5000,
    "sku_code": "T2025-W-L",
    "properties": "颜色:白色;尺寸:L"
  }
]

🔑 关键：spec_info.spec_list提供规格组定义，如{"spec_value":"白色-L","spec_id":"12345678"}，这是解析SKU组合的入口。

🏪 6. 商家与物流信息

三、2026年新增高价值字段

根据最新的API演进（2026年趋势），返回值已扩展至50+字段，新增了对AI选品和智能定价极为关键的数据：

四、Python实战解析代码

pythonimport requests, hashlib, time

def get_product_details(app_key, app_secret, product_id):
    url = "https://api.1688.com/router/json"
    timestamp = str(int(time.time()))
    params = {
        'method': 'alibaba.product.get',
        'fields': 'product_id,product_title,price,original_price,main_image_url,stock,sku_list,seller_name,brand,category_id,min_num,num,rate_info',
        'product_id': product_id,
        'app_key': app_key,
        'timestamp': timestamp,
        'format': 'json',
        'v': '2.0',
        'sign_method': 'md5'
    }
    # MD5签名
    sorted_params = sorted(params.items())
    sign_str = app_secret + ''.join(f'{k}{v}' for k, v in sorted_params) + app_secret
    params['sign'] = hashlib.md5(sign_str.encode()).upper().hexdigest()
    
    response = requests.get(url, params=params)
    return response.json()

def parse_product_details(data):
    item = data.get('alibaba_product_get_response', {}).get('product', {})
    return {
        "商品ID": item.get('product_id'),
        "标题": item.get('product_title'),
        "售价": item.get('price'),
        "原价": item.get('original_price'),
        "库存": item.get('stock'),
        "起订量": item.get('min_num'),
        "月销量": item.get('num'),
        "好评率": item.get('rate_info', {}).get('good_rate'),
        "SKU数": len(item.get('sku_list', [])),
        "店铺": item.get('seller_name'),
        "品牌": item.get('brand'),
    }

五、核心要点总结

一句话总结：1688商品详情API的基本信息返回值，本质上是一张B2B批发场景的商品全景卡——它不只告诉你"这东西多少钱"，更告诉你"能不能批、批多少、从哪发、谁在卖、卖得怎么样"。这才是它区别于零售API的核心壁垒。