Apinoa Docs

速卖通

以归一化结构提供的速卖通——与其他平台相同的操作、参数与响应形状。

查看原始 .mdx

速卖通有两套接口。本页说的是归一化的那一套——与亚马逊、eBay、Shopify 和沃尔玛返回的完全相同的 SearchResultProduct,因此一个解析器可以读懂全部五家。

端点返回价格
searchGET|POST /v1/aliexpress/searchSearchResult$0.001
browseGET|POST /v1/aliexpress/browseSearchResult$0.001
categoriesGET|POST /v1/aliexpress/categoriesCategoryList$0.001
image-searchPOST /v1/aliexpress/image-searchSearchResult$0.001
productGET|POST /v1/aliexpress/productProduct$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.averagerating.count),但没有逐条评价。

本页内容