商品
亚马逊商品——接受的参数与返回的内容。
GET|POST /v1/amazon/productPrice $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; 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. |
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
会说明实际取到了哪些扩展;你请求了却没出现在里面的,并不是被悄悄当成"一条也没有"。