# Amazon API

> Amazon returns product listings, details, reviews, best sellers, and deals, available as a workflow and API.

Amazon Search products returns listings and displayed prices for a required query, with optional country, price, sort, Prime, and page inputs. Amazon Get product returns displayed details for a required product name or link; Get product reviews returns ratings and visible reviews. Amazon List best sellers needs a category; List deals can take a country, category, and minimum discount.

- Page: https://fous.com/tools/amazon
- Handle: `@amazon`
- Category: [Commerce](https://fous.com/tools/category/commerce)
- Source website: https://amazon.com
- Last verified: Sep 29, 2026

## Methods

### Get product

Operation `get_product`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get details for an Amazon product by name or link in a selected country store. Offer prices, delivery and variants may be absent when not displayed publicly.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `country` | string | no | `"Germany"` | Amazon store country name or two-letter code, such as United Kingdom or GB. |
| `product` | string | yes | `"https://www.amazon.com/dp/B0D1XD1ZV3"` | Product name, such as Apple AirPods Pro 2, or an Amazon product link. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "product"
  ],
  "properties": {
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Amazon store country name or two-letter code, such as United Kingdom or GB.",
      "examples": [
        "Germany"
      ]
    },
    "product": {
      "type": "string",
      "description": "Product name, such as Apple AirPods Pro 2, or an Amazon product link.",
      "examples": [
        "https://www.amazon.com/dp/B0D1XD1ZV3",
        "https://www.amazon.com/dp/B0FQFB8FMG",
        "https://www.amazon.de/dp/B0D1XD1ZV3"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "product": "https://www.amazon.com/dp/B0D1XD1ZV3"
    },
    {
      "product": "https://www.amazon.com/dp/B0FQFB8FMG"
    },
    {
      "country": "Germany",
      "product": "https://www.amazon.de/dp/B0D1XD1ZV3"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `asin` | string | `"B0D1XD1ZV3"` | Amazon product identifier. |
| `brand` | string or null | `"Apple"` | Product brand. |
| `title` | string | `"Apple AirPods Pro 2 Wireless Earbuds, Active Noise Cancellation, Hearing Aid Feature, Bluetooth Headphones, Transparenc` | Product title. |
| `sold_by` | string or null | `"Amazon Resale"` | Displayed seller. |
| `currency` | string | `"USD"` | ISO currency code. |
| `variants` | array |  | Displayed product variants, with price if known. |
| `variants[].name` | string | `"Without AppleCare+"` |  |
| `variants[].price` | number or null | `237.49` |  |
| `variants[].currency` | string | `"USD"` |  |
| `variants[].product_link` | string | `"https://www.amazon.com/dp/B0D1XD1ZV3"` |  |
| `list_price` | number or null | `249` | List or typical price. |
| `ships_from` | string or null | `"Amazon"` | Displayed fulfillment provider. |
| `image_links` | array |  | Product image links. |
| `star_rating` | number or null | `4.6` | Average star rating. |
| `availability` | string or null | `"Only 1 left in stock - order soon."` | Availability shown by Amazon. |
| `product_link` | string | `"https://www.amazon.com/dp/B0D1XD1ZV3"` | Amazon product page link. |
| `current_price` | number or null | `237.49` | Current displayed offer price. |
| `savings_amount` | number or null | `15` | Savings compared with list price. |
| `specifications` | array |  | Product specifications. |
| `specifications[].name` | string | `"Brand"` |  |
| `specifications[].value` | string | `"Apple"` |  |
| `feature_bullets` | array |  | Product feature bullet points. |
| `savings_percent` | number or null | `6` | Percent saved from list price. |
| `delivery_estimate` | string or null | `"FREE delivery Saturday, October 3 Or fastest delivery Friday, October 2"` | Displayed delivery estimate. |
| `number_of_ratings` | integer or null | `46826` | Total ratings. |
| `ratings_by_star_percent` | object |  | Percent of ratings per star, 5 through 1 when available. |

**Example input**

```json
{
  "product": "https://www.amazon.com/dp/B0D1XD1ZV3"
}
```

**Example output**

```json
{
  "asin": "B0D1XD1ZV3",
  "brand": "Apple",
  "title": "Apple AirPods Pro 2 Wireless Earbuds, Active Noise Cancellation, Hearing Aid Feature, Bluetooth Headphones, Transparency, Personalized Spatial Audio, High-Fidelity Sound, H2 Chip, USB-C Charging",
  "sold_by": "Amazon Resale",
  "currency": "USD",
  "variants": [
    {
      "name": "Without AppleCare+",
      "price": 237.49,
      "currency": "USD",
      "product_link": "https://www.amazon.com/dp/B0D1XD1ZV3"
    }
  ],
  "list_price": null,
  "ships_from": "Amazon",
  "image_links": [
    "https://m.media-amazon.com/images/I/61SUj2aKoEL._AC_SL1500_.jpg",
    "https://m.media-amazon.com/images/I/611pEx7220L._AC_SL1500_.jpg",
    "https://m.media-amazon.com/images/I/81Zg3Ev2M5L._AC_SL1500_.jpg"
  ],
  "star_rating": 4.6,
  "availability": "Only 1 left in stock - order soon.",
  "product_link": "https://www.amazon.com/dp/B0D1XD1ZV3",
  "current_price": 237.49,
  "savings_amount": null,
  "specifications": [
    {
      "name": "Brand",
      "value": "Apple"
    },
    {
      "name": "Color",
      "value": "White"
    },
    {
      "name": "Ear Placement",
      "value": "In Ear"
    }
  ],
  "feature_bullets": [
    "PIONEERING HEARING — AirPods Pro 2 unlock the world’s first all-in-one hearing health experience: a scientifically validated Hearing Test,* clinical-grade and active Hearing Protection.*",
    "INTELLIGENT NOISE CONTROL — Active Noise Cancellation removes up to 2x more background noise.* Transparency mode lets you hear the world around you, and Adaptive Audio seamlessly blends Active Noise C…",
    "IMPROVED SOUND AND CALL QUALITY — The Apple-designed H2 chip helps to create deeply immersive sound. The low-distortion, custom-built driver delivers crisp, clear high notes and full, rich bass in stu…"
  ],
  "savings_percent": null,
  "delivery_estimate": "FREE delivery Saturday, October 3 Or fastest delivery Friday, October 2",
  "number_of_ratings": 46826,
  "ratings_by_star_percent": {}
}
```

### Get product reviews

Operation `get_product_reviews`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get ratings, the Customers say summary, and reviews shown on an Amazon product page from a product name or link. Only reviews visible on the product page are included; some stores may restrict access.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `country` | string | no |  | Amazon store country name or two-letter code, e.g. United Kingdom or GB. |
| `product` | string | yes | `"https://www.amazon.com/dp/B0D1XD1ZV3"` | Product name or Amazon product link, e.g. Apple AirPods Pro 2 or https://www.amazon.com/dp/B0D1XD1ZV3 |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "product"
  ],
  "properties": {
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Amazon store country name or two-letter code, e.g. United Kingdom or GB."
    },
    "product": {
      "type": "string",
      "description": "Product name or Amazon product link, e.g. Apple AirPods Pro 2 or https://www.amazon.com/dp/B0D1XD1ZV3",
      "examples": [
        "https://www.amazon.com/dp/B0D1XD1ZV3",
        "https://www.amazon.com/dp/B0DT2LTRL7"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "product": "https://www.amazon.com/dp/B0D1XD1ZV3"
    },
    {
      "product": "https://www.amazon.com/dp/B0DT2LTRL7"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `reviews` | array |  |  |
| `reviews[].text` | string or null | `"I bought and used many different earbuds throughout the years. But these are perfect.\n\nThey are comfortable, they sta` |  |
| `reviews[].stars` | number or null | `5` |  |
| `reviews[].title` | string or null | `"Fantastic product"` |  |
| `reviews[].page_link` | string | `"https://www.amazon.com/dp/B0D1XD1ZV3#R2F59TQ95B0LBQ"` |  |
| `reviews[].review_date` | string or null | `"2026-08-12"` |  |
| `reviews[].reviewer_name` | string or null | `"Zach"` |  |
| `reviews[].review_country` | string or null | `"United States"` |  |
| `reviews[].verified_purchase` | boolean | `true` |  |
| `reviews[].helpful_vote_count` | integer | `1` |  |
| `product_link` | string | `"https://www.amazon.com/dp/B0D1XD1ZV3"` |  |
| `product_name` | string | `"Apple AirPods Pro 2 Wireless Earbuds, Active Noise Cancellation, Hearing Aid Feature, Bluetooth Headphones, Transparenc` |  |
| `customers_say` | string or null | `"Customers have mixed opinions about these earbuds' sound quality, with some finding them clear while others report poor` |  |
| `star_1_percent` | integer or null | `4` |  |
| `star_2_percent` | integer or null | `1` |  |
| `star_3_percent` | integer or null | `3` |  |
| `star_4_percent` | integer or null | `8` |  |
| `star_5_percent` | integer or null | `84` |  |
| `number_of_ratings` | integer or null | `46826` |  |
| `overall_star_rating` | number or null | `4.6` |  |

**Example input**

```json
{
  "product": "https://www.amazon.com/dp/B0D1XD1ZV3"
}
```

**Example output**

```json
{
  "reviews": [
    {
      "text": "I've been impressed with the incredible sound quality. There is noticeably better bass distribution with these AirPods compared to prior generations. The silicone tips allow for long listening session…",
      "stars": 5,
      "title": "Fantastic product",
      "page_link": "https://www.amazon.com/dp/B0D1XD1ZV3#R2F59TQ95B0LBQ",
      "review_date": "2026-08-12",
      "reviewer_name": "Zach",
      "review_country": "United States",
      "verified_purchase": true,
      "helpful_vote_count": 1
    },
    {
      "text": "First, please comment if you have any questions and I would love to respond to help!\n\nI had the AirPods Pro Gen1 prior to these, but the new AirPods blew them out of the water. The added ear tips make…",
      "stars": 5,
      "title": "READ BEFORE PURCHASE! 😊",
      "page_link": "https://www.amazon.com/dp/B0D1XD1ZV3#R3H55DLDY8DCXL",
      "review_date": "2024-08-09",
      "reviewer_name": "Bob",
      "review_country": "United States",
      "verified_purchase": true,
      "helpful_vote_count": 3264
    }
  ],
  "product_link": "https://www.amazon.com/dp/B0D1XD1ZV3",
  "product_name": "Apple AirPods Pro 2 Wireless Earbuds, Active Noise Cancellation, Hearing Aid Feature, Bluetooth Headphones, Transparency, Personalized Spatial Audio, High-Fidelity Sound, H2 Chip, USB-C Charging",
  "customers_say": "Customers find these wireless earbuds offer great sound quality, amazing noise cancellation, and work better than hearing aids. They are comfortable, allowing wear for hours without discomfort, and cu…",
  "star_1_percent": 4,
  "star_2_percent": 1,
  "star_3_percent": 3,
  "star_4_percent": 8,
  "star_5_percent": 84,
  "number_of_ratings": 46826,
  "overall_star_rating": 4.6
}
```

### List best sellers

Operation `list_best_sellers`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

List current Amazon Best Sellers in the closest matching top-level category for a store country. Prices, ratings, and photos may be missing; up to 100 ranked products.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `country` | string | no | `"United Kingdom"` | Store country name or two-letter code, for example United Kingdom or DE. |
| `category` | string | yes | `"kitchen"` | Category in plain words, such as kitchen, books, toys, or electronics. |
| `max_results` | integer | no | `70` | Maximum products to list, for example 50. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "category"
  ],
  "properties": {
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Store country name or two-letter code, for example United Kingdom or DE.",
      "examples": [
        "United Kingdom",
        "Germany",
        "India"
      ]
    },
    "category": {
      "type": "string",
      "description": "Category in plain words, such as kitchen, books, toys, or electronics.",
      "examples": [
        "kitchen",
        "books",
        "toys"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum products to list, for example 50.",
      "x-fous-developer": true,
      "examples": [
        70,
        8,
        5
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "category": "kitchen"
    },
    {
      "category": "books",
      "max_results": 70
    },
    {
      "country": "United Kingdom",
      "category": "toys",
      "max_results": 8
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `products` | array |  | Best sellers in rank order. |
| `products[].asin` | string or null | `"B085DVHQ57"` |  |
| `products[].rank` | integer | `1` |  |
| `products[].price` | number or null | `29.99` |  |
| `products[].photo_link` | string or null | `"https://images-na.ssl-images-amazon.com/images/I/71Cfld2aMpL._AC_UL300_SR300,200_.jpg"` |  |
| `products[].star_rating` | number or null | `4.6` |  |
| `products[].product_link` | string | `"https://www.amazon.com/Owala-FreeSip-SS-Very-Dark/dp/B085DVHQ57"` |  |
| `products[].product_name` | string | `"Owala FreeSip Stainless Steel Water Bottle 32 oz Very, Very Dark"` |  |
| `products[].currency_code` | string or null | `"USD"` |  |
| `products[].number_of_ratings` | integer or null | `139695` |  |
| `category_link` | string | `"https://www.amazon.com/Best-Sellers-Kitchen-Dining/zgbs/kitchen"` | Page for this category on the selected Amazon store. |
| `category_name` | string | `"Kitchen & Dining"` | Amazon category used for this list. |

**Example input**

```json
{
  "category": "kitchen"
}
```

**Example output**

```json
{
  "products": [
    {
      "asin": "B085DVHQ57",
      "rank": 1,
      "price": 29.99,
      "photo_link": "https://images-na.ssl-images-amazon.com/images/I/71Cfld2aMpL._AC_UL300_SR300,200_.jpg",
      "star_rating": 4.6,
      "product_link": "https://www.amazon.com/Owala-FreeSip-SS-Very-Dark/dp/B085DVHQ57",
      "product_name": "Owala FreeSip Stainless Steel Water Bottle 32 oz Very, Very Dark",
      "currency_code": "USD",
      "number_of_ratings": 139695
    },
    {
      "asin": "B0H2G7NFDN",
      "rank": 2,
      "price": 44.99,
      "photo_link": "https://images-na.ssl-images-amazon.com/images/I/61zAtJ8DLdL._AC_UL300_SR300,200_.jpg",
      "star_rating": 4.6,
      "product_link": "https://www.amazon.com/HydroJug-Traveler-Insulated-Tumbler-Vanilla/dp/B0H2G7NFDN",
      "product_name": "HydroJug Polka Dot Traveler 40oz, Insulated Tumbler, French Vanilla | Triple wall insulated, flip straw lid, leak-resistant, stainless steel, cup holder friendly, BPA-free, Polka Dot",
      "currency_code": "USD",
      "number_of_ratings": 18315
    },
    {
      "asin": "B0113UZJE2",
      "rank": 3,
      "price": 13.99,
      "photo_link": "https://images-na.ssl-images-amazon.com/images/I/91YrLTBnMcL._AC_UL300_SR300,200_.jpg",
      "star_rating": 4.6,
      "product_link": "https://www.amazon.com/Etekcity-Multifunction-Stainless-Batteries-Included/dp/B0113UZJE2",
      "product_name": "Etekcity Food Kitchen Scale, Digital Grams and Ounces, 11lb | Tare function, ideal for baking, weight loss, keto, meal prep, packages, liquids and jewelry, 304 Stainless Steel",
      "currency_code": "USD",
      "number_of_ratings": 177411
    }
  ],
  "category_link": "https://www.amazon.com/Best-Sellers-Kitchen-Dining/zgbs/kitchen",
  "category_name": "Kitchen & Dining"
}
```

### List deals

Operation `list_deals`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

List current public Today's Deals in page order for an Amazon store. Some deal details are shown only when Amazon provides them.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `country` | string | no | `"United Kingdom"` | Amazon store country name or two-letter code, such as United Kingdom or GB. |
| `category` | string | no | `"home"` | Deal category in plain words, such as home. Defaults to all categories. |
| `max_results` | integer | no | `5` | Maximum number of deals to return, such as 30. |
| `min_discount_percent` | number | no | `20` | Minimum percentage off, such as 25. |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Amazon store country name or two-letter code, such as United Kingdom or GB.",
      "examples": [
        "United Kingdom",
        "Germany",
        "India"
      ]
    },
    "category": {
      "type": "string",
      "default": "all",
      "description": "Deal category in plain words, such as home. Defaults to all categories.",
      "examples": [
        "home"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 30,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum number of deals to return, such as 30.",
      "x-fous-developer": true,
      "examples": [
        5,
        3,
        2
      ]
    },
    "min_discount_percent": {
      "type": "number",
      "default": 0,
      "maximum": 100,
      "minimum": 0,
      "description": "Minimum percentage off, such as 25.",
      "examples": [
        20
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {},
    {
      "country": "United Kingdom",
      "category": "home",
      "max_results": 5,
      "min_discount_percent": 20
    },
    {
      "country": "Germany",
      "max_results": 3
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `deals` | array |  |  |
| `deals[].asin` | string | `"B09B93ZDG4"` |  |
| `deals[].deal_type` | string or null | `"Limited time deal"` |  |
| `deals[].time_left` | string or null |  |  |
| `deals[].deal_price` | number or null | `39.99` |  |
| `deals[].photo_link` | string or null | `"https://m.media-amazon.com/images/I/615mmVM4qQL.jpg"` |  |
| `deals[].star_rating` | number or null | `4.7` |  |
| `deals[].product_link` | string | `"https://www.amazon.com/Amazon-Vibrant-sounding-speaker-bedrooms/dp/B09B93ZDG4"` |  |
| `deals[].product_name` | string | `"Amazon Echo Dot (newest model) - Vibrant sounding speaker, Designed for Alexa+, Great for bedrooms, dining rooms and of` |  |
| `deals[].currency_code` | string | `"USD"` |  |
| `deals[].original_price` | number or null | `79.99` |  |
| `deals[].percent_claimed` | number or null |  |  |
| `deals[].discount_percent` | number or null | `50` |  |
| `deals[].number_of_ratings` | integer or null | `200149` |  |

**Example input**

```json
{}
```

**Example output**

```json
{
  "deals": [
    {
      "asin": "B09B93ZDG4",
      "deal_type": "Limited time deal",
      "time_left": null,
      "deal_price": 39.99,
      "photo_link": "https://m.media-amazon.com/images/I/615mmVM4qQL.jpg",
      "star_rating": 4.7,
      "product_link": "https://www.amazon.com/Amazon-Vibrant-sounding-speaker-bedrooms/dp/B09B93ZDG4",
      "product_name": "Amazon Echo Dot (newest model) - Vibrant sounding speaker, Designed for Alexa+, Great for bedrooms, dining rooms and offices, Deep Sea Blue",
      "currency_code": "USD",
      "original_price": 79.99,
      "percent_claimed": null,
      "discount_percent": 50,
      "number_of_ratings": 200149
    },
    {
      "asin": "B09B2QTGFY",
      "deal_type": "Limited time deal",
      "time_left": null,
      "deal_price": 59.99,
      "photo_link": "https://m.media-amazon.com/images/I/61DPOznwayL.jpg",
      "star_rating": 4.2,
      "product_link": "https://www.amazon.com/All-new-release-display-clearer-Glacier/dp/B09B2QTGFY",
      "product_name": "Amazon Echo Show 5 (newest model), Smart display, Designed for Alexa+, 2x the bass and clearer sound, Glacier White",
      "currency_code": "USD",
      "original_price": 99.99,
      "percent_claimed": null,
      "discount_percent": 40,
      "number_of_ratings": 72426
    },
    {
      "asin": "B0G2D1R15Q",
      "deal_type": "Limited time deal",
      "time_left": null,
      "deal_price": 39.99,
      "photo_link": "https://m.media-amazon.com/images/I/51kY6VkfPeL.jpg",
      "star_rating": 4.2,
      "product_link": "https://www.amazon.com/Ring-Battery-Doorbell-newest-Built/dp/B0G2D1R15Q",
      "product_name": "Ring Battery Doorbell 2K (newest model) Retinal 2K with wide-angle video, up to 6x Enhanced Zoom, Two-Way Talk, and Built-In Battery, Matte Mocha",
      "currency_code": "USD",
      "original_price": 99.99,
      "percent_claimed": null,
      "discount_percent": 60,
      "number_of_ratings": 6576
    }
  ]
}
```

### Search products

Operation `search_products`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Search Amazon products in a chosen country, with price, sort, Prime, and page options. Returns the listings and prices shown to an anonymous shopper; availability and pricing vary by location.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `page` | integer | no | `2` | First Amazon results page to read, for example 2. |
| `sort` | string | no | `"price_low_to_high"` | Order products by best match, price, newness, or customer reviews, for example price_low_to_high. |
| `query` | string | yes | `"coffee grinder"` | What to search for, for example wireless earbuds. |
| `country` | string | no | `"Germany"` | Amazon store country name or two-letter code, for example United Kingdom or GB. |
| `max_price` | number | no | `150` | Highest price in the store’s currency, for example 100.00. |
| `min_price` | number | no | `20` | Lowest price in the store’s currency, for example 25.00. |
| `prime_only` | boolean | no | `true` | Show only Prime-eligible results, for example true. |
| `max_results` | integer | no | `4` | Maximum products to return, for example 20 (up to 60). |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "First Amazon results page to read, for example 2.",
      "x-fous-developer": true,
      "examples": [
        2
      ]
    },
    "sort": {
      "enum": [
        "best_match",
        "price_low_to_high",
        "price_high_to_low",
        "newest",
        "top_rated"
      ],
      "type": "string",
      "default": "best_match",
      "description": "Order products by best match, price, newness, or customer reviews, for example price_low_to_high.",
      "examples": [
        "price_low_to_high"
      ]
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "What to search for, for example wireless earbuds.",
      "examples": [
        "coffee grinder",
        "wireless earbuds",
        "usb c cable"
      ]
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Amazon store country name or two-letter code, for example United Kingdom or GB.",
      "examples": [
        "Germany"
      ]
    },
    "max_price": {
      "type": "number",
      "minimum": 0,
      "description": "Highest price in the store’s currency, for example 100.00.",
      "examples": [
        150
      ]
    },
    "min_price": {
      "type": "number",
      "minimum": 0,
      "description": "Lowest price in the store’s currency, for example 25.00.",
      "examples": [
        20
      ]
    },
    "prime_only": {
      "type": "boolean",
      "default": false,
      "description": "Show only Prime-eligible results, for example true.",
      "examples": [
        true
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 60,
      "minimum": 1,
      "description": "Maximum products to return, for example 20 (up to 60).",
      "x-fous-developer": true,
      "examples": [
        4,
        5,
        3
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "page": 2,
      "sort": "price_low_to_high",
      "query": "coffee grinder",
      "country": "Germany",
      "max_price": 150,
      "min_price": 20,
      "max_results": 4
    },
    {
      "query": "wireless earbuds",
      "max_results": 5
    },
    {
      "query": "wireless earbuds"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `products` | array |  |  |
| `products[].asin` | string | `"B0DNZDSWNX"` |  |
| `products[].price` | number or null | `20.99` |  |
| `products[].prime` | boolean | `false` |  |
| `products[].sponsored` | boolean | `false` |  |
| `products[].list_price` | number or null | `199.99` |  |
| `products[].photo_link` | string or null | `"https://m.media-amazon.com/images/I/61EMhMvIIlL._AC_UY218_.jpg"` |  |
| `products[].star_rating` | number or null | `4.6` |  |
| `products[].product_link` | string | `"https://www.amazon.de/dp/B0DNZDSWNX"` |  |
| `products[].product_name` | string | `"Kaffeemühle für Einmachgläser Tragbare manuelle Handkurbel"` |  |
| `products[].currency_code` | string | `"EUR"` |  |
| `products[].discount_percent` | number or null | `90` |  |
| `products[].number_of_ratings` | integer or null | `17` |  |

**Example input**

```json
{
  "page": 2,
  "sort": "price_low_to_high",
  "query": "coffee grinder",
  "country": "Germany",
  "max_price": 150,
  "min_price": 20,
  "max_results": 4
}
```

**Example output**

```json
{
  "products": [
    {
      "asin": "B0DNZDSWNX",
      "price": 20.99,
      "prime": false,
      "sponsored": false,
      "list_price": null,
      "photo_link": "https://m.media-amazon.com/images/I/61EMhMvIIlL._AC_UY218_.jpg",
      "star_rating": null,
      "product_link": "https://www.amazon.de/dp/B0DNZDSWNX",
      "product_name": "Kaffeemühle für Einmachgläser Tragbare manuelle Handkurbel",
      "currency_code": "EUR",
      "discount_percent": null,
      "number_of_ratings": null
    },
    {
      "asin": "B0HKY7STR1",
      "price": 21.24,
      "prime": false,
      "sponsored": false,
      "list_price": null,
      "photo_link": "https://m.media-amazon.com/images/I/41KsckSHIuL._AC_UY218_.jpg",
      "star_rating": null,
      "product_link": "https://www.amazon.de/dp/B0HKY7STR1",
      "product_name": "Manuelle Kaffeemühle aus Edelstahl und Keramik, Tragbar",
      "currency_code": "EUR",
      "discount_percent": null,
      "number_of_ratings": null
    },
    {
      "asin": "B0HKKMKT3F",
      "price": 21.28,
      "prime": false,
      "sponsored": false,
      "list_price": null,
      "photo_link": "https://m.media-amazon.com/images/I/71RTg82i-BL._AC_UY218_.jpg",
      "star_rating": null,
      "product_link": "https://www.amazon.de/dp/B0HKKMKT3F",
      "product_name": "Fafeicy Manuelle Kaffeemühle, Wasserdichte Reise-Aufbewahrungstasche",
      "currency_code": "EUR",
      "discount_percent": null,
      "number_of_ratings": null
    }
  ]
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@amazon",
  "visibility": "public",
  "operation": "get_product",
  "version": 1,
  "input": {
    "product": "https://www.amazon.com/dp/B0D1XD1ZV3"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@amazon\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_product\",\n  \"version\": 1,\n  \"input\": {\n    \"product\": \"https://www.amazon.com/dp/B0D1XD1ZV3\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@amazon",
  "visibility": "public",
  "operation": "get_product",
  "version": 1,
  "input": {
    "product": "https://www.amazon.com/dp/B0D1XD1ZV3"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/amazon`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_product`: Get product. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `get_product_reviews`: Get product reviews. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `list_best_sellers`: List best sellers. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `list_deals`: List deals. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `search_products`: Search products. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-amazon https://api.fous.com/mcp/tools/amazon --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Compare displayed prices across product search results.
- Review product details, ratings, and shown availability.
- Summarize visible customer reviews for product research.
- Track ranked best sellers in a category.
- Find deals by category and discount.

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Amazon tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a Amazon account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from amazon.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.

### What products match a search, and what do they cost?

Search products returns listings and displayed prices for a query, with optional country, price, sort, Prime, and page inputs.

### What details and ratings does a product page show?

Get product returns displayed product details and ratings for a product name or link.

### What are shoppers saying about a product?

Get product reviews returns the Customers say summary, ratings, and reviews visible on the product page.

## Related

- [All Commerce tools](https://fous.com/tools/category/commerce)