Overview
This node integrates with the Amazon Product Advertising API (PAAPI) to perform various operations related to Amazon product data. Specifically, the Search Items operation allows users to search for products on Amazon by keywords and filter or sort the results based on multiple criteria such as category, price range, merchant type, condition, and customer reviews.
Common scenarios where this node is beneficial include:
- E-commerce businesses wanting to fetch product listings dynamically from Amazon.
- Affiliate marketers searching for relevant products to promote.
- Developers building price comparison tools or product discovery apps.
- Market researchers analyzing product availability and pricing trends.
For example, a user can input keywords like "wireless headphones," select the Electronics category, set a price range, and retrieve a sorted list of matching items including their titles, prices, and images.
Properties
| Name | Meaning |
|---|---|
| Partner Tag | Amazon Partner Tag used for affiliate tracking; overrides default if provided. |
| Keywords (for Search Items) | Keywords to search for items on Amazon. |
| Search Index (for Search Items) | Product category to search in. Options: All, Apparel, Automotive, Baby, Beauty, Books, Electronics, HomeAndKitchen, Music, SportsAndOutdoors, VideoGames. |
| Resources | List of specific data resources to include in the response, such as item info fields (title, features), images (various sizes), offers details (price, availability), and browse node info. Defaults to title, price, medium image. |
| Use OffersV2 | Boolean flag to use the newer OffersV2 resource instead of the original Offers resource (requires API version 1.2.2+). |
| Additional Options | Collection of optional parameters: |
| - Language of Preference | Preferred language for item information. Options: Default, English, Spanish, French, German, Italian, Japanese. |
| - Sort By (for Search Items) | How to sort search results. Options: Relevance, Price Low to High, Price High to Low, Average Customer Review, Newest Arrivals, Featured. |
| - Item Page (for Search Items) | Page number of results to retrieve (1-10). |
| - Item Count (for Search Items) | Number of items per page (1-10). |
| - Merchant (for Search Items) | Filter by merchant type. Options: All, Amazon. |
| - Condition (for Search Items) | Filter by item condition. Options: Any, New, Used, Collectible, Refurbished. |
| - Min Price (for Search Items) | Minimum price filter in marketplace currency (0 means no minimum). |
| - Max Price (for Search Items) | Maximum price filter in marketplace currency (0 means no maximum). |
| - Min Reviews (for Search Items) | Minimum customer review rating (1-5). |
Output
The node outputs an array of JSON objects, each representing the result of one execution iteration. The main output structure includes:
success: Boolean indicating if the request was successful.- If successful, the response contains Amazon PAAPI data structured according to requested resources, e.g., item titles, prices, images, offers, etc.
- If errors occur, the output includes:
errors: Array of error objects returned by the API.errorMessage: Concatenated string of error codes and messages.originalResponse: Raw API response for debugging.
- In case of exceptions, output includes:
success: falseerrorMessage: Error message string.errorDetail: Stack trace or additional error details.
The node does not output binary data.
Dependencies
- Requires an active Amazon Product Advertising API credential with access keys, secret keys, partner tag, and marketplace configured.
- Uses the external
amazon-paapilibrary to interact with the Amazon PAAPI. - The node expects the user to provide either credentials or override the partner tag via input properties.
- Requires network connectivity to Amazon's PAAPI endpoints.
Troubleshooting
- Missing Partner Tag: The node throws an error if no partner tag is provided either in credentials or input properties. Ensure you have set a valid partner tag.
- Invalid or Missing Credentials: Authentication failures will cause API errors. Verify your access key, secret key, and marketplace settings.
- Invalid Input Parameters: For example, missing required fields like keywords for search or ASINs for other operations will cause errors.
- API Errors: The node logs and returns detailed API error messages. Common issues include quota limits, invalid resource requests, or malformed parameters.
- Version Compatibility: Using the
Use OffersV2option requires API version 1.2.2 or higher; otherwise, it may fail. - Pagination Limits: Item page and count parameters are limited between 1 and 10; exceeding these ranges will cause errors.
To resolve errors, check the error messages returned in the output, verify all required inputs, and ensure credentials are correctly configured.
Links and References
- Amazon Product Advertising API Documentation
- Amazon PAAPI Node GitHub Repository (if available) (general n8n repo, specific node repo not provided)