> For the complete documentation index, see [llms.txt](https://ce-docs.keywordrush.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ce-docs.keywordrush.com/modules/affiliate/amazon.md).

# Amazon module

### Important notes before you start

#### API access required

This module requires **active Amazon API access** (Creators API). If you don’t have API access yet, see [Alternatives to Amazon API](#alternatives-to-amazon-api-no-api-access-required) below.

#### Migration warning (PA-API → Creators API)

{% hint style="danger" %}
**Amazon API — friendly reminder**

Amazon is retiring the PA API and switching to the Creators API. **Deadline: April 30, 2026.**\
If you haven't done so yet, generate your Creators API credentials and add them in the Amazon module settings.
{% endhint %}

Read the full migration guide:\
<https://www.keywordrush.com/blog/amazon-creator-api-what-changed-and-how-to-switch/>

***

### What you need

To use the Amazon module, you need:

1. **Associate Tag (Partner Tag)**
2. **Creators API credentials**: **Credential ID** + **Credential Secret**

{% hint style="info" %}
If you just created your API access, Amazon may take **24–48 hours** to fully activate it.
{% endhint %}

***

### How to get your Associate Tag

To obtain an Associate Tag, follow [Amazon’s guide](https://affiliate-program.amazon.com/creatorsapi/docs/en-us/onboarding/sign-up-as-an-amazon-associate).

***

### How to get Credential ID and Credential Secret (Creators API)

Follow Amazon’s “[Register for Creators API](https://affiliate-program.amazon.com/creatorsapi/docs/en-us/onboarding/register-for-creators-api)” guide.

After you create credentials:

* Credential Secret is shown only once (store it safely).
* Use the credentials in Content Egg → Modules → Amazon.

***

### Alternatives to Amazon API (no API access required)

If you don’t have API access, Content Egg still offers ways to add Amazon products:

1. **NoAPI Amazon module**\
   Start with the [NoAPI module](/modules/affiliate/amazon-no-api-module.md) to publish links quickly and generate initial sales. Once you get API access, you can migrate to the Amazon API module.
2. **Affiliate Egg integration**\
   Use the [Affiliate Egg plugin](https://www.keywordrush.com/affiliateegg) (direct parsing without Amazon API) and [connect it](/modules/affiliate-egg-integration.md#how-to-connect-ae-modules) with Content Egg.
3. **Offer module**\
   [Add any product manually](/modules/affiliate/offermodule.md) (works for any store, including Amazon).

***

### Searching for products

Content Egg’s Amazon module supports several search methods. You can use whichever is most convenient for your workflow:

* **Keywords**\
  Search by product name, brand, model, or any query (for example: `wireless earbuds`, `Ryzen 7 laptop`, `LEGO Technic`).
* **ASINs**\
  Search by one ASIN or multiple ASINs separated by commas (useful when you already know exact product IDs).
* **EANs**\
  Search by one or multiple EAN/GTIN codes. Multiple EANs should be separated by commas.
* **Direct product URLs**\
  Paste an Amazon product URL (Content Egg will extract the ASIN automatically and fetch the product).
* **Category (node) URLs**\
  Paste a URL that contains a **browse node** parameter in the format: `node=XXX`\
  Example: a category link where the URL includes `?node=123456789`

<div data-full-width="false"><figure><img src="/files/8SccBrxlikEZupb5fVks" alt=""><figcaption></figcaption></figure> <figure><img src="/files/Oyp53I7fSzKmOVpTYH1K" alt=""><figcaption></figcaption></figure></div>

<div><figure><img src="/files/N9s4zgrmWbx75ySfIpC4" alt=""><figcaption></figcaption></figure> <figure><img src="/files/g76CoCGtIx6W8UpcgfcF" alt=""><figcaption></figcaption></figure></div>

***

### Amazon multi-locale setup (best practices)

Amazon has multiple marketplaces (US, UK, DE, etc.). There are three common ways to handle this.

#### 1) Amazon OneLink (recommended)

Amazon OneLink allows you to link multiple Amazon Associate accounts. Visitors are redirected to their local (or nearest) Amazon store automatically.

* Easiest setup
* No extra scripts required (you simply link accounts)
* Great for international traffic

Configure OneLink here:\
<https://affiliate-program.amazon.com/onelink>

#### 2) Module cloning (one module per locale)

Use Content Egg [**Module cloning**](/modules/cloning.md) to create a separate Amazon module per marketplace. This lets you:

* Import products from multiple locales
* Let visitors choose which marketplace to buy from

**Video guide** (OneLink vs module cloning):\
<https://www.youtube.com/watch?v=LWA4V-qKZ3s>

#### 3) Locale parameter + (optional) GeoIP plugins

Use one Amazon module and set **Associate Tags for multiple locales** in settings.

When searching in the post editor, choose the marketplace/locale for the search. Then display marketplace-specific products with a shortcode locale filter:

```
[content-egg module=Amazon locale=US]
```

**Note:** Content Egg does not include built-in GeoIP detection. You can combine it with a third-party plugin that supports shortcodes, for example **GeoIP Detection**.

Example (show US products only to US visitors):

```
[geoip_detect2_show_if country="US"]
[content-egg module=Amazon locale=US]
[/geoip_detect2_show_if]
```

Video guide (GeoIP + locale filtering):\
<https://www.youtube.com/watch?v=M8tQztVGkzY>

***

### Checkout on Amazon feature

The [**Checkout on Amazon**](/faq/checkout-on-amazon-feature.md) feature allows visitors to add Amazon products to a local WooCommerce cart and complete the purchase directly on Amazon.

***

### Troubleshooting

#### “AssociateNotEligible” error (403)

Error message:\
`AssociateNotEligible (403) – Your account does not currently meet the eligibility requirements to access the Product Advertising API.`

Amazon requires **10 qualified sales in the last 30 days** to gain/keep PA-API access.

More details:\
<https://www.keywordrush.com/blog/amazon-pa-api-associatenoteligible-error-is-there-a-new-10-sales-rule/>

#### Amazon Associates support

For Amazon Associates account issues:

* Go to Amazon Associates → **Help** → **Contact Us**
* Choose **Creators API** in the Subject dropdown
