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

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

| | 端点 | 返回 | 价格 |
|---|---|---|---|
| [search](/docs/api-reference/aliexpress/search) | `GET\|POST /v1/aliexpress/search` | `SearchResult` | $0.001 |
| [browse](/docs/api-reference/aliexpress/browse) | `GET\|POST /v1/aliexpress/browse` | `SearchResult` | $0.001 |
| [categories](/docs/api-reference/aliexpress/categories) | `GET\|POST /v1/aliexpress/categories` | `CategoryList` | $0.001 |
| [image-search](/docs/api-reference/aliexpress/image-search) | `POST /v1/aliexpress/image-search` | `SearchResult` | $0.001 |
| [product](/docs/api-reference/aliexpress/product) | `GET\|POST /v1/aliexpress/product` | `Product` | $0.001 |

更早的那些端点——`/aliexpress/keyword-search`、`/aliexpress/product-details`、
`/aliexpress/image-search`——仍然照常响应，但已**弃用**，没有 v1 地址，并将于 **2026 年 10 月 20 日**
停止服务。它们不再被文档收录：请从这里开始。如果你正在迁移，[版本管理](/docs/versioning)里有改名对照表。

**`/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`），但没有逐条评价。