速卖通关键词搜索API开发指南

一、接口基础

速卖通开放平台提供/api/products/search接口，支持通过关键词获取商品列表。主要参数包括：

keywords：搜索关键词（需URL编码）

categoryId：类目筛选

minPrice/maxPrice：价格区间

sort：排序方式（默认"sale_num_desc"）

点击获取key和secret

二、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次/秒）

敏感词（如品牌名）可能被过滤

建议使用海外服务器调用避免地域限制