---
title: "Amazon"
description: "通过统一的商品平台结构提供 16 个 Amazon 站点的数据。用 `region` 选择站点，价格以该站点的币种返回。"
---

## 操作

| 操作 | 端点 | 返回 | 价格 |
|---|---|---|---|
| [Search](/docs/api-reference/amazon/search) | `GET \| POST /v1/amazon/search` | `SearchResult` | $0.001–$0.002 |
| [Image Search](/docs/api-reference/amazon/image-search) | `POST /v1/amazon/image-search` | `SearchResult` | $0.001–$0.002 |
| [Browse](/docs/api-reference/amazon/browse) | `GET \| POST /v1/amazon/browse` | `SearchResult` | $0.001–$0.002 |
| [Categories](/docs/api-reference/amazon/categories) | `GET \| POST /v1/amazon/categories` | `CategoryList` | $0.001 |
| [Product](/docs/api-reference/amazon/product) | `GET \| POST /v1/amazon/product` | `Product` | $0.002–$0.032 |

没有 `reviews`：Amazon评价无法提供。

## 站点

| `region` | 站点 | 货币 |
|---|---|---|
| `US` （默认） | amazon.com | USD |
| `CA` | amazon.ca | CAD |
| `MX` | amazon.com.mx | MXN |
| `BR` | amazon.com.br | BRL |
| `FR` | amazon.fr | EUR |
| `IT` | amazon.it | EUR |
| `ES` | amazon.es | EUR |
| `NL` | amazon.nl | EUR |
| `SE` | amazon.se | SEK |
| `TR` | amazon.com.tr | TRY |
| `AE` | amazon.ae | AED |
| `SA` | amazon.sa | SAR |
| `IN` | amazon.in | INR |
| `JP` | amazon.co.jp | JPY |
| `SG` | amazon.sg | SGD |
| `AU` | amazon.com.au | AUD |

每个操作在每个站点都可用，有三点差异值得注意：

- **语言。** 文本字段（标题、配送和库存说明）在站点提供英文时以英文返回。amazon.com.mx、amazon.com.br
  和 amazon.com.tr 只提供西班牙语、葡萄牙语和土耳其语，因此其文本字段以该语言返回；价格、评分、评价数和
  免运费标志与其他站点一样归一化。
- **amazon.fr** 不接受 `ratingMin`、`brands`、`facets` 或 `include=facets`（返回指明参数的 400），其
  `browse` 结果不含 `facets`。
- **类目 id 按站点区分。** 一个站点 `categories` 返回的浏览节点在另一个站点没有意义；请用与 browse 相同的
  `region` 遍历 `categories`。

以下填充率在 amazon.com 上测得。

## 实际会返回什么

结构上这些字段都是可选的。以下是Amazon实际填充它们的比例：

**搜索条目**

| 字段 | 填充率 |
|---|---|
| `title` `url` | ~99% |
| `imageUrl` | ~98% |
| `price` | ~90% |
| `rating.average` `rating.count` | ~90% |
| `delivery` | ~80% |
| `shippingOptions`（第二个更快的选项） | ~70% |
| `salesLabel` | ~50% |

**商品**

| 字段 | 填充率 |
|---|---|
| `title` | 100% |
| `media.images` | ~95% |
| `brand` `rating.average` `rating.distribution` `features` `description` `attributes` `reviews` | ~90% |
| `price` `status` `seller.name` | ~85% |
| `category` `delivery` `groupId` `offers` | ~80% |
| `reviewSummary` `returnsPolicy` | ~70% |
| `reviewAspects` `brandUrl` | ~60% |

在详情页上Amazon是这几个平台中内容最丰富的——`reviewSummary`、`reviewAspects`、
`rating.distribution` 与 `offers` 基本只在这里出现。`price` 不是 100%，是因为一条商品确实可能当前没有
任何在售报价；那是 `price` 缺失，而不是 0。

## Amazon特有之处

**变体可以单独获取。** 每一种颜色或尺码都有自己的 ASIN，因此每个 `variant` 都带有可直接回传给
`product` 的 `productId`，而 `groupId` 指明所属系列。Shopify 与Walmart正好相反。

**评分可能描述的是整个系列，而不是这一个变体。** 一个变体系列中的所有成员会报出同一个汇总——实测中一件
衬衫的 62 个变体全部报出 4.6 / 334,685。检测到这种情况时，响应会设置 `rating.grouped: true`。

**品牌旗舰店页面没有类目。** Apple 与Amazon自有设备的页面既无面包屑也无畅销排名，因此 `category` 是
名正言顺的 `[]`，而不是缺失。