---
title: "商品"
description: "亚马逊商品——接受的参数与返回的内容。"
---

```
GET|POST /v1/amazon/product
```

**Price** $0.001 per call, plus $0.001 for each extra call it makes — at most 30 more, so $0.031 in total. 只有 `include=offers` 会增加计费——每 10 条报价计 1 个单位，上限 30 页。不使用它时，一个商品就是一次调用。 [List price](https://apinoa.com/en/pricing); the rate steps down above 1,000 calls a day.

| Parameter | Type | Required | Notes |
|---|---|---|---|
| `id` | string | yes | The marketplace's own product id, as carried by a search item. |
| `include` | string |  | `offers` · `offers:5` · `offers:all` — the enumerated competing-seller offers, which are fetched separately and so opt-in. Depth counts pages of offers (10 offers each) and each page is charged; `all` walks to the end, capped at 30 pages. |
| `region` | string |  | Buyer country as ISO 3166-1 alpha-2; sets availability, shipping and price. |

```bash
curl "https://gateway.apinoa.com/v1/amazon/product?id=B01N171Q4M" -H "x-api-key: YOUR_API_KEY"
```

搜索条目的 `id` 就是 ASIN——无需中间查询，直接从搜索接到商品。

## include=offers

商品页会在 `offersSummary` 中给出一个汇总（"New & Used (305) from $2.07"）。逐条列出的报价需要显式
开启，并单独计费。

**按每 10 条报价一页计费**，最多 30 页。一条商品的报价有多深事先无从得知：有的 ASIN 一页就够，有的
要到三十页。

| | 价格 |
|---|---|
| 不带该参数 | $0.001 |
| `include=offers` | $0.002 |
| `include=offers:5` | 最高 $0.006 |
| `include=offers:all` | 最高 $0.031（上限 30 页） |

超过上限的深度会被截断而不是拒绝——`offers:999` 与 `offers:all` 是同一个请求。响应中的 `included`
会说明实际取到了哪些扩展；你请求了却没出现在里面的，并不是被悄悄当成"一条也没有"。