Apinoa Docs

Amazon

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

查看原始 .mdx

操作

操作端点返回价格
SearchGET | POST /v1/amazon/searchSearchResult$0.001–$0.002
Image SearchPOST /v1/amazon/image-searchSearchResult$0.001–$0.002
BrowseGET | POST /v1/amazon/browseSearchResult$0.001–$0.002
CategoriesGET | POST /v1/amazon/categoriesCategoryList$0.001
ProductGET | POST /v1/amazon/productProduct$0.002–$0.032

没有 reviews:Amazon评价无法提供。

站点

region站点货币
US (默认)amazon.comUSD
CAamazon.caCAD
MXamazon.com.mxMXN
BRamazon.com.brBRL
FRamazon.frEUR
ITamazon.itEUR
ESamazon.esEUR
NLamazon.nlEUR
SEamazon.seSEK
TRamazon.com.trTRY
AEamazon.aeAED
SAamazon.saSAR
INamazon.inINR
JPamazon.co.jpJPY
SGamazon.sgSGD
AUamazon.com.auAUD

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

  • 语言。 文本字段(标题、配送和库存说明)在站点提供英文时以英文返回。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%

商品

字段填充率
title100%
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 是 名正言顺的 [],而不是缺失。

本页内容