n8n-nodes-amazon-creator-api 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Priyansh Kothari
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,120 @@
+# n8n-nodes-amazon-creator-api
+
+n8n community node for the **Amazon Creators API** — the successor to the Product Advertising API (PA-API 5.0), which Amazon retired on **15 May 2026**.
+
+[![npm version](https://badge.fury.io/js/n8n-nodes-amazon-creator-api.svg)](https://www.npmjs.com/package/n8n-nodes-amazon-creator-api)
+
+> **Author**: [Priyansh Kothari](https://priyan.sh)
+> ☕ **Like this package?** [Buy me a coffee!](https://buymeacoffee.com/priyanshkothari)
+
+This package implements the full Amazon Creators API surface with all documented options: `GetItems`, `SearchItems`, `GetVariations`, and `GetBrowseNodes`. It uses the modern OAuth2 authentication flow (both Cognito v2.x and Login with Amazon v3.x credentials) and the new `offersV2` / `variationSummary` / `searchRefinements` resources.
+
+It ships **three nodes**:
+
+| Node | Type | Purpose |
+| --- | --- | --- |
+| **Amazon Creators API** | Action | GetItems / SearchItems / GetVariations / GetBrowseNodes |
+| **Amazon Creators Price Watch Trigger** | Polling trigger | Fires when price, availability, buy box or discount changes for watched ASINs |
+| **Amazon Creators Search Watch Trigger** | Polling trigger | Fires when a new ASIN appears in a search (e.g. new arrivals) |
+
+> **Migrating from PA-API 5.0?** This is a different API — different auth (OAuth2 instead of AWS SigV4), a single endpoint (`https://creatorsapi.amazon`), an `x-marketplace` header, and lowerCamelCase request/response fields. If you used [`n8n-nodes-amazon-affiliate-api`](https://www.npmjs.com/package/n8n-nodes-amazon-affiliate-api), install this alongside it and look for **Amazon Creators API** in the node list.
+
+## Installation
+
+In your n8n instance, go to **Settings → Community Nodes → Install** and enter:
+
+```
+n8n-nodes-amazon-creator-api
+```
+
+Or install manually:
+
+```bash
+npm install n8n-nodes-amazon-creator-api
+```
+
+## Credentials
+
+Generate Creators API credentials in **Amazon Associates Central** (requires an approved Associates account with recent qualifying sales). You will get a **Client ID**, **Client Secret**, and a **Version** (e.g. `2.2`, `3.2`).
+
+| Field | Notes |
+| --- | --- |
+| **Credential Version** | Selects the OAuth2 token endpoint. `2.x` = Amazon Cognito, `3.x` = Login with Amazon. The region shown is only for the token endpoint — credentials work across all marketplaces. |
+| **Client ID** | Credential ID from Associates Central. |
+| **Client Secret** | Credential Secret from Associates Central. |
+| **Default Partner Tag** | Your Associate tag for the target marketplace (e.g. `yourtag-20`). |
+| **Default Marketplace** | The Amazon locale to target (e.g. `www.amazon.com`). |
+
+The node fetches the 1-hour OAuth2 access token automatically and caches it (reused across executions until shortly before expiry) — no manual token handling needed.
+
+## Operations
+
+### Get Items
+Look up attributes for up to 10 ASINs.
+- **Item IDs** (comma-separated), **Item ID Type** (ASIN), **Condition** (Any / New)
+- **Resources**, **Languages of Preference**, **Currency of Preference**
+
+### Search Items
+Search the Amazon catalog (up to 10 results per page). Requires at least one of Keywords, Actor, Artist, Author, Brand or Title.
+- **Keywords**, **Search Index**, **Item Count**, **Item Page**, **Resources**
+- **Additional Fields**: Actor, Artist, Author, Brand, Title, Browse Node ID, Availability, Condition, Delivery Flags, Sort By, Min/Max Price, Min Reviews Rating, Min Saving Percent
+
+### Get Variations
+Return the variations (size, color, etc.) of a parent or child ASIN.
+- **ASIN**, **Variation Count**, **Variation Page**, **Condition**, **Resources**
+
+### Get Browse Nodes
+Traverse Amazon's category hierarchy.
+- **Browse Node IDs** (comma-separated), **Resources** (Ancestor / Children), **Languages of Preference**
+
+## Node options (Amazon Creators API)
+
+- **Resource Preset** — quick-select `Minimal`, `Pricing & Offers`, `Everything`, or `Custom` instead of ticking resources individually.
+- **Return All** (Search Items / Get Variations) — automatically pages through the API up to a **Limit** instead of a single page.
+- **Auto-batching** — Get Items / Get Browse Nodes accept more than 10 IDs and are split into batched requests automatically, with results merged.
+- **Simplify** — return one flattened item per result (`asin`, `title`, `price`, `currency`, `image`, `url`, `savingsPercent`, `merchant`, …) instead of the raw nested response.
+- **Split Errors** — route per-item API errors (e.g. inaccessible ASINs) to a separate **Errors** output.
+- **Languages of Preference** — a marketplace-aware dropdown populated from the official Locale Reference.
+
+Under the hood the nodes **cache the OAuth2 token** (reused until ~1 min before expiry, so the token endpoint's 300 req/5 min limit is respected) and **retry** on HTTP 429/5xx with exponential backoff. The credential has a **Test** button that performs a live token exchange.
+
+## Trigger nodes
+
+Amazon's Creators API has no webhooks, so these triggers **poll** on the schedule you configure in n8n and remember what they've seen using workflow static data.
+
+### Amazon Creators Price Watch Trigger
+Watch a list of ASINs and emit an item only when something changes. Choose which dimensions to watch: **Price**, **Availability**, **Buy Box**, **Discount %**. Each emitted item is the simplified product plus `_changed` (which dimensions changed) and `_previous` (the prior snapshot). The first poll establishes a baseline without firing.
+
+### Amazon Creators Search Watch Trigger
+Run a `searchItems` query (default sort **NewestArrivals**) on a schedule and emit only ASINs not seen before — ideal for new-arrival and restock alerts. Supports keywords, search index, brand, browse node, and minimum saving %.
+
+## Resources
+
+All Creators API resources are selectable per operation, including the new **OffersV2** and **VariationSummary** containers:
+
+- **BrowseNodeInfo** — `browseNodes`, `browseNodes.ancestor`, `browseNodes.salesRank`, `websiteSalesRank`
+- **Images** — `primary.{small,medium,large}`, `variants.{small,medium,large}`
+- **ItemInfo** — `byLineInfo`, `classifications`, `contentInfo`, `contentRating`, `externalIds`, `features`, `manufactureInfo`, `productInfo`, `technicalInfo`, `title`, `tradeInInfo`
+- **OffersV2** — `listings.{availability, condition, dealDetails, isBuyBoxWinner, loyaltyPoints, merchantInfo, price, type}`
+- **ParentASIN**
+- **SearchRefinements** (Search Items only)
+- **VariationSummary** — `price.highestPrice`, `price.lowestPrice`, `variationDimension` (Get Variations only)
+
+## Marketplaces
+
+US, CA, MX, BR, UK, DE, FR, IT, ES, NL, BE, EG, IN, IE, PL, SA, SE, TR, AE, JP, SG, AU. Choose a per-node **Marketplace** to override the credential default (each marketplace needs a valid Partner Tag and Creators API approval in that region).
+
+## Development
+
+```bash
+npm install
+npm run build      # compiles TypeScript to dist/ and copies icons
+```
+
+## Resources & docs
+
+- [Amazon Creators API documentation](https://affiliate-program.amazon.com/creatorsapi/docs/)
+
+## License
+
+MIT © [Priyansh Kothari](https://priyan.sh)

package/dist/credentials/AmazonCreatorsApi.credentials.d.ts

@@ -0,0 +1,7 @@
+import type { ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class AmazonCreatorsApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+}

package/dist/credentials/AmazonCreatorsApi.credentials.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AmazonCreatorsApi = void 0;
+class AmazonCreatorsApi {
+    constructor() {
+        this.name = 'amazonCreatorsApi';
+        this.displayName = 'Amazon Creators API';
+        this.documentationUrl = 'https://affiliate-program.amazon.com/creatorsapi/docs/';
+        this.properties = [
+            {
+                displayName: 'Credential Version',
+                name: 'credentialVersion',
+                type: 'options',
+                options: [
+                    { name: '2.1 — Cognito (NA: US, CA, MX, BR)', value: '2.1' },
+                    {
+                        name: '2.2 — Cognito (EU: UK, DE, FR, IT, ES, NL, BE, EG, IN, IE, PL, SA, SE, TR, AE)',
+                        value: '2.2',
+                    },
+                    { name: '2.3 — Cognito (FE: JP, SG, AU)', value: '2.3' },
+                    { name: '3.1 — Login with Amazon (NA: US, CA, MX, BR)', value: '3.1' },
+                    {
+                        name: '3.2 — Login with Amazon (EU: UK, DE, FR, IT, ES, NL, BE, EG, IN, IE, PL, SA, SE, TR, AE)',
+                        value: '3.2',
+                    },
+                    { name: '3.3 — Login with Amazon (FE: JP, SG, AU)', value: '3.3' },
+                ],
+                default: '3.2',
+                description: 'The version shown next to your credentials in Associates Central. It selects the OAuth2 token endpoint (2.x = Cognito, 3.x = Login with Amazon). Your credentials work across all marketplaces regardless of the region shown here — set the target marketplace below.',
+            },
+            {
+                displayName: 'Client ID',
+                name: 'clientId',
+                type: 'string',
+                default: '',
+                required: true,
+                description: 'Creators API Client ID (Credential ID) generated in Amazon Associates Central',
+            },
+            {
+                displayName: 'Client Secret',
+                name: 'clientSecret',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                description: 'Creators API Client Secret (Credential Secret) generated in Amazon Associates Central',
+            },
+            {
+                displayName: 'Default Partner Tag',
+                name: 'partnerTag',
+                type: 'string',
+                default: '',
+                description: 'Your Associate/Partner Tag for the target marketplace (e.g. yourtag-20). Can be overridden per node.',
+            },
+            {
+                displayName: 'Default Marketplace',
+                name: 'marketplace',
+                type: 'options',
+                options: [
+                    { name: 'Australia (www.amazon.com.au)', value: 'www.amazon.com.au' },
+                    { name: 'Belgium (www.amazon.com.be)', value: 'www.amazon.com.be' },
+                    { name: 'Brazil (www.amazon.com.br)', value: 'www.amazon.com.br' },
+                    { name: 'Canada (www.amazon.ca)', value: 'www.amazon.ca' },
+                    { name: 'Egypt (www.amazon.eg)', value: 'www.amazon.eg' },
+                    { name: 'France (www.amazon.fr)', value: 'www.amazon.fr' },
+                    { name: 'Germany (www.amazon.de)', value: 'www.amazon.de' },
+                    { name: 'India (www.amazon.in)', value: 'www.amazon.in' },
+                    { name: 'Ireland (www.amazon.ie)', value: 'www.amazon.ie' },
+                    { name: 'Italy (www.amazon.it)', value: 'www.amazon.it' },
+                    { name: 'Japan (www.amazon.co.jp)', value: 'www.amazon.co.jp' },
+                    { name: 'Mexico (www.amazon.com.mx)', value: 'www.amazon.com.mx' },
+                    { name: 'Netherlands (www.amazon.nl)', value: 'www.amazon.nl' },
+                    { name: 'Poland (www.amazon.pl)', value: 'www.amazon.pl' },
+                    { name: 'Saudi Arabia (www.amazon.sa)', value: 'www.amazon.sa' },
+                    { name: 'Singapore (www.amazon.sg)', value: 'www.amazon.sg' },
+                    { name: 'Spain (www.amazon.es)', value: 'www.amazon.es' },
+                    { name: 'Sweden (www.amazon.se)', value: 'www.amazon.se' },
+                    { name: 'Turkey (www.amazon.com.tr)', value: 'www.amazon.com.tr' },
+                    { name: 'United Arab Emirates (www.amazon.ae)', value: 'www.amazon.ae' },
+                    { name: 'United Kingdom (www.amazon.co.uk)', value: 'www.amazon.co.uk' },
+                    { name: 'United States (www.amazon.com)', value: 'www.amazon.com' },
+                ],
+                default: 'www.amazon.com',
+                description: 'The Amazon marketplace to target. Can be overridden per node.',
+            },
+        ];
+    }
+}
+exports.AmazonCreatorsApi = AmazonCreatorsApi;
+//# sourceMappingURL=AmazonCreatorsApi.credentials.js.map

package/dist/credentials/AmazonCreatorsApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AmazonCreatorsApi.credentials.js","sourceRoot":"","sources":["../../credentials/AmazonCreatorsApi.credentials.ts"],"names":[],"mappings":";;;AAEA,MAAa,iBAAiB;IAA9B;QACC,SAAI,GAAG,mBAAmB,CAAC;QAE3B,gBAAW,GAAG,qBAAqB,CAAC;QAEpC,qBAAgB,GAAG,wDAAwD,CAAC;QAI5E,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,oBAAoB;gBACjC,IAAI,EAAE,mBAAmB;gBACzB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE;oBACR,EAAE,IAAI,EAAE,oCAAoC,EAAE,KAAK,EAAE,KAAK,EAAE;oBAC5D;wBACC,IAAI,EAAE,gFAAgF;wBACtF,KAAK,EAAE,KAAK;qBACZ;oBACD,EAAE,IAAI,EAAE,gCAAgC,EAAE,KAAK,EAAE,KAAK,EAAE;oBACxD,EAAE,IAAI,EAAE,8CAA8C,EAAE,KAAK,EAAE,KAAK,EAAE;oBACtE;wBACC,IAAI,EAAE,0FAA0F;wBAChG,KAAK,EAAE,KAAK;qBACZ;oBACD,EAAE,IAAI,EAAE,0CAA0C,EAAE,KAAK,EAAE,KAAK,EAAE;iBAClE;gBACD,OAAO,EAAE,KAAK;gBACd,WAAW,EACV,wQAAwQ;aACzQ;YACD;gBACC,WAAW,EAAE,WAAW;gBACxB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,+EAA+E;aAC5F;YACD;gBACC,WAAW,EAAE,eAAe;gBAC5B,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EACV,uFAAuF;aACxF;YACD;gBACC,WAAW,EAAE,qBAAqB;gBAClC,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EACV,sGAAsG;aACvG;YACD;gBACC,WAAW,EAAE,qBAAqB;gBAClC,IAAI,EAAE,aAAa;gBACnB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE;oBACR,EAAE,IAAI,EAAE,+BAA+B,EAAE,KAAK,EAAE,mBAAmB,EAAE;oBACrE,EAAE,IAAI,EAAE,6BAA6B,EAAE,KAAK,EAAE,mBAAmB,EAAE;oBACnE,EAAE,IAAI,EAAE,4BAA4B,EAAE,KAAK,EAAE,mBAAmB,EAAE;oBAClE,EAAE,IAAI,EAAE,wBAAwB,EAAE,KAAK,EAAE,eAAe,EAAE;oBAC1D,EAAE,IAAI,EAAE,uBAAuB,EAAE,KAAK,EAAE,eAAe,EAAE;oBACzD,EAAE,IAAI,EAAE,wBAAwB,EAAE,KAAK,EAAE,eAAe,EAAE;oBAC1D,EAAE,IAAI,EAAE,yBAAyB,EAAE,KAAK,EAAE,eAAe,EAAE;oBAC3D,EAAE,IAAI,EAAE,uBAAuB,EAAE,KAAK,EAAE,eAAe,EAAE;oBACzD,EAAE,IAAI,EAAE,yBAAyB,EAAE,KAAK,EAAE,eAAe,EAAE;oBAC3D,EAAE,IAAI,EAAE,uBAAuB,EAAE,KAAK,EAAE,eAAe,EAAE;oBACzD,EAAE,IAAI,EAAE,0BAA0B,EAAE,KAAK,EAAE,kBAAkB,EAAE;oBAC/D,EAAE,IAAI,EAAE,4BAA4B,EAAE,KAAK,EAAE,mBAAmB,EAAE;oBAClE,EAAE,IAAI,EAAE,6BAA6B,EAAE,KAAK,EAAE,eAAe,EAAE;oBAC/D,EAAE,IAAI,EAAE,wBAAwB,EAAE,KAAK,EAAE,eAAe,EAAE;oBAC1D,EAAE,IAAI,EAAE,8BAA8B,EAAE,KAAK,EAAE,eAAe,EAAE;oBAChE,EAAE,IAAI,EAAE,2BAA2B,EAAE,KAAK,EAAE,eAAe,EAAE;oBAC7D,EAAE,IAAI,EAAE,uBAAuB,EAAE,KAAK,EAAE,eAAe,EAAE;oBACzD,EAAE,IAAI,EAAE,wBAAwB,EAAE,KAAK,EAAE,eAAe,EAAE;oBAC1D,EAAE,IAAI,EAAE,4BAA4B,EAAE,KAAK,EAAE,mBAAmB,EAAE;oBAClE,EAAE,IAAI,EAAE,sCAAsC,EAAE,KAAK,EAAE,eAAe,EAAE;oBACxE,EAAE,IAAI,EAAE,mCAAmC,EAAE,KAAK,EAAE,kBAAkB,EAAE;oBACxE,EAAE,IAAI,EAAE,gCAAgC,EAAE,KAAK,EAAE,gBAAgB,EAAE;iBACnE;gBACD,OAAO,EAAE,gBAAgB;gBACzB,WAAW,EAAE,+DAA+D;aAC5E;SACD,CAAC;IACH,CAAC;CAAA;AA1FD,8CA0FC"}

package/dist/nodes/AmazonCreatorsApi/AmazonCreatorsApi.node.d.ts

@@ -0,0 +1,13 @@
+import type { ICredentialsDecrypted, ICredentialTestFunctions, IExecuteFunctions, ILoadOptionsFunctions, INodeCredentialTestResult, INodeExecutionData, INodePropertyOptions, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class AmazonCreatorsApi implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        credentialTest: {
+            creatorsApiCredentialTest(this: ICredentialTestFunctions, credential: ICredentialsDecrypted): Promise<INodeCredentialTestResult>;
+        };
+        loadOptions: {
+            getLanguages(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+        };
+    };
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}