search
Filtered query over the tracked-product warehouse (24M+ 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, brand, or category. 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 paid plans only (sign in or an API key; the no-signup lane has the shopping tool only). 1 credit per 25 rows returned. Empty result sets are never billed. SELLER FEEDBACK (2026-09-18): the response also carries seller_ratings - a separate array with seller_positive_pct, seller_feedback_count, seller_rating and observed_at for every buy-box seller named in the rows (Amazon marketplaces; absent on Walmart). Row shapes are unchanged. Not 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. | |
| fbm | No | Only merchant-fulfilled listings. The counterpart of fba, which was already exposed. | |
| 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). | |
| seller | No | Restrict to products this seller has been observed offering. REFINEMENT ONLY - cannot be used on its own; pair it with an anchor (q, brand, or category). | |
| 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 | A department or sub-category name (e.g. 'Home & Kitchen', 'Beading Storage'), matched in full and case-insensitively against the product's category chain — comma-separate several. Works BOTH ways: as an ANCHOR on its own to browse a category with no keyword ('everything in Home & Kitchen under $30, most reviews first'), or as a REFINEMENT alongside q or brand. A category-only browse returns the category's top products by in-category best-seller rank, then applies your filters and sort. | |
| 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_max | No | Maximum average star rating. USE WHEN looking for products whose reviews are weak — an incumbent rated 3.2 is an opening. | |
| rating_min | No | Minimum star rating, on a 0-5 scale. | |
| fulfillment | No | Buy-box fulfilment of the listing: amz = sold by Amazon itself, fba = a third party fulfilled by Amazon, fbm = merchant-fulfilled. Finer than fba/fbm because it separates Amazon Retail from FBA sellers. Amazon marketplaces only. | |
| 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. | |
| seller_count_max | No | Maximum number of sellers competing on the listing. USE WHEN the user asks for products with little competition, few sellers, or an easy listing to win — this is the core sourcing filter. | |
| seller_count_min | No | Minimum number of sellers competing on the listing. USE WHEN the user wants proven demand rather than an untested listing. |