# 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**

> 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](/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`&#x20;

<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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ce-docs.keywordrush.com/modules/affiliate/amazon.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.