> 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. *** ### 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`
*** ### 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 that API credentials cover a whole **region**, not a single marketplace — see [API credentials are per region](#api-credentials-are-per-region-na-eu-fe) 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:\ {% 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):\ #### 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):\ #### API credentials are per region (NA / EU / FE) Creators API credentials are tied to a **region**, not to an individual marketplace. One credential pair works for every marketplace inside its region. | Region | 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 | **What this means in practice.** Qualifying sales unlock API access for the whole region. If you reach the required sales in the US, the same credentials should also give you API access to the other NA marketplaces, without reaching that number in each one separately. **In the module settings.** Fill in the **Primary** Credential ID and Secret first. If your products span more than one region, add the extra pairs: * Credential ID / Secret — NA region * Credential ID / Secret — EU region * Credential ID / Secret — FE region Each locale automatically uses the credentials of its own region. If a region pair is empty — or only half filled in — Content Egg falls back to the Primary credentials. So a single-region catalog needs nothing beyond the Primary pair. {% hint style="info" %} This region behaviour is not described in Amazon's documentation. It is based on our own testing and on feedback from users, so treat it as a practical observation rather than an official rule. {% endhint %} 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:\ *** ### 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:\ #### Amazon Associates support For Amazon Associates account issues: * Go to Amazon Associates → **Help** → **Contact Us** * Choose **Creators API** in the Subject dropdown