速卖通商品详情接口调用指南 | 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 = "api.aliexpress.com/item/get_de…"

   构建请求参数

   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": ["image1.jpg", "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 }