1688 跨境电商 API 接口实战指南：从寻源到代采的全链路技术方案

POST https://gw.open.1688.com/openapi/param2/1/com.alibaba.product/alibaba.product.get

{
    "result": {
        "productID": 123456789012345,
        "subject": "2026新款 磁吸无线充电宝 10000mAh",
        "priceRanges": [
            {"startQuantity": 1, "price": 45.00},
            {"startQuantity": 50, "price": 38.50},
            {"startQuantity": 200, "price": 32.00}
        ],
        "imageUrl": "https://cbu01.alicdn.com/...",
        "detailPage": "https://detail.1688.com/offer/123456789012345.html",
        "skuInfo": {
            "skuMap": {
                "颜色:黑色;容量:10000mAh": {
                    "skuId": "sku123",
                    "price": 45.00,
                    "stock": 3260
                }
            },
            "specs": [
                {"specId": "spec123", "name": "颜色", "values": [{"valueId": "v1", "name": "黑色"}]},
                {"specId": "spec456", "name": "容量", "values": [{"valueId": "v2", "name": "10000mAh"}]}
            ]
        },
        "amountOnSale": 5000,
        "status": "published",
        "shippingInfo": {
            "sendGoodsAddress": "广东省深圳市",
            "unitWeight": 0.25
        }
    },
    "success": true
}

# 按关键词搜索商品列表
params = {
    "method": "item_search",
    "q": "磁吸充电宝",
    "start_price": "20",
    "end_price": "50",
    "page": 1,
    "sort": "_sale"  # 按销量排序
}

{
    "result": [{
        "baseInfo": {
            "id": "196965465451498520",
            "status": "cancel",
            "totalAmount": 0.01,
            "buyerID": "b2b-1623492085",
            "sellerID": "b2b-1624747073"
        },
        "productItems": [{
            "productID": 574273466269,
            "name": "夏季亚麻九分裤...",
            "price": 39.9,
            "quantity": 1,
            "skuInfos": [
                {"name": "颜色", "value": "深灰色"},
                {"name": "尺码", "value": "3XL"}
            ]
        }],
        "receiverInfo": {
            "toFullName": "洪帮",
            "toArea": "浙江省 金华市 义乌市"
        }
    }]
}

sign = MD5( app_secret + 所有参数按 key 升序拼接 + app_secret ).upper()

import requests
import hashlib
import time
from urllib.parse import quote
APP_KEY = 'your_app_key'
APP_SECRET = 'your_app_secret'
ACCESS_TOKEN = 'your_access_token'
def generate_1688_sign(params, app_secret):
    """生成1688开放平台 MD5 签名"""
    # 过滤空值和 sign 字段
    filtered = {k: v for k, v in params.items() if v is not None and k != 'sign'}
    # 按 key 字典序升序排序
    sorted_params = sorted(filtered.items(), key=lambda x: x[0])
    # 拼接成 key+value 字符串
    param_str = ''.join([f"{k}{v}" for k, v in sorted_params])
    # 首尾拼接 app_secret
    sign_str = f"{app_secret}{param_str}{app_secret}"
    # MD5 大写
    return hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()
def get_product_detail(product_id):
    """获取1688商品详情"""
    timestamp = str(int(time.time() * 1000))
    
    params = {
        "access_token": ACCESS_TOKEN,
        "productID": product_id,
        "timestamp": timestamp,
        # 可选：字段过滤，减少返回体积
        # "fields": "subject,priceRanges,imageUrl,skuInfo,amountOnSale,status"
    }
    params["sign"] = generate_1688_sign(params, APP_SECRET)
    
    url = "https://gw.open.1688.com/openapi/param2/1/com.alibaba.product/alibaba.product.get"
    
    # URL 编码参数
    encoded_params = {k: quote(str(v)) for k, v in params.items()}
    
    response = requests.post(url, data=encoded_params, timeout=30)
    return response.json()
# 调用示例
result = get_product_detail(123456789012345)
print(result)

if 供应商.isFactory == True and 供应商.years >= 3:
    优先合作（工厂直供，价格谈判空间大）
if 商品.priceRanges[200件价] < 目标售价 * 0.3:
    毛利空间充足，可纳入备选
if 商品.amountOnSale > 5000:
    库存充足，短期断货风险低

海外用户下单 → 你的平台接收订单 → 调用1688接口创建采购单
    → 1688供应商发货到国内集货仓 → 你的仓库打包 → 跨境物流发往海外

def monitor_product(product_id, baseline_price, stock_threshold):
    """监控商品价格与库存"""
    data = get_product_detail(product_id)
    result = data.get('result', {})
    
    current_price = result.get('priceRanges', [{}])[0].get('price')
    current_stock = result.get('amountOnSale', 0)
    
    alerts = []
    if current_price and abs(current_price - baseline_price) / baseline_price > 0.05:
        alerts.append(f"价格变动超过5%！当前：{current_price}，基线：{baseline_price}")
    
    if current_stock < stock_threshold:
        alerts.append(f"库存低于安全线！当前：{current_stock}，阈值：{stock_threshold}")
    
    return alerts