速卖通获取商品详情的官方核心接口是:
aliexpress.item.get(旧版)与 aliexpress.solution.product.detail.get(新版 / 推荐)。一、核心详情接口(官方)
1. aliexpress.item.get(经典版)
用途:通过商品 ID 获取完整商品详情(单 ID 查询)。
核心参数:
product_id/item_id:商品 ID(必填)。fields:指定返回字段(如title,price,sku_property_list,shipping_info)。language:返回语言(如en_US、es_ES)。currency:货币类型(如USD、EUR)。返回字段:标题、价格、主图、SKU、库存、物流、描述、评价、促销等。
适用:通用详情获取、单品监控、ERP 同步。
2. aliexpress.solution.product.detail.get(新版 / 推荐)
用途:速卖通开放平台新版标准详情接口,结构更规范、跨境属性更完善。
核心参数:
product_id、language、currency。优势:字段更清晰、支持多语言 / 多币种、适配新平台规则。
适用:新应用开发、跨境多市场场景。
二、配套批量 / 搜索接口(获取 ID 后拉详情)
aliexpress.item.search:关键词 / 类目搜索,返回商品 ID 列表(批量获取 ID)。aliexpress.solution.product.search:新版搜索接口,支持分页、排序、筛选。aliexpress.item.get_app:移动端精简版详情,响应更快。
三、接口核心能力对比
表格
| 接口 | 版本 | 批量支持 | 核心字段 | 推荐度 |
|---|---|---|---|---|
aliexpress.item.get | 经典 | 单 ID | 全量详情(30 + 字段) | ★★★☆☆ |
aliexpress.solution.product.detail.get | 新版 | 单 ID | 规范结构化、多语言 / 币种 | ★★★★★ |
aliexpress.item.search | 经典 | 分页(≤100 / 页) | 基础列表(ID / 标题 / 价格) | ★★★★☆ |
四、接入要点
权限:需在速卖通开放平台创建应用,完成企业认证,申请商品数据权限。
限流:个人开发者约 100 次 / 天,企业约 500 次 / 天,QPS≤5。
批量策略:先用
item.search批量获取 ID,再循环调用item.get拉详情,控制请求间隔。字段精简:
fields只传需要的字段,提升效率、减少流量。
五、Python 调用示例(伪代码)
python
运行
# 调用新版详情接口def get_aliexpress_detail(product_id, app_key, app_secret):
api_url = "https://api.aliexpress.com/rest"
params = {
"method": "aliexpress.solution.product.detail.get",
"app_key": app_key,
"product_id": product_id,
"language": "en_US",
"currency": "USD",
# 签名、时间戳等参数(略)
}
# 签名与请求逻辑(略)
response = requests.get(api_url, params=params)
return response.json()