---
title: "AliExpress"
description: "通过统一的商品平台结构提供 AliExpress 的数据：与所有平台相同的 `SearchResult` 和 `Product`，另有运费报价。"
---

> Every apinoa docs page as markdown: https://apinoa.com/llms.txt (all in one file: https://apinoa.com/llms-full.txt; this API family in one file: https://apinoa.com/docs/marketplace/llms.txt)

## 操作

| 操作 | 端点 | 返回 | 价格 |
|---|---|---|---|
| [Search](/docs/api-reference/aliexpress/search) | `GET \| POST /v1/aliexpress/search` | `SearchResult` | $0.001 |
| [Image Search](/docs/api-reference/aliexpress/image-search) | `POST /v1/aliexpress/image-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 |
| [Product](/docs/api-reference/aliexpress/product) | `GET \| POST /v1/aliexpress/product` | `Product` | $0.001–$0.002 |
| [Shipping](/docs/api-reference/aliexpress/shipping) | `GET \| POST /v1/aliexpress/shipping` | `ShippingQuote` | $0.001–$0.002 |

AliExpress 的旧端点（`/aliexpress/keyword-search`、`/aliexpress/product-details` 和不带版本的 `/aliexpress/image-search`）已弃用，且没有 `v1` URL；各自的替代端点见 [Versioning](/docs/versioning)。

## AliExpress特有之处

**变体无法单独获取。** 尺码或颜色是同一个商品内部的 SKU，所以 `variant.productId` 缺失——一次调用就能拿到
整个变体矩阵，含每个 SKU 的价格与库存数量 `stock`（数字）。变体的 `id` 是AliExpress的数字 SKU id，也就是 `shipping`
接受的值。

**一个商品只有一个 id。** AliExpress对部分商品有两种写法（关键词搜索里是 `3256…`，其他地方是 `1005…`）。所有响应
都统一使用全局的 `1005…` 形式；两种形式都可作为输入。

**运费是按需报价。** `product?include=shipping` 会加上 `delivery`（发往 `region` 最便宜的选项）和
`shippingOptions`（全部选项）；[shipping](/docs/api-reference/aliexpress/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`），但没有逐条评价。