> 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

The Amazon module lets you search and import products from Amazon Associates into Content Egg, keep product data up to date, and display them with Product Blocks and shortcodes.

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

***

### 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="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&amp;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&amp;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&amp;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&amp;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.

Before choosing one, it helps to know which marketplaces your API credentials can query. See [Which marketplaces a credential covers](#which-marketplaces-a-credential-covers) at the end of this section.

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

{% hint style="info" %}
**US Associates already have this.** In August 2026 Amazon enabled **Global Earning** for all US creators automatically. US links now redirect international shoppers to their local store in nine additional countries, with no OneLink setup at all.

If that is not what you want, see [Global Earning (international redirects)](#global-earning-international-redirects) below.
{% endhint %}

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

#### Which marketplaces a credential covers

A Creators API credential belongs to the **Associates account** that created it. It returns products for the marketplaces where that account's Associate Tag is valid, not for every marketplace in a region.

For example, in our tests a credential created in a US Associates account returned products for amazon.com and amazon.ca, but not for amazon.com.mx or amazon.com.br. Requests to marketplaces the account doesn't cover fail with an [“InvalidAssociate” error](#invalidassociate-error).

**In the module settings.** Fill in the **Primary** Credential ID and Secret first. If some of your marketplaces belong to a different Associates account, add that account's credential to the matching region fields:

| Region fields | Marketplaces                                               |
| ------------- | ---------------------------------------------------------- |
| **NA**        | US, CA, MX, BR                                             |
| **EU**        | UK, DE, FR, IT, ES, NL, BE, IE, PL, SE, EG, IN, SA, TR, AE |
| **FE**        | JP, SG, AU                                                 |

Each locale uses the credential of its region. If a region pair is empty or only half filled in, Content Egg uses the Primary credential. A site that uses one Associates account needs only the Primary pair.

If you see an eligibility error instead, see [“AssociateNotEligible” error (403)](#associatenoteligible-error-403).

***

### Global Earning (international redirects)

In August 2026 Amazon enabled **Global Earning** for all US creators. Existing Amazon.com affiliate links now send international shoppers to their local Amazon store — Canada, United Kingdom, Germany, Italy, Spain, Netherlands, Poland, Sweden and France. Nothing has to be configured, and there is no opt-out in the Associates dashboard.

When the exact product is not sold in the shopper's country, Amazon may send them to a **similar product instead**, which can be a different model or a different brand than the one your article reviews.

Content Egg adds a **Global Earning** setting to the Amazon and [Amazon No API](/modules/affiliate/amazon-no-api-module.md) modules so you can control this.

| Value                         | What happens                                                                            |
| ----------------------------- | --------------------------------------------------------------------------------------- |
| **Similar product** (default) | Amazon's own behaviour. A substitute product may be shown when there is no exact match. |
| **Search results**            | The shopper lands on local search results instead of a substitute product.              |
| **No redirect**               | The redirect is switched off. Shoppers stay in the store the module uses.               |

The setting applies to links as they are displayed, so it takes effect on products you have already imported — no re-update is needed. Switching back removes it again.

#### Which value to choose

* **Similar product** — roundups, gift guides and general recommendations, where any comparable product is an acceptable outcome and international commissions are worth having.
* **Search results** — detailed reviews and comparisons, where sending a shopper to a different brand is worse than sending them to a search page.
* **No redirect** — sites that deliberately promote one country's catalog to readers elsewhere, for example a European site listing products only sold on Amazon.com. Note that this gives up international commissions entirely.

#### Cloned modules

The setting is stored per module, including [cloned modules](/modules/cloning.md). A German Amazon module and a US clone can use different values on the same site — for example the German module on **Similar product** and the US clone on **No redirect**.

{% hint style="warning" %}
**Experimental.** Amazon does not publicly document the link parameters behind **Search results** and **No redirect**, so this behaviour may change without notice.
{% endhint %}

Background and testing details:\
<https://www.keywordrush.com/blog/amazon-global-earning-enabled-by-default/>

***

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

#### “Invalid client credentials” error

Error message:\
`Amazon Creators API: Amazon rejected the Credential ID and Credential Secret (invalid_client).`

Amazon did not accept the Credential ID and Secret pair. A wrong Secret and an unknown Credential ID return the same error.

* Copy both values directly from Associates Central → **Tools** → **Creators API**.
* Make sure your browser didn't auto-fill a saved password into the Secret field.
* The Secret is shown only once. If you are not sure you have the right one, create a new credential.

If a freshly created credential still returns this error, contact Amazon Associates support (see below).

#### “Your credentials have expired” error

Error message:\
`AccessDeniedException:AuthorizationFailed - Your credentials have expired.`

Amazon no longer accepts this credential. Create a new one in Associates Central and replace both the Credential ID and Secret in the module settings.

#### “InvalidAssociate” error

Error message:\
`ValidationException:InvalidAssociate - Your credential is not linked to the partner tag in the request for the given Marketplace.`

The credential works, but not for this marketplace and Associate Tag. Check that:

* the Associate Tag for this locale belongs to the Associates account that created the credential;
* the marketplace is covered by that account (see [Which marketplaces a credential covers](#which-marketplaces-a-credential-covers)).

For a marketplace that belongs to another Associates account, add a credential from that account in the region fields.

#### Amazon Associates support

For Amazon Associates account issues:

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