amazon_search
Read-onlyIdempotent
Get parsed Amazon search results with product name, price, rating, review count, and Prime status for any keyword, enabling product discovery and price research.
Instructions
Retrieve parsed Amazon search results for a query.
Returns structured search results — product name, price, rating, review
count, URL, image, Prime/best-seller/sponsored flags — plus pagination,
for a keyword search on Amazon.
When to use:
- Discovering products and their ASINs for a search term
- Price/market research and catalog building across a category
When NOT to use:
- You already have an ASIN (use 'amazon_product' / 'amazon_offers')
Args:
params (AmazonSearchParams): query (required) plus optional page,
sort_by, department, ref, tld, country_code, language, and
output_format.
Returns:
str: JSON (default) or CSV containing the structured search results.
Raises:
ToolError: If the API key is missing, the rate limit is exceeded, or
the request fails.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |