AliExpress
通过统一的商品平台结构提供 AliExpress 的数据:与所有平台相同的 `SearchResult` 和 `Product`,另有运费报价。
操作
| 操作 | 端点 | 返回 | 价格 |
|---|---|---|---|
| Search | GET | POST /v1/aliexpress/search | SearchResult | $0.001 |
| Image Search | POST /v1/aliexpress/image-search | SearchResult | $0.001 |
| Browse | GET | POST /v1/aliexpress/browse | SearchResult | $0.001 |
| Categories | GET | POST /v1/aliexpress/categories | CategoryList | $0.001 |
| Product | GET | POST /v1/aliexpress/product | Product | $0.001–$0.002 |
| Shipping | GET | POST /v1/aliexpress/shipping | ShippingQuote | $0.001–$0.002 |
AliExpress 的旧端点(/aliexpress/keyword-search、/aliexpress/product-details 和不带版本的 /aliexpress/image-search)已弃用,且没有 v1 URL;各自的替代端点见 Versioning。
AliExpress特有之处
变体无法单独获取。 尺码或颜色是同一个商品内部的 SKU,所以 variant.productId 缺失——一次调用就能拿到
整个变体矩阵,含每个 SKU 的价格与库存数量 stock(数字)。变体的 id 是AliExpress的数字 SKU id,也就是 shipping
接受的值。
一个商品只有一个 id。 AliExpress对部分商品有两种写法(关键词搜索里是 3256…,其他地方是 1005…)。所有响应
都统一使用全局的 1005… 形式;两种形式都可作为输入。
运费是按需报价。 product?include=shipping 会加上 delivery(发往 region 最便宜的选项)和
shippingOptions(全部选项);shipping 可以单独为任意变体和数量报价。
不加时,delivery.handlingDays 仍会给出卖家发货所需的天数。
商品包含AliExpress给出的全部信息。 带名称的类目路径、package 重量(尺寸在包裹的 ext 中)、店铺的
country(三项店铺评分在卖家的 ext.detailedRatings 中)、每个变体的 purchaseLimit
(bulkPrice 与 taxIncluded 在变体的 ext 中),以及商品 ext 中的 wholesale。价格默认以美元计。
价格过滤器只要有一个变体命中即可。 AliExpress的商品常常横跨一个价格区间,只要任意一个变体落在区间内,
该商品就会被匹配——而卡片报出的是最低的"起价"。因此 priceMin=40 的请求可能返回一行显示 $28、实际由它
$50 的变体命中的商品。返回行中约 90–95% 落在区间内;如果你需要严格边界,请自行对返回的 price 再过滤
一遍。
没有 reviews 操作。 商品带有汇总评分(rating.average 与 rating.count),但没有逐条评价。