Actions9
- Best Seller Actions
- Category Actions
- Deal Actions
- Product Actions
- Product Finder Actions
Overview
The node provides an interface to perform an advanced product search on Amazon using the Keepa API. It allows users to specify detailed search criteria such as domain (Amazon marketplace), category, price range, ratings, availability, and more to find products that match specific conditions. This is useful for market research, competitive analysis, price tracking, or finding niche products with particular attributes.
For example, a user could search for electronics in the US Amazon store priced between $100 and $500, with at least 4-star ratings and currently in stock, sorted by best sellers. The node then returns matching product data based on these filters.
Properties
Name | Meaning |
---|---|
Domain | Amazon domain/marketplace to search in. Options: US, Canada, UK, Germany, France, Italy, Spain, India, Mexico, Brazil, Australia, Japan |
Category ID | Predefined Amazon category to search within. Options include All Categories, Books, Electronics, Home & Kitchen, Clothing, Shoes & Jewelry, Sports & Outdoors, Toys & Games, Automotive, Health & Household, Tools & Home Improvement, Garden & Outdoor, Pet Supplies, Baby Products, Office Products, Beauty & Personal Care, Grocery & Gourmet Food, Movies & TV, Music, Video Games, Industrial & Scientific |
Custom Category ID | Numeric custom category ID if the desired category is not listed among predefined categories |
Search Term | General search term to look for in product title, author, or manufacturer |
Title | Specific product title to search for |
Author | Product author to filter by |
Manufacturer | Product manufacturer to filter by |
Min Price | Minimum price filter for products |
Max Price | Maximum price filter (0 means no upper limit) |
Min Rating | Minimum average rating filter (1 to 5 stars) |
Min Review Count | Minimum number of reviews a product must have |
Availability | Filter by product availability status. Options: All, In Stock, Out of Stock, Available for Order |
Sort By | Sorting order for results. Options: Relevance, Price Low to High, Price High to Low, Rating, Review Count, Newest, Oldest, Best Sellers |
Limit | Maximum number of results to return (minimum 1) |
Output
The node outputs JSON data containing the list of products matching the specified search criteria. Each product entry typically includes details such as product identifiers, title, author, manufacturer, pricing information, ratings, review counts, availability status, and other relevant metadata returned by the Keepa API.
If binary data is returned (not indicated here), it would represent associated media or files related to the products, but this node primarily deals with JSON product data.
Dependencies
- Requires an active connection to the Keepa API service.
- Needs a valid API authentication token configured in n8n credentials to access the Keepa API.
- Network connectivity to the Keepa API endpoint (
https://api.keepa.com
).
Troubleshooting
Common issues:
- Invalid or missing API key credential will cause authentication failures.
- Incorrect domain or category IDs may result in empty or no results.
- Exceeding API rate limits can lead to request throttling errors.
- Providing invalid numeric values (e.g., negative prices or ratings outside 1-5) may cause validation errors.
Error messages:
- Authentication errors: Check that the API key credential is correctly set up and has sufficient permissions.
- "No products found": Adjust search parameters or verify category/domain correctness.
- Rate limit exceeded: Wait and retry after some time or upgrade API plan if applicable.
- Validation errors: Ensure all numeric inputs are within allowed ranges and required fields are provided.
Links and References
- Keepa API Documentation
- Amazon Product Categories Reference
- n8n documentation on Using Credentials