速卖通商品详情接口调用指南 | 2025最新版Python代码实战

一、接口概述

‌时效性说明‌（基于当前时间：2025-02-25）
速卖通商品详情接口（Aliexpress Item Detail API）支持实时获取商品标题、价格、SKU、主图等核心数据，适用于商品比价、库存监控等场景。

二、接口调用流程
1. 准备工作
注册速卖通开放平台账号
创建应用并获取App Key和App Secret
申请商品详情接口权限
2. 认证鉴权
python
Copy Code
import requests
import hashlib
import time

app_key = "YOUR_APP_KEY"
app_secret = "YOUR_APP_SECRET"

# 生成签名
def generate_sign(params):
    params_str = '&'.join([f'{k}{v}' for k,v in sorted(params.items())])
    return hashlib.md5((params_str + app_secret).encode()).hexdigest().upper()

3. 接口调用示例
python
Copy Code
def get_item_detail(product_id):
    url = "https://api.aliexpress.com/item/get_detail"
    
    # 构建请求参数
    params = {
        "app_key": app_key,
        "method": "aliexpress.item.detail.get",
        "product_id": product_id,
        "timestamp": str(int(time.time() * 1000)),
        "format": "json",
        "v": "2.0"
    }
    
    # 添加签名
    params["sign"] = generate_sign(params)
    
    try:
        response = requests.get(url, params=params)
        response.raise_for_status()
        return response.json()
    except Exception as e:
        print(f"API Error: {str(e)}")
        return None

# 调用示例
item_data = get_item_detail("1234567890")
print(item_data)

三、关键参数说明
参数    类型    必需    说明
product_id    String    是    速卖通商品ID
country    String    否    目标国家（默认CN）
language    String    否    返回语言（默认en）
四、响应数据结构（核心字段）
json
Copy Code
{
  "aliexpress_item_get_response": {
    "item": {
      "title": "Wireless Bluetooth Headphones",
      "sku_list": [
        {
          "sku_id": "001",
          "price": "29.99",
          "specs": "Black"
        }
      ],
      "main_images": ["https://image1.jpg", "https://image2.jpg"],
      "logistics_info": {
        "delivery_time": "15",
        "ship_from": "CN"
      }
    }
  }
}

五、注意事项
‌频率限制‌：单应用默认500次/分钟
‌错误代码‌：
20010000：请求成功
20010001：签名错误
‌数据缓存‌：建议本地缓存高频商品数据
‌2025年更新‌：新增logistics_info.ship_from字段
六、最佳实践
python
Copy Code
# 数据解析示例
def parse_item_data(response):
    item = response.get("aliexpress_item_get_response", {}).get("item", {})
    return {
        "title": item.get("title"),
        "min_price": min([float(sku["price"]) for sku in item.get("sku_list", [])]),
        "main_image": item.get("main_images", []) if item.get("main_images") else None
    }