search
Filter through 17M+ Amazon and Walmart products by price, rating, reviews, BSR, and other criteria. Returns a sorted list of matching products with key details.
Instructions
Filtered query over the tracked-product warehouse (17M+ Amazon and Walmart products). USE WHEN the user wants a structured list matching explicit criteria: 'well-rated dehumidifiers under $150 with 1000+ reviews', 'everything by brand X sorted by BSR', 'FBA products in this category'. DON'T USE for 'best X' buying advice (use shopping, which ranks and groups), or for a single known product (use product). RETURNS a flat list of matching products with product_id (the ASIN on Amazon, the numeric item ID on Walmart), product_url, title, brand, price, rating, review count, BSR, seller count and marketplace, ordered by the sort field. Requires an anchor: pass q or brand. Cite product_id when the user may want to act on a specific row, and pass it to the product tool for that item's full history. Every response row is observed marketplace data (the marketplace field names it). COVERAGE the continuously tracked BSR product universe, not the entire Amazon catalog. COST free lane 1 of 30 daily queries, capped at 25 rows. Keyed: 1 credit per 25 rows returned. Empty result sets are never billed.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Keyword matched against the product title. Acts as the anchor when brand is not given. Literal keywords, not semantic: every term must match, so extra or inferred words only narrow the result set. Query in the marketplace's own language — there is no translation. | |
| fba | No | true = only Fulfilled by Amazon offers, false = only merchant-fulfilled. Omit to include both. | |
| sort | No | Field to order results by. bsr sorts ascending (best sellers first); the others sort descending. | bsr |
| brand | No | Exact brand name. Acts as the anchor when q is not given. | |
| limit | No | Maximum rows to return (up to 100). The free lane caps this at 25. | |
| seller | No | Restrict to products this seller has been observed offering. | |
| bsr_max | No | Maximum Best Sellers Rank. Use this to keep only strong sellers. | |
| bsr_min | No | Minimum Best Sellers Rank. Lower BSR means stronger sales, so this excludes the best sellers. | |
| category | No | Restrict to a single product category. | |
| price_max | No | Maximum current price, in the marketplace's local currency. | |
| price_min | No | Minimum current price, in the marketplace's local currency. | |
| rating_min | No | Minimum star rating, on a 0-5 scale. | |
| marketplace | No | Which tracked marketplace to query. walmart = Walmart US (United States only). Pick the marketplace matching the user's country or locale when known; default amazon-us. | amazon-us |
| reviews_min | No | Minimum number of reviews. | |
| max_per_category | No | Cap how many results may come from any one category, to spread results across categories. |