一、接口基础
速卖通开放平台提供/api/products/search接口，支持通过关键词获取商品列表。主要参数包括：
keywords：搜索关键词（需URL编码）
categoryId：类目筛选
minPrice/maxPrice：价格区间
sort：排序方式（默认"sale_num_desc"）
二、Python调用示例
import requests
import urllib.parse
def search_aliexpress(keyword):
API_URL = "https://api.aliexpress.com/api/products/search"
APP_KEY = "your_app_key" # 替换为实际值
params = {
"keywords": urllib.parse.quote(keyword),
"sort": "sale_num_desc",
"pageSize": 50,
"app_key": APP_KEY
}
try:
response = requests.get(API_URL, params=params)
response.raise_for_status()
return response.json()["result"]["products"]
except Exception as e:
print(f"API调用失败: {str(e)}")
return []
# 调用示例
products = search_aliexpress("wireless earphone")
for product in products[:3]:
print(f"{product['title']} - ${product['price']}")
三、关键技术要点
签名认证：需按文档生成sign参数（示例代码省略）
分页处理：通过pageNo参数实现，建议单页不超过100条
错误处理：特别注意code=1006表示关键词违规
性能优化：
使用本地缓存高频关键词结果
设置请求超时（建议5-10秒）
异步请求多个关键词时控制并发量
四、返回数据结构
典型响应字段：
{
"productId": "123456",
"title": "Wireless Bluetooth Earphone",
"price": 15.99,
"soldCnt": 5000,
"storeName": "XYZ Store",
"imageUrl": "..."
}
五、注意事项
需提前申请开发者账号并创建应用
免费版API有QPS限制（通常5次/秒）
敏感词（如品牌名）可能被过滤
建议使用海外服务器调用避免地域限制
