Amazon
通过统一的商品平台结构提供 16 个 Amazon 站点的数据。用 `region` 选择站点,价格以该站点的币种返回。
操作
| 操作 | 端点 | 返回 | 价格 |
|---|---|---|---|
| Search | GET | POST /v1/amazon/search | SearchResult | $0.001–$0.002 |
| Image Search | POST /v1/amazon/image-search | SearchResult | $0.001–$0.002 |
| Browse | GET | POST /v1/amazon/browse | SearchResult | $0.001–$0.002 |
| Categories | GET | POST /v1/amazon/categories | CategoryList | $0.001 |
| 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 是
名正言顺的 [],而不是缺失。