# Nintendo API: List eShop deals

> 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.

Unofficial. Not affiliated with or endorsed by Nintendo.

- Page: https://fous.com/methods/nintendo.com/list-deals
- Method: `nintendo.com/list_deals`, version 1
- Website: nintendo.com
- Returns: title, platform, original and sale price, currency, discount percent, sale end date, 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 |
|---|---|---|---|---|
| `sort` | string | no |  | Deal order, for example lowest_price. Defaults to biggest_discount. One of "biggest_discount", "lowest_price", "ending_soon". Default "biggest_discount". |
| `country` | string | no |  | Store country name or two-letter code, for example Canada. Defaults to United States. Default "United States". |
| `platform` | string | no |  | Console to show, for example switch_2. Defaults to all. One of "all", "switch", "switch_2". Default "all". |
| `max_results` | integer | no |  | Maximum games to return, for example 50. Defaults to 50. Default 50. |

## Output

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

```json
{}
```

Its output:

```json
{
  "deals": [
    {
      "title": "Hentai Photo Collection 8 in 1",
      "currency": "USD",
      "platform": "Nintendo Switch",
      "sale_price": 3.99,
      "nintendo_link": "https://www.nintendo.com/us/store/products/hentai-photo-collection-8-in-1-switch/",
      "sale_end_date": "2026-11-11",
      "original_price": 199.99,
      "discount_percent": 98
    },
    {
      "title": "AAA Games Ultimate Collection",
      "currency": "USD",
      "platform": "Nintendo Switch",
      "sale_price": 1.99,
      "nintendo_link": "https://www.nintendo.com/us/store/products/aaa-games-ultimate-collection-switch/",
      "sale_end_date": "2026-10-31",
      "original_price": 79.99,
      "discount_percent": 98
    },
    {
      "title": "31 Full Games for Everyone",
      "currency": "USD",
      "platform": "Nintendo Switch",
      "sale_price": 2.99,
      "nintendo_link": "https://www.nintendo.com/us/store/products/31-full-games-for-everyone-switch/",
      "sale_end_date": "2026-11-22",
      "original_price": 99.99,
      "discount_percent": 97
    }
  ]
}
```

## 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":"nintendo.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 Switch 2 games on sale in Canada sorted by lowest price
- Which Nintendo Switch titles have the biggest discounts in the US store right now?
- List the deals ending soonest on Switch in Brazil, 25 results max
- Find discounted Switch 2 games in Mexico with the highest percent off
- What Switch games are on sale in the Canadian eShop, cheapest first, up to 100 results?

## Input schema

```json
{
  "type": "object",
  "properties": {
    "sort": {
      "enum": [
        "biggest_discount",
        "lowest_price",
        "ending_soon"
      ],
      "type": "string",
      "default": "biggest_discount",
      "description": "Deal order, for example lowest_price. Defaults to biggest_discount."
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Store country name or two-letter code, for example Canada. Defaults to United States."
    },
    "platform": {
      "enum": [
        "all",
        "switch",
        "switch_2"
      ],
      "type": "string",
      "default": "all",
      "description": "Console to show, for example switch_2. Defaults to all."
    },
    "max_results": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "description": "Maximum games to return, for example 50. Defaults to 50."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "deals"
  ],
  "properties": {
    "deals": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "platform": {
            "type": "string"
          },
          "sale_price": {
            "type": "number"
          },
          "nintendo_link": {
            "type": "string"
          },
          "sale_end_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "original_price": {
            "type": "number"
          },
          "discount_percent": {
            "type": "number"
          }
        }
      }
    }
  }
}
```

## See more

- [Nintendo API: Get a Nintendo Switch game's store details](https://fous.com/methods/nintendo.com/get-game.md): Looks up a Nintendo Switch or Switch 2 game by name or Nintendo link and returns its eShop price, sale, release date, publisher, rating, players, size and genres for the chosen country (US, Canada, UK, Mexico, Brazil, Argentina, Chile, Colombia or Peru).
- [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.
- [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.
- [IsThereAnyDeal API: Get best price](https://fous.com/methods/isthereanydeal.com/get-best-price.md): Finds current official-store prices, the all-time low and live bundles for a PC game in the selected country.
- [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.
- [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.
- [Slickdeals API: Search deals](https://fous.com/methods/slickdeals.net/search-deals.md): Searches community-posted Slickdeals deals by product or keyword, optionally limited to a store and hiding expired deals, ordered by relevance, newest or most popular.
- [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.
- [All Nintendo methods](https://fous.com/methods/nintendo.com.md)