# Xbox API: List game deals > 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. Unofficial. Not affiliated with or endorsed by Xbox. - Page: https://fous.com/methods/xbox.com/list-deals - Method: `xbox.com/list_deals`, version 1 - Website: xbox.com - Returns: title, original price, sale price, currency, discount percent, sale end date, Game Pass inclusion, Xbox link - 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 | `"Germany"` | Country name or two-letter country code, for example United States or US. Default "United States". | | `platform` | string | no | `"console"` | Which games to list, for example console. One of "all", "console", "pc". Default "all". | | `max_results` | integer | no | `55` | Most games to return, for example 50. Default 50. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "country": "Germany", "platform": "console", "max_results": 55 } ``` Its output: ```json { "deals": [ { "title": "Danger Scavenger", "currency": "EUR", "xbox_link": "https://www.xbox.com/de-DE/games/store/danger-scavenger/9mw0s9fbhlcp", "sale_price": 0.99, "sale_end_date": "2026-09-29", "original_price": 9.99, "discount_percent": 90, "store_product_id": "9MW0S9FBHLCP", "included_in_game_pass": false }, { "title": "Sherlock Purr 2", "currency": "EUR", "xbox_link": "https://www.xbox.com/de-DE/games/store/sherlock-purr-2/9mv95w31mqkn", "sale_price": 0.99, "sale_end_date": "2026-09-29", "original_price": 9.99, "discount_percent": 90, "store_product_id": "9MV95W31MQKN", "included_in_game_pass": false }, { "title": "Four Sided Fantasy", "currency": "EUR", "xbox_link": "https://www.xbox.com/de-DE/games/store/four-sided-fantasy/brnjb8kflqwl", "sale_price": 0.99, "sale_end_date": "2026-10-01", "original_price": 9.99, "discount_percent": 90, "store_product_id": "BRNJB8KFLQWL", "included_in_game_pass": false } ] } ``` ## 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":"xbox.com/list_deals","input":{"country":"Germany","platform":"console","max_results":55}}' ``` 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 - What are the biggest Xbox game discounts in the UK right now? Show me the top 20 with sale end dates. - Find PC games on sale on xbox.com in Germany, sorted by highest discount percentage, including whether they're on Game Pass. - Which console games for Series X and Xbox One are currently discounted in Canada? I'd like original and sale prices for up to 100 titles. - Pull the current Xbox store sales for Australia (AU) — top 10 deepest discounts and when each sale ends. - List up to 200 Xbox games on sale in the US across console and PC, biggest markdowns first, with links to each game's page. ## Input schema ```json { "type": "object", "required": [], "properties": { "country": { "type": "string", "default": "United States", "description": "Country name or two-letter country code, for example United States or US." }, "platform": { "enum": [ "all", "console", "pc" ], "type": "string", "default": "all", "description": "Which games to list, for example console." }, "max_results": { "type": "integer", "default": 50, "maximum": 200, "minimum": 1, "description": "Most games to return, for example 50." } } } ``` ## Output schema ```json { "type": "object", "required": [ "deals" ], "properties": { "deals": { "type": "array", "items": { "type": "object", "required": [ "title", "original_price", "sale_price", "currency", "discount_percent", "sale_end_date", "included_in_game_pass", "xbox_link", "store_product_id" ], "properties": { "title": { "type": "string" }, "currency": { "type": "string" }, "xbox_link": { "type": "string" }, "sale_price": { "type": "number" }, "sale_end_date": { "type": [ "string", "null" ], "format": "date" }, "original_price": { "type": "number" }, "discount_percent": { "type": "integer" }, "store_product_id": { "type": "string" }, "included_in_game_pass": { "type": "boolean" } }, "additionalProperties": false }, "description": "Games currently on sale, biggest discount first." } }, "additionalProperties": false } ``` ## See more - [Xbox API: Get game](https://fous.com/methods/xbox.com/get-game.md): Finds an Xbox or PC game by name or by xbox.com store link. Returns its store details, prices and Game Pass availability for a country. - [Xbox API: List Xbox Game Pass games](https://fous.com/methods/xbox.com/list-game-pass-games.md): Lists Xbox Game Pass games for console or PC (all, recently added, leaving soon or coming soon) in Xbox's catalog order, with genres, publisher, cover image and store link. Game Pass addition, arrival and departure dates are not published in these lists, so they are null. - [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. - [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. - [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. - [Steam API: List top sellers](https://fous.com/methods/store.steampowered.com/list-top-sellers.md): Lists Steam's top-selling, discounted, or new and trending games in store order, with prices for a chosen country, review summaries and release dates. - [Epic Games API: List free games](https://fous.com/methods/store.epicgames.com/list-free-games.md): Lists current and upcoming free games on the Epic Games Store for a country, with giveaway dates, usual price, publisher, cover image and store link. - [Microsoft API: Search Microsoft Store apps](https://fous.com/methods/apps.microsoft.com/search-apps.md): Searches Microsoft Store apps and games by keywords in a chosen country and returns them in Store order. Subscription-included items can show a price of 0. - [All Xbox methods](https://fous.com/methods/xbox.com.md)