Multi-Marketplace Configuration

The Creators API in ASA2 supports a multi-marketplace architecture. This allows you to configure separate API credentials for each Amazon marketplace (country store).

Why Separate Credentials?

Unlike PA API 5.0 where a single set of credentials can access all marketplaces, the Creators API requires you to create credentials for each marketplace separately in Amazon Associates Central.

This approach provides:

  • Better account management: Each marketplace has its own tracking ID

  • Flexible control: Enable or disable specific marketplaces as needed

  • Gradual migration: Move from PA API to Creators API one marketplace at a time

Managing Multiple Marketplaces

Configured Marketplaces table

The Configured Marketplaces table shows all your configured marketplaces at a glance:

Marketplace

The country name (e.g., Germany, USA, United Kingdom).

Status

Shows Enabled (green) or Disabled (gray). Disabled marketplaces won’t use Creators API for product lookups.

API Version

The Creators API version being used (e.g., 2.2, 2.3). This is automatically determined by Amazon.

Partner Tag

Your Amazon Associates Tracking ID for this marketplace. Partially hidden for security.

Default

A star icon indicates the default marketplace. This marketplace is used when no specific country is selected.

Actions

  • Edit: Modify the credentials or settings

  • Delete: Remove the marketplace configuration

Adding a Marketplace

  1. Click the “+ Add Marketplace” button

  2. Select the marketplace from the dropdown

  3. Enter your Credential ID and Credential Secret

  4. Enter your Partner Tag (Tracking ID) for this marketplace

  5. Check “Enable Marketplace” to activate it

  6. Optionally check “Set as Default Marketplace”

  7. Click “Add Marketplace”

Add Marketplace form

Setting a Default Marketplace

The default marketplace is used when:

  • No specific country code is provided in a shortcode

  • A product’s country cannot be determined

  • You’re using features that don’t specify a marketplace

To set a default marketplace:

  1. Click “Edit” on the desired marketplace

  2. Check “Set as Default Marketplace”

  3. Save the changes

Only one marketplace can be the default. Setting a new default automatically removes the default status from the previous one.

Enabling and Disabling Marketplaces

You can temporarily disable a marketplace without deleting its credentials:

  1. Click “Edit” on the marketplace

  2. Uncheck “Enable Marketplace”

  3. Save the changes

When a marketplace is disabled:

  • ASA2 will use PA API 5.0 for products from that marketplace

  • The credentials remain stored and can be re-enabled later

  • Other marketplaces continue to use Creators API

This is useful for:

  • Troubleshooting issues with a specific marketplace

  • Temporarily switching back to PA API

  • Testing before fully enabling Creators API

API Routing Logic

When you request product data, ASA2 automatically determines which API to use based on this logic:

  1. Check the product’s marketplace (country code)

  2. Look for Creators API credentials for that marketplace

  3. If credentials exist and are enabled: Use Creators API

  4. Otherwise: Fall back to PA API 5.0

This means you can have a mixed setup where some marketplaces use Creators API while others use PA API.

Example configuration:

Marketplace

Creators API

API Used

Germany

Enabled

Creators API

United States

Enabled

Creators API

United Kingdom

Disabled

PA API 5.0

France

Not configured

PA API 5.0