Skip to content
Screaming Data
Documentation menu

Guide

Marketplaces

12 Amazon marketplaces with the same request format and the same response shape. Pass the code in the marketplace field of any product or monitoring task.

Supported marketplaces

CodeMarketplaceCountryCurrencyLanguage
comamazon.comUnited StatesUSDEnglish (en)
ukamazon.co.ukUnited KingdomGBPEnglish (en)
deamazon.deGermanyEURGerman (de)
framazon.frFranceEURFrench (fr)
esamazon.esSpainEURSpanish (es)
itamazon.itItalyEURItalian (it)
nlamazon.nlNetherlandsEURDutch (nl)
caamazon.caCanadaCADEnglish (en)
auamazon.com.auAustraliaAUDEnglish (en)
jpamazon.co.jpJapanJPYJapanese (ja)
mxamazon.com.mxMexicoMXNSpanish (es)
inamazon.inIndiaINREnglish (en)

The same list is available from the API at GET /v1/appendix/marketplaces, and the health of each marketplace on the status page.

Aliases

These alternative codes are accepted on input and normalised in responses:

  • us → com
  • usa → com
  • gb → uk

Any other value fails the task with 40502 (Unknown marketplace).

Local data

  • Prices are returned in the marketplace currency; price.currency always states it.
  • Category names, variant labels and the labels of the product-details section are returned as the marketplace shows them: on de you get German category names and details keys such as hersteller.
  • An ASIN can exist on one marketplace and not on another. A missing product returns 40402 and is not charged.
  • Ranks are per marketplace: the same product has an independent Best Sellers Rank in each country.