# Amazon module

### Important notes before you start

#### API access required

This module requires **active Amazon API access** (Creators API / Product Advertising API access). 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)

If you are still using the **Product Advertising API** (PA-API 5.0): Amazon is moving key PA-API functionality to the new **Creators API**.

{% hint style="danger" %}
To keep prices, availability, and offer data updating smoothly, we strongly recommend switching to **Creators API** and adding your Credential ID and Credential Secret in the module settings before **January 30, 2026**.
{% 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**

> If you just created your API access, Amazon may take **24–48 hours** to fully activate it.

***

### 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](https://ce-docs.keywordrush.com/modules/affiliate/amazon-no-api-module) 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](https://ce-docs.keywordrush.com/affiliate-egg-integration#how-to-connect-ae-modules) with Content Egg.
3. **Offer module**\
   [Add any product manually](https://ce-docs.keywordrush.com/modules/affiliate/offermodule) (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`&#x20;

<div data-full-width="false"><figure><img src="https://4254262503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M3fnB7iKYwDc1Xhr3H3%2Fuploads%2FvhRRjTFQMDO2zyttNk0l%2Famazon-search-by-keywords.png?alt=media&#x26;token=bf67bbb2-610a-41e1-8e48-44bcfadc799b" alt=""><figcaption></figcaption></figure> <figure><img src="https://4254262503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M3fnB7iKYwDc1Xhr3H3%2Fuploads%2FSsFIiWoJewagWlR0WnX2%2Famazon-search-by-asins.png?alt=media&#x26;token=0e360ec4-19eb-4932-82ba-36f634933467" alt=""><figcaption></figcaption></figure></div>

<div><figure><img src="https://4254262503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M3fnB7iKYwDc1Xhr3H3%2Fuploads%2Fjcp2OKZxNJscMT7SdRB9%2Famazon-search-by-ean.png?alt=media&#x26;token=9ff1a808-3d22-4e01-8e26-f5725818a051" alt=""><figcaption></figcaption></figure> <figure><img src="https://4254262503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M3fnB7iKYwDc1Xhr3H3%2Fuploads%2FIIkLISSUqsXRGyL9Pgdc%2Famazon-search-by-product-url.png?alt=media&#x26;token=a07d64c7-4ce7-4cf7-869a-8bd2c1b3fa29" 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**](https://ce-docs.keywordrush.com/modules/cloning) 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**](#checkout-on-amazon-feature) 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