> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/search_amazon

# search_amazon

> Amazon search results for a keyword in a country marketplace: title, price, rating, review count, ASIN, Prime. ₹1.67 per page; a search the source could not complete is ₹0.

## What it does

Amazon search results for a `keyword` in one `country`'s marketplace (`IN` for amazon.in), in `data.products[]`: `asin`, `product_title`, `product_price`, `product_original_price`, `currency`, `product_star_rating`, `product_num_ratings`, `product_url`, `product_photo`, `is_prime`, `is_best_seller`, `is_amazon_choice`, about 48 per page, with `data.total_products`. `sortBy` `RELEVANCE`, `REVIEWS`, `BEST_SELLERS`, `LOWEST_PRICE`, `HIGHEST_PRICE` or `NEWEST`; `page` for more. Use it to see how a category is priced and who wins it; for one listing in full [`get_amazon_product`](https://parel.si/docs/tools/get_amazon_product.md).

India: `country: "IN"`; prices come back in rupees. The default is the United States.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `page` | integer | no | Page number for pagination.. e.g. 1 |
| `sortBy` | `RELEVANCE` or `LOWEST_PRICE` or `HIGHEST_PRICE` or `REVIEWS` or `NEWEST` or `BEST_SELLERS` | no | Sort order for Amazon product search results. Available Values: - `RELEVANCE`: Relevance - `LOWEST_PRICE`: Lowest Price - `HIGHEST_PRICE`: Highest Price - `REVIEWS`: Reviews - `NEWEST`: Newest - `BEST_SELLERS`: Best Sellers One of: RELEVANCE, LOWEST_PRICE, HIGHEST_PRICE, REVIEWS, NEWEST, BEST_SELLERS.. e.g. "RELEVANCE" |
| `country` | `US` or `AU` or `BR` or `CA` or `CN` or `FR` or `DE` or `IN` or `IT` or `MX` or `NL` or `SG` or `ES` or `TR` or `AE` or `GB` or `JP` or `SA` or `PL` or `SE` or `BE` or `EG` or `ZA` or `IE` | no | Country code for the Amazon marketplace. Available Values: - `US`: United States - `AU`: Australia - `BR`: Brazil - `CA`: Canada - `CN`: China - `FR`: France - `DE`: Germany - `IN`: India - `IT`: Italy - `MX`: Mexico - `NL`: Netherlands - `SG`: Singapore - `ES`: Spain - `TR`: Turkey - `AE`: United A One of: US, AU, BR, CA, CN, FR, DE, IN, IT, MX, NL, SG.. e.g. "US" |
| `keyword` | string | yes | Search keyword or ASIN to find Amazon products. |

## What drives the cost

Nothing: flat per page. A search the source could not complete is `class: "ok_free"`, ₹0: retry once. Usually four to eight seconds.

## Price today

| | |
|---|---|
| Price today | **₹1.67** per page (`cost_paise: 167`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹2.51 (`hold_paise: 251`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "search_amazon"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_amazon"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"search_amazon","input":{"page":1,"sortBy":"REVIEWS","country":"IN","keyword":"protein bar"}}'
```

## What comes back

`data.products[]` and `data.total_products`. A real answer recorded during the live check of 2026-10-28, trimmed to two products:

```json
{
  "total_products": 16436,
  "country": "IN",
  "domain": "www.amazon.in",
  "products": [
    {
      "asin": "B07KZ1XVQ2",
      "product_title": "RiteBite Max Protein Daily Choco Almond Protein Bar [Pack Of 1],50 Gram",
      "product_price": "₹66",
      "unit_price": "₹132",
      "unit_count": null,
      "product_original_price": "₹71",
      "currency": "INR",
      "product_star_rating": "3.9",
      "product_num_ratings": 174,
      "product_url": "https://www.amazon.in/dp/B07KZ1XVQ2",
      "product_photo": "https://m.media-amazon.com/images/I/51RsSDHy0eL._AC_UL960_FMwebp_QL65_.jpg",
      "product_num_offers": 1,
      "product_minimum_offer_price": "₹66",
      "is_best_seller": false,
      "is_amazon_choice": false,
      "is_prime": false,
      "product_availability": "Only 1 left in stock.",
      "climate_pledge_friendly": false,
      "sales_volume": "7K+ bought in past month",
      "delivery": "FREE delivery Fri, 30 Oct on ₹499 of items fulfilled by AmazonOr fastest delivery Tomorrow 8 am - 12 pmArrives before DiwaliOnly 1 left in stock.",
      "has_variations": false,
      "product_byline": "Dark Chocolate"
    },
    {
      "asin": "B01M69GJOO",
      "product_title": "RiteBite Max Protein Daily Choco Almond Protein Bars with 10g Protein, 5g Fiber & 21 Vit. & Minerals | 0 Added Sugar, No Cholesterol & Trans Fat For Upto 2h of Energy, Healthy Snack, 50g (Pack of 6)",
      "product_price": "₹415",
      "unit_price": "₹138.33",
      "unit_count": null,
      "product_original_price": "₹426",
      "currency": "INR",
      "product_star_rating": "4.3",
      "product_num_ratings": 6555,
      "product_url": "https://www.amazon.in/dp/B01M69GJOO",
      "product_photo": "https://m.media-amazon.com/images/I/71aetSWrITL._AC_UL960_FMwebp_QL65_.jpg",
      "product_num_offers": 1,
      "product_minimum_offer_price": "₹415",
      "is_best_seller": false,
      "is_amazon_choice": false,
      "is_prime": false,
      "climate_pledge_friendly": false,
      "sales_volume": "5K+ bought in past month",
      "delivery": "FREE delivery Sun, 1 Nov on ₹499 of items fulfilled by AmazonOr fastest delivery Fri, 30 OctArrives before Diwali",
      "has_variations": false,
      "product_byline": "Choco Almond"
    },
    "… 46 more item(s) truncated"
  ]
}
```

## Notes

- About 48 products per page; page 2, 3... for more, each a call.
- India: country "IN" (amazon.in, prices in ₹). Default is the United States.
- Usually four to eight seconds. A failed collection is free; retry once.

## Siblings

- [`get_amazon_product`](https://parel.si/docs/tools/get_amazon_product.md) for one listing in full.
- [`keyword_volume`](https://parel.si/docs/tools/keyword_volume.md) for how many people search the keyword on Google.
