速卖通
以归一化结构提供的速卖通——与其他平台相同的操作、参数与响应形状。
速卖通有两套接口。本页说的是归一化的那一套——与亚马逊、eBay、Shopify 和沃尔玛返回的完全相同的
SearchResult 与 Product,因此一个解析器可以读懂全部五家。
| 端点 | 返回 | 价格 | |
|---|---|---|---|
| search | GET|POST /v1/aliexpress/search | SearchResult | $0.001 |
| browse | GET|POST /v1/aliexpress/browse | SearchResult | $0.001 |
| categories | GET|POST /v1/aliexpress/categories | CategoryList | $0.001 |
| image-search | POST /v1/aliexpress/image-search | SearchResult | $0.001 |
| product | GET|POST /v1/aliexpress/product | Product | $0.001 |
更早的那些端点——/aliexpress/keyword-search、/aliexpress/product-details、
/aliexpress/image-search——仍然照常响应,但已弃用,没有 v1 地址,并将于 2026 年 10 月 20 日
停止服务。它们不再被文档收录:请从这里开始。如果你正在迁移,版本管理里有改名对照表。
/v1/aliexpress/image-search 与 /aliexpress/image-search 是两个不同的端点。 带版本的那个是下文
所述的归一化以图搜图;不带版本的那个属于旧接口,其响应形状是速卖通自己的——同一个路径段,不同的响应体。
在 v1 之外,归一化的以图搜图沿用旧名 /aliexpress/visual-search,因为规范名称在那里已被占用;在 v1 之内
旧接口根本不存在,规范名称因此空了出来。
速卖通特有之处
变体无法单独获取。 尺码或颜色是同一个商品内部的 SKU,所以 variant.productId 缺失——一次调用就能拿到
整个变体矩阵,含每个 SKU 的价格与库存。
价格过滤器只要有一个变体命中即可。 速卖通的商品常常横跨一个价格区间,只要任意一个变体落在区间内,
该商品就会被匹配——而卡片报出的是最低的"起价"。因此 priceMin=40 的请求可能返回一行显示 $28、实际由它
$50 的变体命中的商品。返回行中约 90–95% 落在区间内;如果你需要严格边界,请自行对返回的 price 再过滤
一遍。
没有 reviews 操作。 商品带有汇总评分(rating.average 与 rating.count),但没有逐条评价。