n8n-nodes-amazon-creator-api
v0.1.1
Published
n8n community node for the Amazon Creators API (the successor to PA-API 5.0) - GetItems, SearchItems, GetVariations, GetBrowseNodes with full OAuth2 support
Maintainers
Readme
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.
Author: Priyansh Kothari ☕ Like this package? Buy me a coffee!
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), anx-marketplaceheader, and lowerCamelCase request/response fields. If you usedn8n-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-apiOr install manually:
npm install n8n-nodes-amazon-creator-apiCredentials
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, orCustominstead 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
npm install
npm run build # compiles TypeScript to dist/ and copies iconsResources & docs
License
MIT © Priyansh Kothari
