Overview
This node integrates with the Amazon Product Advertising API to perform product-related queries on Amazon. Specifically, the "Search Items" operation allows users to search for products on Amazon using keywords and retrieve detailed information about those items.
Common scenarios where this node is beneficial include:
- E-commerce businesses wanting to fetch product data dynamically.
- Affiliate marketers looking to display Amazon product listings based on search terms.
- Developers building price comparison or product discovery tools.
For example, a user can input keywords like "wireless headphones" and specify which product details they want (e.g., images, reviews, pricing). The node will then return matching Amazon items with the requested data fields.
Properties
| Name | Meaning |
|---|---|
| Partner Tag | Amazon Partner Tag used for affiliate tracking; overrides default if set. |
| Keywords (for Search Items) | Keywords to search for items on Amazon (e.g., "laptop", "coffee maker"). |
| Resources (for Search Items) | Selectable list of item data fields to retrieve from Amazon, such as: - BrowseNodeInfo.BrowseNodes - CustomerReviews.Count - Images.Primary.Small/Medium/Large - ItemInfo.Title - Offers.Listings.Price ...and many more detailed product attributes. |
The "Resources" property lets you specify exactly which parts of the product data you want returned, enabling tailored responses and efficient data usage.
Output
The node outputs an array with one element per input item. Each output item contains a json field holding the full response from the Amazon Product Advertising API for the search query.
The structure of the json output corresponds directly to the API's response format for the Search Items operation, including all requested resource fields. This typically includes arrays of matched items with nested details such as titles, images, offers, reviews, and classifications.
No binary data output is produced by this operation.
Dependencies
- Requires an active Amazon Product Advertising API account with valid credentials: Access Key, Secret Key, Partner Tag, and Marketplace.
- The node expects these credentials to be configured in n8n and accessible at runtime.
- Uses the external
amazon-paapilibrary to interact with the Amazon API.
Troubleshooting
- Missing Partner Tag: If neither the node parameter nor credentials provide a Partner Tag, the node throws an error. Ensure the Partner Tag is set either in the node or in the credentials.
- Empty Keywords: Providing empty keywords will result in no meaningful search results or may cause errors. Always supply valid search terms.
- API Request Errors: Network issues, invalid credentials, or exceeding API rate limits can cause request failures. Check your API keys and usage quotas.
- Invalid Resource Fields: Selecting unsupported or misspelled resource fields may lead to incomplete or failed responses. Use the provided options list to avoid this.
Links and References
- Amazon Product Advertising API Documentation
- Amazon Associates Program
- amazon-paapi npm package (used internally by the node)