# Amazon API: List Amazon Today's Deals > 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. Unofficial. Not affiliated with or endorsed by Amazon. - Page: https://fous.com/methods/amazon.com/list-deals - Method: `amazon.com/list_deals`, version 1 - Website: amazon.com - Returns: deals (product name, deal price, original price, currency, discount percent, deal type, time left, percent claimed, star rating, number of ratings, photo, product 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 | |---|---|---|---|---| | `country` | string | no | | Amazon store country name or two-letter code, such as United Kingdom or GB. Default "United States". | | `category` | string | no | | Deal category in plain words, such as home. Defaults to all categories. Default "all". | | `max_results` | integer | no | | Maximum number of deals to return, such as 30. Default 30. | | `min_discount_percent` | number | no | | Minimum percentage off, such as 25. Default 0. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json {} ``` Its 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 } ] } ``` ## 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/list_deals","input":{}}' ``` 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 - Show me the current Amazon Today's Deals in the UK store for kitchen stuff that are at least 40% off - What lightning deals are live right now in electronics with 30% or more off? I want to see how much time is left and how many have been claimed. - Pull the top 50 daily deals from Amazon Germany across all categories, with deal price, original price and ratings - Any toy deals today with at least half off? Give me links and star ratings, about 20 results. - List today's discounted beauty products on the Canadian store, minimum 25% off, include the ASINs and how much each deal has sold through ## 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." }, "category": { "type": "string", "default": "all", "description": "Deal category in plain words, such as home. Defaults to all categories." }, "max_results": { "type": "integer", "default": 30, "maximum": 100, "minimum": 1, "description": "Maximum number of deals to return, such as 30." }, "min_discount_percent": { "type": "number", "default": 0, "maximum": 100, "minimum": 0, "description": "Minimum percentage off, such as 25." } } } ``` ## Output schema ```json { "type": "object", "required": [ "deals" ], "properties": { "deals": { "type": "array", "items": { "type": "object", "required": [ "product_name", "deal_price", "original_price", "currency_code", "discount_percent", "deal_type", "time_left", "percent_claimed", "star_rating", "number_of_ratings", "photo_link", "product_link", "asin" ], "properties": { "asin": { "type": "string", "x-fous-developer": true }, "deal_type": { "type": [ "string", "null" ] }, "time_left": { "type": [ "string", "null" ] }, "deal_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" }, "original_price": { "type": [ "number", "null" ] }, "percent_claimed": { "type": [ "number", "null" ] }, "discount_percent": { "type": [ "number", "null" ] }, "number_of_ratings": { "type": [ "integer", "null" ] } }, "additionalProperties": false } } }, "additionalProperties": false } ``` ## See more - [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: Search products](https://fous.com/methods/amazon.com/search-products.md): 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. - [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. - [CamelCamelCamel API: List Amazon price drops](https://fous.com/methods/camelcamelcamel.com/list-price-drops.md): Lists the biggest percentage Amazon price drops of the past week on CamelCamelCamel for one Amazon store, optionally in one product category, with old and new prices, photo, category and links. - [Slickdeals API: List popular deals](https://fous.com/methods/slickdeals.net/list-popular-deals.md): Lists current Slickdeals Frontpage deals in site order, followed by popular deals when needed, with each deal's category, or browses one category's current deals. Expired deals are left out. - [PlayStation API: List PlayStation Store deals](https://fous.com/methods/store.playstation.com/list-deals.md): Lists PlayStation Store games and game editions currently on sale in a country, with prices and sale end dates. Add-ons and subscription-only offers are excluded. - [Xbox API: List game deals](https://fous.com/methods/xbox.com/list-deals.md): Lists Xbox games currently on sale in a country, biggest discount first, with original and sale prices, sale end dates and Game Pass inclusion; console covers Xbox One and Xbox Series X|S. Reads the store's whole deals list and ranks it by discount. - [Nintendo API: List eShop deals](https://fous.com/methods/nintendo.com/list-deals.md): Lists discounted Nintendo Switch and Switch 2 games, sorted by biggest discount, lowest price or ending soonest. Covers the US, Canada and Latin American stores and excludes downloadable add-ons. - [All Amazon methods](https://fous.com/methods/amazon.com.md)