search_products
Search Amazon by keyword or a full search/category URL and get structured product listings: ASIN, title, price, rating, review count, Prime status, and badges (Best Seller, Amazon's Choice) for each result. Also returns the available refinement filters (category, brand, price range) with their IDs.
Use this tool for market research, keyword analysis, and product discovery. If the user already has an ASIN or product URL, do NOT search — use get_product_detail directly.
Each page costs 1 credit. One page typically returns 20-40 products, which is enough for most questions. Use sort_by and exclude_sponsored to improve result quality instead of fetching more pages. To filter by category or brand, first run one search and read the refinements field in the response to discover valid filter IDs, then pass them in refinements.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Full Amazon search or category URL. Use when the user pastes an Amazon link containing filters. Mutually exclusive with keyword. | |
| domain | No | Amazon marketplace domain extension. Determines the regional Amazon site the data is fetched from. Use the domain that matches the user's market — prices, availability and rankings differ across marketplaces. | .com |
| keyword | No | Search query as a user would type it into Amazon (e.g. 'stainless steel water bottle 40oz'). Mutually exclusive with url. | |
| sort_by | No | Result ordering. 'featured' is Amazon's default; 'price-asc-rank' cheapest first; 'price-desc-rank' most expensive; 'review-rank' most reviewed; 'date-desc-rank' newest listings; 'exact-aware-popularity-rank' by popularity. | featured |
| currency | No | ISO currency code for price display (e.g. usd, eur, try). Prices are converted by Amazon's own display logic. | |
| language | No | Language code for the Amazon page, in locale format (e.g. en_US, de_DE, tr_TR). Affects the language of titles, descriptions and reviews in the response. | |
| max_page | No | Ending page number. Each page costs 1 credit; max 5 pages per request. Default 1. | |
| min_page | No | Starting page number. Default 1. | |
| refinements | No | Category/attribute filters in Amazon's format: 'n:<category_id>,p_<filter_group>:<filter_id>'. Discover valid IDs from the refinements field of a previous search response. Example: 'n:7141123011,p_123:502215'. | |
| exclude_sponsored | No | If true, removes sponsored (paid ad) products from results. Recommended true for organic market analysis. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Parsed Amazon data for the operation. | |
| success | Yes | True when the request completed. | |
| operation | Yes | Easyparser operation that ran, e.g. DETAIL or OFFER. | |
| request_id | No | Easyparser request ID, useful for support and error logs. | |
| credits_used | No | Credits charged for this request. | |
| credits_remaining | No | Credits left on the account after this request. |