Keepa icon

Keepa

Interact with Keepa API for Amazon product data

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

Discussion