Amazon
Amazon on sixteen marketplaces, through the shared marketplace schema. Pick a marketplace with `region`; prices come back in its own currency.
Operations
| Operation | Endpoint | Returns | Price |
|---|---|---|---|
| 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 |
No reviews: Amazon reviews are not available.
Marketplaces
region | site | currency |
|---|---|---|
US (default) | 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 |
Every operation works on every marketplace, with three differences worth knowing:
- Language. Text fields (titles, delivery and stock lines) come back in English wherever the site offers it. amazon.com.mx, amazon.com.br and amazon.com.tr serve only Spanish, Portuguese and Turkish, so their text fields arrive in that language; prices, ratings, review counts and free-delivery flags are normalized the same as everywhere else.
- amazon.fr does not accept
ratingMin,brands,facetsorinclude=facets(a 400 names the parameter), and itsbrowseresults carry nofacets. - Category ids are per marketplace. A browse node from
categorieson one marketplace means nothing on another; walkcategorieswith the sameregionyou browse with.
The fill rates below were measured on amazon.com.
What Actually Arrives
The schema says these are optional. Here is how often Amazon fills them:
search items
| Field | Fill |
|---|---|
title url | ~99% |
imageUrl | ~98% |
price | ~90% |
rating.average rating.count | ~90% |
delivery | ~80% |
shippingOptions (the second, faster option) | ~70% |
salesLabel | ~50% |
product
| Field | Fill |
|---|---|
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 is the richest of the marketplaces on the detail view — reviewSummary, reviewAspects,
rating.distribution and offers arrive here and mostly nowhere else. price is not 100% because a
listing can genuinely have no current offer; that is an absent price, never a zero.
Things Specific to Amazon
Variants are separately fetchable. Each colour or size is its own ASIN, so every variant carries a
productId you can pass back to product, and groupId names the family. Shopify and Walmart work the
other way.
A rating may describe the family, not the variant. Every sibling of a variation family reports the
same aggregate — measured, 62 variants of one shirt all reporting 4.6 / 334,685. Where that is detected
the response sets rating.grouped: true.
Brand-store pages carry no category. Apple and Amazon-device pages have no breadcrumb and no Best
Sellers Rank, so category is legitimately [] rather than missing.