Skip to content
Screaming Data
Documentation menu

Appendix API

Marketplaces

The 12 supported Amazon marketplaces with domain, currency and language.

GET
https://api.screamingdata.dev/v1/appendix/marketplaces
Authentication
Optional
Cost
Free
Body
No request body

Overview

Returns the supported marketplaces and the codes and aliases accepted in requests. See also Marketplaces.

An API key is optional. Requests that send one are metered and rate-limited like any other call.

Cost

Free.

Request

GET /v1/appendix/marketplaces.

This endpoint takes no parameters.

Request example

An API key is optional for this endpoint, so the examples omit it. Requests that send one are metered like any other call.

curl --request GET \
  --url "https://api.screamingdata.dev/v1/appendix/marketplaces"

Response

HTTP 200. The body is the standard response envelope; check status_code at the top level and in every task.

Response example
{
  "version": "1.0.0",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.0071 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "09241252-5d3a-4f7c-8e2b-9a1c6f4e0d73",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0008 sec.",
      "cost": 0,
      "result_count": 12,
      "path": [
        "v1",
        "appendix",
        "marketplaces"
      ],
      "data": {
        "api": "appendix",
        "function": "marketplaces"
      },
      "result": [
        {
          "code": "com",
          "domain": "amazon.com",
          "name": "United States",
          "country_code": "US",
          "currency": "USD",
          "language": "en",
          "language_name": "English",
          "aliases": [
            "us",
            "usa"
          ]
        },
        {
          "code": "uk",
          "domain": "amazon.co.uk",
          "name": "United Kingdom",
          "country_code": "GB",
          "currency": "GBP",
          "language": "en",
          "language_name": "English",
          "aliases": [
            "gb"
          ]
        },
        {
          "code": "de",
          "domain": "amazon.de",
          "name": "Germany",
          "country_code": "DE",
          "currency": "EUR",
          "language": "de",
          "language_name": "German",
          "aliases": []
        },
        {
          "code": "fr",
          "domain": "amazon.fr",
          "name": "France",
          "country_code": "FR",
          "currency": "EUR",
          "language": "fr",
          "language_name": "French",
          "aliases": []
        },
        {
          "code": "es",
          "domain": "amazon.es",
          "name": "Spain",
          "country_code": "ES",
          "currency": "EUR",
          "language": "es",
          "language_name": "Spanish",
          "aliases": []
        },
        {
          "code": "it",
          "domain": "amazon.it",
          "name": "Italy",
          "country_code": "IT",
          "currency": "EUR",
          "language": "it",
          "language_name": "Italian",
          "aliases": []
        },
        {
          "code": "nl",
          "domain": "amazon.nl",
          "name": "Netherlands",
          "country_code": "NL",
          "currency": "EUR",
          "language": "nl",
          "language_name": "Dutch",
          "aliases": []
        },
        {
          "code": "ca",
          "domain": "amazon.ca",
          "name": "Canada",
          "country_code": "CA",
          "currency": "CAD",
          "language": "en",
          "language_name": "English",
          "aliases": []
        },
        {
          "code": "au",
          "domain": "amazon.com.au",
          "name": "Australia",
          "country_code": "AU",
          "currency": "AUD",
          "language": "en",
          "language_name": "English",
          "aliases": []
        },
        {
          "code": "jp",
          "domain": "amazon.co.jp",
          "name": "Japan",
          "country_code": "JP",
          "currency": "JPY",
          "language": "ja",
          "language_name": "Japanese",
          "aliases": []
        },
        {
          "code": "mx",
          "domain": "amazon.com.mx",
          "name": "Mexico",
          "country_code": "MX",
          "currency": "MXN",
          "language": "es",
          "language_name": "Spanish",
          "aliases": []
        },
        {
          "code": "in",
          "domain": "amazon.in",
          "name": "India",
          "country_code": "IN",
          "currency": "INR",
          "language": "en",
          "language_name": "English",
          "aliases": []
        }
      ]
    }
  ]
}

Result fields

Each element of tasks[].result is a marketplace object. A supported Amazon marketplace.

code
string

Code used in requests.

domain
string

Amazon domain.

name
string

Country name.

country_code
string

ISO 3166-1 alpha-2 country code.

currency
string

ISO 4217 currency of prices on this marketplace.

language
string

ISO 639-1 code of the main storefront language.

language_name
string

Name of that language.

aliases
array of strings

Other codes accepted on input.

Status codes

Codes this endpoint can return, at the request or task level. See Status codes for handling advice.

CodeMessageHTTPLevelWhen
20000Ok.200Request / taskThe request, or the individual task, was processed successfully.
40100Authentication failed.401RequestThe Authorization header is missing or malformed, or the login and API key do not match.
40101API key revoked.401RequestThe API key was revoked. Use another active key or create a new one.
40102Account disabled.401RequestThe account is disabled. Contact support.
40202Rate limit exceeded.429RequestToo many requests or tasks per minute for this account, or too many access requests from one IP address. The Retry-After header says how many seconds to wait.
50000Internal error.500RequestUnexpected server error. The request can be retried; contact support if it persists.