search_products

Search for candidate products matching a query, each with a data-maturity tier. Supports sorting and price/rating filters.

When to use: to shortlist candidates by keyword before deeper verification.

Parameters

Name	Type	Required	Description
`query`	string	yes	1-8 space-separated terms (title / brand / feature-bullet match)
`category_id`	string	no	Restrict to a top-level category (from `list_categories`)
`sort`	string	no	`price_asc` \	`price_desc` \	`rating_desc` \	`review_count_desc`
`min_price`	number	no	Minimum price, USD
`max_price`	number	no	Maximum price, USD
`min_rating`	number	no	Minimum average rating, 0-5

Example call

{
  "jsonrpc": "2.0", "id": 7, "method": "tools/call",
  "params": {
    "name": "search_products",
    "arguments": {"query": "power bank", "sort": "rating_desc", "max_price": 40}
  }
}

Response shape

{
  "results": [
    {
      "asin": "B01MTB55WH",
      "brand": "Anker",
      "title": "Portable Charger ...",
      "data_tier": "top",
      "price": 29.99,
      "price_as_of": "2026-11-04T08:12:00Z",
      "rating": 4.6,
      "review_count": 25000,
      "rating_distribution": {"five_star": 78, "...": "..."},
      "product_url": "https://www.amazon.com/dp/B01MTB55WH"
    }
  ],
  "notes": {"...": "..."}
}

*(abbreviated for readability; result limit 100)*

Field notes

Field	Description
`results[].data_tier`	Data-maturity tier label describing how completely this product is covered
`results[].price` / `price_as_of`	Stored price snapshot, not real-time
`results[].rating_distribution`	Full star breakdown

Tool note

> Sort with sort (price_asc | price_desc | rating_desc | review_count_desc); filter with min_price, max_price, min_rating (USD / 0-5 stars). Results include product_url and price_as_of; prices are snapshots — for a real-time quote call scrap_page. For side-by-side comparison, call compare_products with 2-5 ASINs.

Related tools

compare_products — side-by-side for the shortlist
get_product — deep verification per ASIN