# Nintendo API: Get a Nintendo Switch game's store details

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

Unofficial. Not affiliated with or endorsed by Nintendo.

- Page: https://fous.com/methods/nintendo.com/get-game
- Method: `nintendo.com/get_game`, version 1
- Website: nintendo.com
- Returns: name, platform, regular and sale price, currency, discount, sale end, release date, publisher, age rating, players, download size, genres, demo, cover image, link, product code
- 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 |
|---|---|---|---|---|
| `game` | string | yes | `"Mario Kart World"` | Game name or Nintendo game link, for example Mario Kart World or https://www.nintendo.com/us/store/products/mario-kart-world-switch-2/. |
| `country` | string | no | `"Canada"` | Nintendo store country name or two-letter code, for example Canada or CA. Default "United States". |

## Output

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

```json
{
  "game": "Mario Kart World",
  "country": "Canada"
}
```

Its output:

```json
{
  "name": "Mario Kart™ World",
  "genres": [
    "Party",
    "Racing"
  ],
  "platform": "Nintendo Switch 2",
  "publisher": "Nintendo",
  "age_rating": "ESRB E",
  "sale_price": null,
  "release_date": "2025-06-05",
  "currency_code": "CAD",
  "nintendo_link": "https://www.nintendo.com/en-ca/store/products/mario-kart-world-switch-2/",
  "regular_price": 109.99,
  "sale_end_date": null,
  "demo_available": false,
  "cover_image_link": "https://assets.nintendo.com/image/upload/q_auto/f_auto/store/software/switch2/70010000095431/0485f410193ca12f92a2f615ea608bb437540f321bd05e464593c33fefa09bf2",
  "discount_percent": null,
  "download_size_gb": 22.2,
  "number_of_players": "Single system (1-4), Local wireless (2-8), Online (2-24)",
  "nintendo_product_code": "BEEPAAAAA"
}
```

## 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/get_game","input":{"game":"Mario Kart World","country":"Canada"}}'
```

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

- How much is The Legend of Zelda: Tears of the Kingdom on the Nintendo eShop in Canada right now, and is it on sale?
- Check the Nintendo store page for Hollow Knight in the UK — I need the price in pounds, download size, and age rating.
- What's the release date, publisher, and number of players for Donkey Kong Bananza on Switch 2 in the US?
- Is there a demo for Pikmin 4, and what does it cost in Mexican pesos? Also when does any current discount end?
- Pull the details from https://www.nintendo.com/us/store/products/super-mario-bros-wonder-switch/ but for Brazil: price in reais, genres, file size, and product code.

## Input schema

```json
{
  "type": "object",
  "required": [
    "game"
  ],
  "properties": {
    "game": {
      "type": "string",
      "description": "Game name or Nintendo game link, for example Mario Kart World or https://www.nintendo.com/us/store/products/mario-kart-world-switch-2/."
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Nintendo store country name or two-letter code, for example Canada or CA."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "name",
    "platform",
    "regular_price",
    "sale_price",
    "currency_code",
    "discount_percent",
    "sale_end_date",
    "release_date",
    "publisher",
    "age_rating",
    "number_of_players",
    "download_size_gb",
    "genres",
    "demo_available",
    "cover_image_link",
    "nintendo_link",
    "nintendo_product_code"
  ],
  "properties": {
    "name": {
      "type": [
        "string",
        "null"
      ]
    },
    "genres": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "platform": {
      "type": [
        "string",
        "null"
      ]
    },
    "publisher": {
      "type": [
        "string",
        "null"
      ]
    },
    "age_rating": {
      "type": [
        "string",
        "null"
      ]
    },
    "sale_price": {
      "type": [
        "number",
        "null"
      ]
    },
    "release_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "currency_code": {
      "type": [
        "string",
        "null"
      ]
    },
    "nintendo_link": {
      "type": [
        "string",
        "null"
      ]
    },
    "regular_price": {
      "type": [
        "number",
        "null"
      ]
    },
    "sale_end_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "demo_available": {
      "type": "boolean"
    },
    "cover_image_link": {
      "type": [
        "string",
        "null"
      ]
    },
    "discount_percent": {
      "type": [
        "number",
        "null"
      ]
    },
    "download_size_gb": {
      "type": [
        "number",
        "null"
      ]
    },
    "number_of_players": {
      "type": [
        "string",
        "null"
      ]
    },
    "nintendo_product_code": {
      "type": [
        "string",
        "null"
      ]
    }
  }
}
```

## See more

- [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.
- [PlayStation API: Get PlayStation Store game](https://fous.com/methods/store.playstation.com/get-game.md): Looks up a PlayStation Store game by name or product link in a country. Prefers the standard full game; prices and offers vary by country. Game trials are not counted as PlayStation Plus inclusion.
- [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.
- [Steam API: Get game details](https://fous.com/methods/store.steampowered.com/get-game.md): Finds a PC game on Steam by name, store link or app ID and returns its store details, country price, reviews, tags and live player count.
- [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.
- [Nike API: Get product](https://fous.com/methods/nike.com/get-product.md): Gets a Nike product's details by name or product link for a chosen country. Returns its colourways, size availability, price and reviews.
- [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.
- [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)
