Apinoa Docs

商品

亚马逊商品——接受的参数与返回的内容。

查看原始 .mdx
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; the rate steps down above 1,000 calls a day.

ParameterTypeRequiredNotes
idstringyesThe marketplace's own product id, as carried by a search item.
includestringoffers · 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.
regionstringBuyer 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:999offers:all 是同一个请求。响应中的 included 会说明实际取到了哪些扩展;你请求了却没出现在里面的,并不是被悄悄当成"一条也没有"。

本页内容