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.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Game, required
game Game name or Nintendo game link, for example Mario Kart World or https://www.nintendo.com/us/store/products/mario-kart-world-switch-2/.
Mario Kart World
- Country optional
country Nintendo store country name or two-letter code, for example Canada or CA.
Canada
Default
United States.
Input as JSON
{ "game": "Mario Kart World", "country": "Canada"}Output
{ "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"}Code
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"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "nintendo.com/get_game" , "input": { "game": "Mario Kart World", "country": "Canada" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "nintendo.com/get_game" , "input": { "game": "Mario Kart World", "country": "Canada" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run nintendo.com/get_game# with {"game":"Mario Kart World","country":"Canada"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "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
{ "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" ] } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
nintendo.com/get_game- 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
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method nintendo.com/get_game with the inputs above.
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.
See more
All Nintendo methodsLists 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.
nintendo.com/list_dealsLooks 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.
store.playstation.com/get_gameFinds 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.com/get_gameFinds 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.
store.steampowered.com/get_gameFinds current official-store prices, the all-time low and live bundles for a PC game in the selected country.
isthereanydeal.com/get_best_priceGets a Nike product's details by name or product link for a chosen country. Returns its colourways, size availability, price and reviews.
nike.com/get_productLists 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.
store.playstation.com/list_dealsLists current and upcoming free games on the Epic Games Store for a country, with giveaway dates, usual price, publisher, cover image and store link.
store.epicgames.com/list_free_games