npm.io
0.1.1 • Published yesterday

n8n-nodes-amazon-creator-api

Licence
MIT
Version
0.1.1
Deps
0
Size
130 kB
Vulns
0
Weekly
0

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

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), an x-marketplace header, and lowerCamelCase request/response fields. If you used 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:

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:

  • BrowseNodeInfobrowseNodes, browseNodes.ancestor, browseNodes.salesRank, websiteSalesRank
  • Imagesprimary.{small,medium,large}, variants.{small,medium,large}
  • ItemInfobyLineInfo, classifications, contentInfo, contentRating, externalIds, features, manufactureInfo, productInfo, technicalInfo, title, tradeInInfo
  • OffersV2listings.{availability, condition, dealDetails, isBuyBoxWinner, loyaltyPoints, merchantInfo, price, type}
  • ParentASIN
  • SearchRefinements (Search Items only)
  • VariationSummaryprice.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 icons

Resources & docs

License

MIT Priyansh Kothari

Keywords