Fetch current product details from Keepa for a given Amazon ASIN.

Returns: title, brand, category path, current Amazon price, new (3P) price, buy box price, review count, star rating, number of new offers, and latest sales rank.

Prices are in USD. A value of "N/A" means the price type is not currently available.

Args:

• asin (string): Amazon ASIN, e.g. "B08N5WRWNW"

• domain (number, optional): Keepa domain id (default 1 = amazon.com)

Examples:

• "What is the current price of ASIN B08N5WRWNW?" -> use get_product with asin="B08N5WRWNW"

• "Show me product details for B07PXGQC1Q" -> use get_product with asin="B07PXGQC1Q"

Error handling:

• Returns an instructional message if KEEPA_API_KEY is missing.

• Returns a not-found message for invalid ASINs.

Fetch historical price data for an Amazon ASIN from Keepa.

Returns a decoded, downsampled time series (at most 60 data points) for:

• Amazon price (sold by Amazon directly)

• New (3P) price (lowest new third-party price)

• Used price (lowest used price)

• Buy box price

Keepa stores prices in cents. All prices returned are in USD. Keepa time values (minutes since 2011-01-01) are decoded to ISO dates.

Args:

• asin (string): Amazon ASIN

• range (string, optional): Time range. "30d", "6m", "1y", "all". Default: "90d"

• domain (number, optional): Keepa domain id (default 1 = amazon.com)

Examples:

• "Show price history for B08N5WRWNW over the past year" -> range="1y"

• "What has the Amazon price been for B07PXGQC1Q in the last 30 days?" -> range="30d"

Fetch historical sales rank data for an Amazon ASIN from Keepa.

Sales rank (BSR) is a proxy for demand: lower rank = faster sales velocity. Returns a decoded, downsampled time series plus a trend summary.

The trend summary indicates whether demand is improving (rank decreasing), worsening (rank increasing), or stable.

Args:

• asin (string): Amazon ASIN

• range (string, optional): Time range. "30d", "6m", "1y", "all". Default: "90d"

• domain (number, optional): Keepa domain id (default 1 = amazon.com)

Examples:

• "Is demand trending up or down for B08N5WRWNW?" -> use get_sales_rank_history

• "Show 6-month BSR history for B07PXGQC1Q" -> range="6m"

Search for Amazon products on Keepa by keyword.

Returns a list of matching ASINs. Use get_product on any returned ASIN to fetch full product details, prices, and history.

Args:

• keyword (string): Search term, e.g. "wireless earbuds"

• category_id (number, optional): Restrict to a Keepa category id.

• domain (number, optional): Keepa domain id (default 1 = amazon.com)

Examples:

• "Find products for 'yoga mat'" -> keyword="yoga mat"

• "Search Electronics for 'USB-C hub'" -> keyword="USB-C hub", category_id=172282

Get the top-selling ASINs in a Keepa category.

Returns an ordered list of ASINs. Find category ids at: https://keepa.com/#!categorytree/1

Common category ids (amazon.com):

• 172282: Electronics

• 1055398: Computers & Accessories

• 3760901: Camera & Photo

• 2619533: Musical Instruments

• 284507: Kitchen & Dining

Args:

• category_id (number): Keepa category id

• domain (number, optional): Keepa domain id (default 1 = amazon.com)

Examples:

• "What are the best sellers in Electronics?" -> category_id=172282

• "Top Kitchen products" -> category_id=284507

Fetch current Amazon price-drop deals from Keepa.

Returns products where the price has dropped significantly, filtered by minimum price drop percentage and minimum rating.

Args:

• min_price_drop_pct (number, optional): Minimum % price drop (1-99). Default: 20

• min_rating (number, optional): Min rating 0-50 (45 = 4.5 stars). Default: 40

• page (number, optional): Page offset for pagination. Default: 0

• domain (number, optional): Keepa domain id (default 1 = amazon.com)

Examples:

• "Show me deals with at least 30% off" -> min_price_drop_pct=30

• "Find highly-rated products on sale" -> min_rating=45, min_price_drop_pct=20