# @bizon/amazon-ids

> Collection of Amazon identifiers

Latest version **6.0.0** (published 2026-07-31) · MIT license · 0 weekly downloads

## Install

```sh
npm install @bizon/amazon-ids
pnpm add @bizon/amazon-ids
yarn add @bizon/amazon-ids
bun add @bizon/amazon-ids
```

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 6.0.0 |
| Published | 2026-07-31 |
| First published | 2019-07-10 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 86.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 14 |
| Author | Bertrand Marron |
| Maintainers | tusbar |
| Keywords | amazon, sellercentral, vendorcentral, marketplaces |

## Links

- npm: https://www.npmjs.com/package/@bizon/amazon-ids
- Repository: https://github.com/bizon/amazon-ids
- Homepage: https://github.com/bizon/amazon-ids#readme
- Issues: https://github.com/bizon/amazon-ids/issues
- npm.io page: https://npm.io/package/@bizon/amazon-ids

## Alternatives

- [jsforce](https://npm.io/package/jsforce.md) — 851.2K weekly downloads
- [react-native-qrcode-svg](https://npm.io/package/react-native-qrcode-svg.md) — 693.5K weekly downloads
- [@salesforce/plugin-data](https://npm.io/package/@salesforce/plugin-data.md) — 394.9K weekly downloads
- [@backstage/plugin-search-common](https://npm.io/package/@backstage/plugin-search-common.md) — 308.5K weekly downloads
- [@chain-registry/types](https://npm.io/package/@chain-registry/types.md) — 38.4K weekly downloads

## Recent versions

- 6.0.0 (latest) — 2026-07-31
- 5.0.1 — 2026-01-07
- 5.0.0 — 2025-03-27
- 4.2.3 — 2025-03-18
- 4.2.2 — 2024-11-12
- 4.2.1 — 2024-05-10
- 4.2.0 — 2024-04-26
- 4.1.0 — 2024-03-29
- 4.0.0 — 2023-05-29
- 3.0.0 — 2023-05-06
- 2.14.0 — 2022-10-18
- 2.13.0 — 2022-09-29
- 2.12.1 — 2022-07-03
- 2.12.0 — 2022-05-27
- 2.11.2 — 2022-05-17
- … 31 more at https://npm.io/package/@bizon/amazon-ids/versions

## README

# @bizon/amazon-ids

[![npm version](https://img.shields.io/npm/v/@bizon/amazon-ids)](https://www.npmjs.com/package/@bizon/amazon-ids)
[![codecov](https://codecov.io/github/bizon/amazon-ids/graph/badge.svg?token=U6I6anuPfw)](https://codecov.io/github/bizon/amazon-ids)
[![XO code style](https://img.shields.io/badge/code_style-xo-cyan)](https://github.com/xojs/xo)

Collection of Amazon identifiers

[<img src="https://files.bizon.solutions/images/logo/bizon-horizontal.png" alt="Bizon" width="250"/>](https://www.bizon.solutions?utm_source=github&utm_medium=readme&utm_campaign=amazon-ids)

## CI

[![Tests](https://github.com/bizon/amazon-ids/actions/workflows/tests.yml/badge.svg)](https://github.com/bizon/amazon-ids/actions/workflows/tests.yml)
[![Release](https://github.com/bizon/amazon-ids/actions/workflows/release.yml/badge.svg)](https://github.com/bizon/amazon-ids/actions/workflows/release.yml)

## Getting started

```bash
npm install --save @bizon/amazon-ids
```

## API

All three lookup functions are overloaded: passing a known literal (or a value typed
with one of the unions below) returns a `Marketplace`, while passing an arbitrary
`string` returns `Marketplace | undefined`.

```ts
import {getMarketplaceByCode, type MarketplaceCode} from '@bizon/amazon-ids'

getMarketplaceByCode('fr').domain // Marketplace — no optional chaining needed
getMarketplaceByCode(someString)?.domain // Marketplace | undefined
```

The exported unions are `MarketplaceCode`, `MarketplaceId`, `MarketplaceRegion` and
`MarketplaceDomain`. `MarketplaceCode` and `MarketplaceDomain` only cover the
marketplaces served by an Amazon storefront — the multi-channel (`*-non-amazon`),
invoicing and Amazon Pay entries have no domain, so their codes are not part of the
union and looking them up returns `Marketplace | undefined`.

### `marketplaces`

```js
import {marketplaces} from '@bizon/amazon-ids'

for (const marketplace of marketplaces) {
  // console.log(marketplace)
}
```

### `getMarketplaceById(id)`

```js
import {getMarketplaceById} from '@bizon/amazon-ids'

getMarketplaceById('ATVPDKIKX0DER')

/*
{
  code: 'us',
  id: 'ATVPDKIKX0DER',
  name: 'United States',
  region: 'na',
  domain: 'amazon.com',
  advertisingApiDomain: 'advertising-api.amazon.com',
  imagesDomain: 'images-na.ssl-images-amazon.com',
  vendorId: 'ATVPDKIKX0DER',
  sellerCentralDomain: 'sellercentral.amazon.com',
  vendorCentralDomain: 'vendorcentral.amazon.com',
  currencyCode: 'USD'
}
*/
```

It’s also possible to find multi-channel marketplaces:

```js
getMarketplaceById('A2ZV50J4W1RKNI')

/*
{
  code: 'us-non-amazon',
  id: 'A2ZV50J4W1RKNI',
  name: 'United States - Non-Amazon',
  region: 'na',
  currencyCode: 'USD'
}
*/
```

### `getMarketplaceByCode(code)`

```js
import {getMarketplaceByCode} from '@bizon/amazon-ids'

getMarketplaceByCode('DE')

/*
{
  code: 'de',
  id: 'A1PA6795UKMFR9',
  name: 'Germany',
  region: 'eu',
  domain: 'amazon.de',
  advertisingApiDomain: 'advertising-api-eu.amazon.com',
  imagesDomain: 'images-eu.ssl-images-amazon.com',
  vendorId: 'A3JWKAKR8XB7XF',
  sellerCentralDomain: 'sellercentral-europe.amazon.com',
  vendorCentralDomain: 'vendorcentral.amazon.de',
  currencyCode: 'EUR'
}
*/
```

### `getMarketplaceByDomain(domain)`

```js
import {getMarketplaceByDomain} from '@bizon/amazon-ids'

getMarketplaceByDomain('Amazon.com.mx')

/*
{
  code: 'mx',
  id: 'A1AM78C64UM0Y8',
  name: 'Mexico',
  region: 'na',
  domain: 'amazon.com.mx',
  imagesDomain: 'images-na.ssl-images-amazon.com',
  vendorId: 'AVDBXBAVVSXLQ',
  sellerCentralDomain: 'sellercentral.amazon.com.mx',
  vendorCentralDomain: 'vendorcentral.amazon.com.mx',
  currencyCode: 'MXN'
}
*/
```

## License

MIT

## Miscellaneous

```text
    ╚⊙ ⊙╝
  ╚═(███)═╝
 ╚═(███)═╝
╚═(███)═╝
 ╚═(███)═╝
  ╚═(███)═╝
   ╚═(███)═╝
```

---
_Source: https://npm.io/package/@bizon/amazon-ids · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._