Actions9
- Best Seller Actions
- Category Actions
- Deal Actions
- Product Actions
- Product Finder Actions
Overview
The node integrates with the Keepa API to perform a Category Search within the Product Finder resource. It allows users to search for Amazon products filtered by category and various criteria such as price range, rating, review count, availability, and sorting preferences. This is useful for scenarios like market research, competitive analysis, or building product recommendation systems where you want to retrieve a curated list of products from specific Amazon categories.
For example, a user could find all "Electronics" products in the US Amazon store that are in stock, have at least 4-star ratings, and cost between $50 and $200, sorted by best sellers.
Properties
Name | Meaning |
---|---|
Domain | Amazon domain to search in. Options: US, Canada, UK, Germany, France, Italy, Spain, India, Mexico, Brazil, Australia, Japan |
Category ID | Category to search in. 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 | Custom category ID if the desired category is not listed among common categories |
Min Price | Minimum price filter for products |
Max Price | Maximum price filter (0 means no upper limit) |
Min Rating | Minimum product rating filter (1 to 5 stars) |
Min Review Count | Minimum number of reviews a product must have |
Availability | Product availability filter. Options: All, In Stock, Out of Stock, Available for Order |
Sort By | Sort 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 |
Output
The node outputs JSON data containing the list of products matching the search criteria. Each product entry typically includes details such as product identifiers, title, price, rating, review count, availability status, and other relevant metadata retrieved from the Keepa API.
If binary data were supported (e.g., images), it would be included in a separate binary output field, but this node focuses on JSON product data only.
Dependencies
- Requires an active connection to the Keepa API.
- Users must provide a valid API authentication token (API key credential) for Keepa.
- The node uses the base URL
https://api.keepa.com
for API requests.
Troubleshooting
Common issues:
- Invalid or missing API key will cause authentication errors.
- Using unsupported or incorrect category IDs may result in empty or error responses.
- Setting conflicting filters (e.g., minPrice higher than maxPrice) might yield no results.
- Exceeding the API rate limits imposed by Keepa can cause request failures.
Error messages:
- Authentication errors: Check that the API key is correctly configured and has sufficient permissions.
- Validation errors: Verify that input parameters like category IDs, prices, and ratings are within allowed ranges.
- Network errors: Ensure stable internet connectivity and that the Keepa API endpoint is reachable.
Links and References
- Keepa API Documentation
- Amazon Product Categories Reference
- n8n documentation on Creating Custom Nodes