# Amazon API: Search products

> Searches Amazon products in a chosen country store, with price range, sort, Prime and page options. Returns the listings and prices shown to an anonymous shopper in the store's currency.

Unofficial. Not affiliated with or endorsed by Amazon.

- Page: https://fous.com/methods/amazon.com/search-products
- Method: `amazon.com/search_products`, version 1
- Website: amazon.com
- Returns: product name, price, currency, list price, discount, star rating, number of ratings, Prime, sponsored, photo, link, ASIN
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `page` | integer | no |  | First Amazon results page to read, for example 2. Default 1. |
| `sort` | string | no |  | Order products by best match, price, newness, or customer reviews, for example price_low_to_high. One of "best_match", "price_low_to_high", "price_high_to_low", "newest", "top_rated". Default "best_match". |
| `query` | string | yes | `"wireless earbuds"` | What to search for, for example wireless earbuds. |
| `country` | string | no |  | Amazon store country name or two-letter code, for example United Kingdom or GB. Default "United States". |
| `max_price` | number | no |  | Highest price in the store's currency, for example 100.00. |
| `min_price` | number | no |  | Lowest price in the store's currency, for example 25.00. |
| `prime_only` | boolean | no |  | Show only Prime-eligible results, for example true. Default false. |
| `max_results` | integer | no |  | Maximum products to return, for example 20 (up to 60). Default 20. |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "query": "wireless earbuds"
}
```

Its output:

```json
{
  "products": [
    {
      "asin": "B0HDBKFHKK",
      "price": 19.99,
      "prime": true,
      "sponsored": false,
      "list_price": 199.99,
      "photo_link": "https://m.media-amazon.com/images/I/61aSuH86kYL._AC_UY218_.jpg",
      "star_rating": 4.8,
      "product_link": "https://www.amazon.com/dp/B0HDBKFHKK",
      "product_name": "XIAOWTEK Wireless Earbuds, 2026 Bluetooth 5.4 Headphones Bass Stereo Ear Buds with Noise Cancelling Mic, LED Display in Ear Earphones 50H Playtime Ear Buds, IP7 Waterproof for Laptop Pad Phones Black",
      "currency_code": "USD",
      "discount_percent": 90,
      "number_of_ratings": 883
    },
    {
      "asin": "B0HC642F1C",
      "price": 23.98,
      "prime": true,
      "sponsored": false,
      "list_price": 299.99,
      "photo_link": "https://m.media-amazon.com/images/I/71cmAChhQKL._AC_UY218_.jpg",
      "star_rating": 4.6,
      "product_link": "https://www.amazon.com/dp/B0HC642F1C",
      "product_name": "HAOYUYAN Wireless Earbuds, Sports Bluetooth Headphones, 80Hrs Playtime Ear Buds with LED Power Display, Noise Canceling Headset, IPX7 Waterproof Earphones for Workout/Running（Black）",
      "currency_code": "USD",
      "discount_percent": 92,
      "number_of_ratings": 356
    },
    {
      "asin": "B0FQFB8FMG",
      "price": 234,
      "prime": true,
      "sponsored": false,
      "list_price": 249,
      "photo_link": "https://m.media-amazon.com/images/I/61solmQSSlL._AC_UY218_.jpg",
      "star_rating": 4.4,
      "product_link": "https://www.amazon.com/dp/B0FQFB8FMG",
      "product_name": "Apple AirPods Pro 3 Wireless Earbuds with Active Noise Cancellation",
      "currency_code": "USD",
      "discount_percent": 6,
      "number_of_ratings": 15653
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"amazon.com/search_products","input":{"query":"wireless earbuds"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Find Prime-eligible mechanical keyboards on Amazon under $80, cheapest first
- What are the top rated air fryers between £50 and £120 on the UK store? Show me about 15 with ratings and discounts.
- Look up standing desks on amazon.de sorted by newest, page 2, max 30 results
- I need a list of kids' rain boots under 40 CAD from the Canadian store with star ratings and number of reviews
- Show me the most expensive espresso machines available in Japan, with list price, discount and ASIN for each

## 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."
    },
    "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."
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "What to search for, for example wireless earbuds."
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Amazon store country name or two-letter code, for example United Kingdom or GB."
    },
    "max_price": {
      "type": "number",
      "minimum": 0,
      "description": "Highest price in the store's currency, for example 100.00."
    },
    "min_price": {
      "type": "number",
      "minimum": 0,
      "description": "Lowest price in the store's currency, for example 25.00."
    },
    "prime_only": {
      "type": "boolean",
      "default": false,
      "description": "Show only Prime-eligible results, for example true."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 60,
      "minimum": 1,
      "description": "Maximum products to return, for example 20 (up to 60)."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "products"
  ],
  "properties": {
    "products": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "product_name",
          "price",
          "currency_code",
          "list_price",
          "discount_percent",
          "star_rating",
          "number_of_ratings",
          "prime",
          "sponsored",
          "photo_link",
          "product_link",
          "asin"
        ],
        "properties": {
          "asin": {
            "type": "string"
          },
          "price": {
            "type": [
              "number",
              "null"
            ]
          },
          "prime": {
            "type": "boolean"
          },
          "sponsored": {
            "type": "boolean"
          },
          "list_price": {
            "type": [
              "number",
              "null"
            ]
          },
          "photo_link": {
            "type": [
              "string",
              "null"
            ]
          },
          "star_rating": {
            "type": [
              "number",
              "null"
            ]
          },
          "product_link": {
            "type": "string"
          },
          "product_name": {
            "type": "string"
          },
          "currency_code": {
            "type": "string"
          },
          "discount_percent": {
            "type": [
              "number",
              "null"
            ]
          },
          "number_of_ratings": {
            "type": [
              "integer",
              "null"
            ]
          }
        },
        "additionalProperties": false
      }
    }
  },
  "additionalProperties": false
}
```

## See more

- [Amazon API: Get product](https://fous.com/methods/amazon.com/get-product.md): Gets details for an Amazon product, found by name or by link, in a chosen country store. Offer prices, delivery and variants may be missing when Amazon does not show them publicly.
- [Amazon API: List Amazon Best Sellers](https://fous.com/methods/amazon.com/list-best-sellers.md): Lists current Amazon Best Sellers in the closest matching top-level category for a store country (United States, United Kingdom, Germany, India, Canada or Australia), up to 100 ranked products. Prices, ratings and photos may be missing.
- [Amazon API: List Amazon Today's Deals](https://fous.com/methods/amazon.com/list-deals.md): Lists current public Today's Deals in page order for an Amazon store country, optionally for one deal category and a minimum discount, with deal and original prices, discount, deal type, time left, share claimed, rating and links.
- [Walmart API: Search products](https://fous.com/methods/walmart.com/search-products.md): Searches Walmart products by keywords with optional sort and price range, returning prices, ratings, sellers and availability in Walmart's order. Uses Walmart's default location (no ZIP-based pricing).
- [AliExpress API: Search products](https://fous.com/methods/aliexpress.com/search-products.md): Searches AliExpress listings by product words, shipping destination, price range and sort order. Unpriced promotional cards are omitted; free shipping is marked only when the listing explicitly says so.
- [CamelCamelCamel API: Get Amazon price history](https://fous.com/methods/camelcamelcamel.com/get-price-history.md): Gets an Amazon product's current listed price and lifetime price statistics from CamelCamelCamel (Amazon and third-party new), with dated Amazon low/high points and a comparison to the average. Takes a product name, an Amazon or CamelCamelCamel link, or an ASIN, for eight Amazon stores.
- [Best Buy API: Search products](https://fous.com/methods/bestbuy.com/search-products.md): Searches Best Buy US products with an optional price range, sort order and page. Prices and availability come from public listings and may vary by location.
- [Argos API: Search products](https://fous.com/methods/argos.co.uk/search-products.md): Searches Argos UK products by keyword in the selected sort order, returning prices, ratings and links. Delivery and collection availability appear only when shown on the site.
- [All Amazon methods](https://fous.com/methods/amazon.com.md)
