Nintendo eShop API - Game Prices by Country, Sales, DLC, Releases
Nintendo eShop API for Nintendo eShop regional prices - one game's regular price, sale price and sale start and end dates in each eShop country, in that country's currency (up to 50 item ids per call); catalog search, product detail, games on sale now, new and upcoming releases and a game's DLC for Nintendo Switch and Nintendo Switch 2. 46 countries across the Americas, Europe, Oceania, South Africa and Japan, plus prices in Korea, Hong Kong, Taiwan and Israel. 6 endpoints, 1 credit each. No user reviews, no price history (poll the prices endpoint).
Nintendo via Scavio
Read Nintendo eShop data for Nintendo Switch and Nintendo Switch 2: the price of up to 50 games in any eShop country, catalog search, one product in full, the games on sale now, new and upcoming releases, and a game's DLC, bundles and upgrade packs. All 6 endpoints return structured JSON and cost 1 credit per call.
The job this skill is for: Nintendo eShop regional prices. One game's regular price, sale price and sale end date in each eShop country, in that country's currency. /prices takes 1 to 50 item ids (nsuid) and one country, and answers price, regular_price, sale_price, discount_percent, sale_start, sale_end, currency and sales_status per id. One call per country.
Item ids are per eShop region, not per game. The same game has a different nsuid in each region, and an id from one region is not_found in another:
Region (region in every answer) | Countries | How to get the id |
|---|---|---|
americas | us ca mx br ar cl co pe | /product with the slug from an Americas /search (search tiles carry slug, not nsuid) |
europe | the European countries below, plus au nz za, and il (prices only) | items[].nsuid from /search on gb (or any European market) |
japan | jp | items[].nsuid from /search on jp with a Japanese query |
| Korea | kr (prices only) | No searchable catalog: use an id the user already has |
| Hong Kong and Taiwan | hk, tw (prices only) | No searchable catalog; Taiwan uses the Hong Kong ids |
So "this game in every country" is: look the game up once per region, then call /prices for every country of that region with that region's id. There is no cross-region title mapping: match titles yourself and say so.
Captured on 2026-11-15, regular prices (none on sale at capture time):
| Game | country | nsuid | price | currency |
|---|---|---|---|---|
| Mario Kart World | us | 70010000095431 | 79.99 | USD |
| Mario Kart World | pl | 70010000096802 | 329.8 | PLN |
| Mario Kart World | se | 70010000096802 | 879 | SEK |
| The Legend of Zelda: Tears of the Kingdom | us | 70010000063714 | 69.99 | USD |
| The Legend of Zelda: Tears of the Kingdom | kr | 70010000063716 | 74800 | KRW |
| Pokemon Legends: Z-A | us | 70010000094234 | 59.99 | USD |
| Pokemon Legends: Z-A | hk | 70010000094237 | 359 | HKD |
Prices are never converted. To compare countries, convert explicitly and state the rate and its date.
Sales and price history. sale_start and sale_end are the eShop's own sale window, from Nintendo. Nintendo shows no price history and no historical low, so neither is returned: to build one, call /prices on a schedule and store each reading with its time, country and currency. Nintendo announced a US eShop sale on select digital games from November 19 through December 2, 2026 (Black Friday is November 27, 2026).
Nintendo has no public eShop catalog or price API. The Nintendo Developer Portal is for making and publishing games on Nintendo platforms; it does not offer store prices or catalog data to third parties.
See also: for physical copies and consoles at US retailers use amazon-product-data, walmart-product-data, target-product-data or best-buy-product-data; for the cross-merchant view of one product use google-shopping-api; for mobile apps use apple-app-store-api and google-play-store-api.
When to trigger
Use this skill when the user asks to:
- Compare a Nintendo Switch or Switch 2 game's eShop price across countries, each in its own currency
- Check whether a game is on sale on the eShop, its sale price, discount and when the sale ends
- Track eShop prices or sales over time (Black Friday, a publisher sale) by polling and storing prices
- Search the Nintendo eShop catalog by keyword in a country, sorted or filtered by platform, sale, genre, players, publisher, demo or price
- Read one eShop game in full: publisher, developer, release date, genres, players, languages, file size, age rating, editions, demo, Nintendo Switch Online needs
- List the games on sale now in a country, or one Nintendo sale page in the Americas
- List new or upcoming Nintendo Switch and Switch 2 releases in a country
- List a game's DLC, bundles and upgrade packs with their prices
Setup
Get a free API key at scavio.dev (50 free credits to get started, no card required):
export SCAVIO_API_KEY=sk_live_your_key
If you do not have a key yet
An agent running this skill without SCAVIO_API_KEY set will get 401 on every
call below. The whole path from nothing to a working key is self-serve:
- Sign up at dashboard.scavio.dev - email or Google, no card required.
- A key is created for the account automatically at signup. It is on the dashboard under API Keys, ready to copy.
- A new account starts with 50 credits: 50 calls, since every endpoint here costs 1 credit.
When the balance runs out the API answers 402 with a JSON body carrying
billing_url. Topping up needs no code change - the same key keeps working.
Paid plans start with Hobby at $15 per month for 3,000 credits; on Growth,
1,000 credits cost $1.
Every request is a POST with a JSON body and:
Authorization: Bearer $SCAVIO_API_KEY
Endpoints
Base URL: https://api.scavio.dev. In the captures /prices took 0.5 to 8 seconds, European and Japanese calls 1 to 13 seconds, and Americas search and releases 7 to 19 seconds. Set a client timeout of at least 180 seconds and do not fire many calls at once (a busy moment answers 503 with Retry-After).
| Endpoint | Markets | Credits | What it returns |
|---|---|---|---|
POST /api/v1/nintendo/search | catalog markets (42) | 1 | Catalog items for a keyword with prices; Europe and Japan with total, sorts and filters |
POST /api/v1/nintendo/product | catalog markets (42) | 1 | One game or store item by nsuid, url or (Americas) slug |
POST /api/v1/nintendo/prices | all 46 | 1 | The price of 1 to 50 item ids in one country, with the sale window |
POST /api/v1/nintendo/deals | catalog markets (42) | 1 | Games on sale now (Americas: Nintendo's featured sale pages) |
POST /api/v1/nintendo/releases | catalog markets (42) | 1 | New releases or upcoming games |
POST /api/v1/nintendo/dlc | catalog markets (42) | 1 | A game's DLC, bundles and upgrade packs with prices |
Markets
Every endpoint takes country (lowercase, default us) and language (default the market's first). Titles and descriptions come back in that language and prices in the country's currency, never converted; every data echoes country, language, currency and region.
country | Languages | Currency | Catalog |
|---|---|---|---|
us | en | USD | Americas |
ca | en, fr | CAD | Americas |
mx | es | MXN | Americas |
br | pt | BRL | Americas |
ar, cl, co, pe | es | ARS, CLP, COP, PEN | Americas |
gb | en | GBP | Europe, own catalog |
ie | en | EUR | Europe, own catalog |
de, at | de | EUR | Europe, own catalog |
ch | de, fr, it | CHF | Europe, own catalog |
fr, lu | fr | EUR | Europe, own catalog |
be | fr, nl | EUR | Europe, own catalog |
nl | nl | EUR | Europe, own catalog |
it | it | EUR | Europe, own catalog |
es | es | EUR | Europe, own catalog |
pt | pt | EUR | Europe, own catalog |
au, nz, za | en | AUD, NZD, ZAR | Europe, own catalog |
pl, cz, se, no, dk | en | PLN, CZK, SEK, NOK, DKK | Europe, English catalog with that country's prices |
fi, sk, hu, ro, bg, gr, hr, si, ee, lv, lt, mt, cy | en | EUR | Europe, English catalog with that country's prices |
jp | ja | JPY | Japan |
kr | ko | KRW | Prices only |
hk, tw | zh | HKD, TWD | Prices only |
il | en | EUR | Prices only (European item ids) |
- Search, product, deals, releases and DLC: the 42 catalog markets. Prices: all 46 (the 42 plus
kr,hk,tw,il). A prices-only market on another endpoint answers400. - The 18 European countries without a Nintendo site of their own (
plthroughcyabove) read the English European catalog with that country's own eShop prices;notessays so. ph(Nintendo has not published Philippines item ids yet),ru(no eShop),uk(usegb) and countries with no eShop data answer400before anything is charged.
Workflow
- One game, every country: for each region, find the game's id. Americas:
/searchonus, then/productwithitems[].slugforproduct.nsuid. Europe:/searchongband readitems[].nsuid. Japan:/searchonjpwith the Japanese title. Then/priceswith that id (up to 50 ids per call) for each country of the region. Keep the ids: they do not change, so later runs need only/prices. - Is it on sale, and until when:
/pricesor/product; on sale whensale_priceis set, withdiscount_percent,sale_startandsale_end(UTC). - Price tracking: poll
/priceson a schedule. Storensuid,country,currency, the time,price,regular_price,sale_price,sale_endper run. There is no price history endpoint. - Browse the catalog:
/searchwithquery. Europe:sort,platform,on_sale,genre,players,publisher,has_demo,type, andprice_min/price_maxongb,de,at,fr,be,lu,nl,it,esandpt. Japan:sort,platform,on_sale,publisher,type. Americas:query,pageandsort(relevanceornewest) only. - On sale now:
/deals. Europe and Japan list every discounted game in the catalog; the Americas list Nintendo's featured sale pages (sales[]; pass onesales[].saleassale), not every discounted game: check other ids with/prices. - Release calendar:
/releaseswithtypenew(released, newest first) orupcoming(soonest first), optionallyplatform. - DLC:
/dlcwith the game'snsuid,urlor (Americas)slug.
Parameters
Shared
| Parameter | Type | Default | Description |
|---|---|---|---|
country | string | us | See Markets |
language | string | the market's first | One of the market's languages |
page | integer | 1 | 1-based (Americas search up to 50) |
page_size | integer | 24 | 1 to 50. Fixed at 40 on Americas search; not sent on Americas releases |
platform | string | both | switch or switch_2 (search: Europe and jp; deals and releases: all) |
Search (/search)
| Parameter | Type | Default | Description |
|---|---|---|---|
query | string | required | Keywords, 1-200 chars (Japanese titles on jp) |
sort | string | relevance | Americas: relevance, newest. Europe: relevance, newest, price_asc, price_desc, title, discount. jp: relevance, newest, price_asc, price_desc |
on_sale | boolean | false | Only discounted games (Europe, jp) |
price_min / price_max | number | none | Price range, where the catalog is priced in the country's currency: gb, de, at, fr, be, lu, nl, it, es, pt (elsewhere 400) |
genre | string | none | A genre as the catalog names it, in the request language (Europe) |
players | integer | none | At least this many players (Europe) |
publisher | string | none | Exact publisher name (Europe; jp in Japanese, 任天堂) |
has_demo | boolean | false | Only games with a free demo (Europe) |
type | string | game | game, dlc, all (Europe); game, dlc, bundle, all (jp) |
A sort or filter the catalog does not support answers 400; it is never silently dropped.
Product (/product) and DLC (/dlc)
| Parameter | Type | Default | Description |
|---|---|---|---|
nsuid | string | one of | 14 digits starting 70 (70010000095431). Must be an id of the country's region |
url | string | one of | An Americas store page (/us/store/products/<slug>/), a European game page (ending -<id>.html) or a nintendo.com/au game page. Without country the link's market is used; with country, both must be in the same region |
slug | string | one of | Americas only: items[].slug from an Americas search (mario-kart-world-switch-2) |
Send exactly one. On jp send nsuid.
Prices (/prices)
| Parameter | Type | Default | Description |
|---|---|---|---|
ids | array or string | required | 1 to 50 item ids, as an array or comma-separated. More than 50 answers 400 |
Deals (/deals)
| Parameter | Type | Default | Description |
|---|---|---|---|
sort | string | per catalog | Americas: featured (Nintendo's order), discount, price_asc, newest, ending_soon. Europe: discount (default), price_asc, newest. jp: newest (default), price_asc |
sale | string | none | Americas only: one sale page, by sales[].sale (square-enix) |
Releases (/releases)
| Parameter | Type | Default | Description |
|---|---|---|---|
type | string | new | new (released, newest first) or upcoming (future dates, soonest first) |
On the Americas markets releases is Nintendo's whole new-releases or coming-soon list in one answer: no page above 1 and no page_size.
Examples
Prices (one country, up to 50 ids)
curl -X POST https://api.scavio.dev/api/v1/nintendo/prices \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ids": "70010000096802,70010000063715,70010000094235", "country": "pl"}'
Captured data (Poland, 2026-11-15; 1 of 3 prices shown):
{
"prices": [
{
"nsuid": "70010000096802",
"sales_status": "onsale",
"price": 329.8,
"regular_price": 329.8,
"sale_price": null,
"discount_percent": null,
"sale_start": null,
"sale_end": null,
"currency": "PLN",
"is_free": false
}
],
"not_found": [],
"count": 3,
"country": "pl",
"language": "en",
"currency": "PLN",
"region": "europe",
"notes": [
"Item ids (nsuid) are per eShop region: americas (US CA MX BR AR CL CO PE), europe (EU / EFTA, GB, AU, NZ, ZA, IL), japan, kr, and hk-tw; an id from one region is not_found in another.",
"sale_start / sale_end are the eShop's own sale window; Nintendo publishes no price history (poll this endpoint)."
]
}
An id that eShop does not sell is listed in not_found and left out of prices. A free game is price: 0 with is_free: true (captured on hk).
Search (Americas)
curl -X POST https://api.scavio.dev/api/v1/nintendo/search \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "mario"}'
Captured data (US, 2026-11-15; 1 of 40 items shown):
{
"query": "mario",
"sort": "relevance",
"sorts_offered": ["relevance", "newest"],
"country": "us",
"language": "en",
"currency": "USD",
"region": "americas",
"items": [
{
"nsuid": null,
"slug": "mario-kart-world-switch-2",
"url": "https://www.nintendo.com/us/store/products/mario-kart-world-switch-2/",
"title": "Mario Kart™ World",
"platform": "switch_2",
"release_date": "2025-06-05",
"release_date_text": "6/5/25",
"upcoming": false,
"publisher": null,
"price": 79.99,
"regular_price": 79.99,
"sale_price": null,
"discount_percent": null,
"sale_start": null,
"sale_end": null,
"currency": "USD",
"is_free": false,
"badges": [],
"image": "https://assets.nintendo.com/image/fetch/c_scale,w_260/dpr_2.0/q_auto/f_auto/https://atum-img-lp1.cdn.nintendo.net/i/c/e1def375c7254d669bcd65ff10170151_1024",
"type": "game",
"category": "Games",
"age_rating": null
}
],
"count": 40,
"total": null,
"page": 1,
"page_size": 40,
"total_pages": null,
"has_more": true,
"requested_filters": {},
"notes": [
"Americas search lists games, hardware and merchandise together (type per item); tiles carry a slug, not an item id: read product with the slug for the nsuid, then prices / dlc.",
"Americas search has no exact total: has_more says whether another page follows."
]
}
Search (Europe)
curl -X POST https://api.scavio.dev/api/v1/nintendo/search \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "mario", "country": "gb"}'
Captured data (UK, 2026-11-15; 1 of 24 items shown):
{
"query": "mario",
"sort": "relevance",
"sorts_offered": ["relevance", "newest", "price_asc", "price_desc", "title", "discount"],
"country": "gb",
"language": "en",
"currency": "GBP",
"region": "europe",
"items": [
{
"nsuid": "70070000030726",
"page_id": "2915270",
"title": "Super Mario Galaxy + Super Mario Galaxy 2",
"url": "https://www.nintendo.com/en-gb/Games/Nintendo-Switch-games/Super-Mario-Galaxy-Super-Mario-Galaxy-2-2915270.html",
"platform": "switch",
"release_date": "2025-10-02",
"publisher": "Nintendo",
"price": 58.99,
"regular_price": 58.99,
"sale_price": null,
"discount_percent": null,
"sale_start": null,
"sale_end": null,
"currency": "GBP",
"is_free": false,
"sales_status": "onsale",
"image": "https://www.nintendo.com/eu/media/images/assets/nintendo_switch_games/supermariogalaxyandsupermariogalaxy2/1x1_NSwitch_SuperMarioGalaxy1And2_image500w.jpg",
"type": "game",
"age_rating": {"system": "PEGI", "rating": "7", "label": "PEGI 7"}
}
],
"count": 24,
"total": 303,
"page": 1,
"page_size": 24,
"total_pages": 13,
"requested_filters": {"type": "game"},
"notes": [
"Prices are the GB eShop's (GBP), not the catalog's own.",
"2 items are not sold on the GB eShop: kept, with sales_status not_found and price null."
]
}
On jp the same shape comes back in Japanese ("query": "マリオ", "publisher": "任天堂", "age_rating": {"system": "CERO", "rating": "A", "code": "1"}, release_date_text as 2023.10.20).
Product
curl -X POST https://api.scavio.dev/api/v1/nintendo/product \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"nsuid": "70010000095431"}'
Captured data (US, 2026-11-15; lists trimmed, description cut):
{
"product": {
"nsuid": "70010000095431",
"sku": "7100095431",
"application_id": "0400c3f00006e000",
"title": "Mario Kart™ World",
"url": "https://www.nintendo.com/us/store/products/mario-kart-world-switch-2/",
"slug": "mario-kart-world-switch-2",
"platform": "switch_2",
"platform_label": "Nintendo Switch 2",
"platforms": ["switch_2"],
"category": "games",
"type": "game",
"release_date": "2025-06-05",
"release_date_text": null,
"publisher": "Nintendo",
"developer": "Nintendo",
"genres": ["Party"],
"players": {
"system": {"min": 1, "max": 4, "label": "4+"},
"local": {"min": 2, "max": 8, "label": "4+"},
"online": {"min": 2, "max": 24, "label": "4+"}
},
"languages": ["Japanese"],
"file_size_bytes": 23845666816,
"age_rating": {"system": "ESRB", "rating": "Everyone", "code": "e", "descriptors": ["Mild Fantasy Violence"]},
"price": 79.99,
"regular_price": 79.99,
"sale_price": null,
"discount_percent": null,
"currency": "USD",
"is_free": false,
"sale_start": null,
"sale_end": null,
"sales_status": "onsale",
"purchasable": true,
"preorder": false,
"has_demo": false,
"demo_nsuid": null,
"edition": "Standard Edition",
"is_upgrade": false,
"nintendo_switch_online": {"required": false, "features": ["Online Play"]},
"play_modes": ["TV mode"],
"availability": ["Available now"],
"dlc": []
},
"country": "us",
"language": "en",
"currency": "USD",
"region": "americas"
}
A European product ("country": "gb", nsuid 70070000030726) adds nsuids, page_id, players {min, max, system, local, online}, age_rating {system: PEGI, rating, label}, physical_version, digital_version, game_series, base_game, nintendo_switch_online {required, online_play, cloud_saves, game_voucher} and copyright. A Japanese product adds title_reading, format and dlc_nsuids.
Deals
curl -X POST https://api.scavio.dev/api/v1/nintendo/deals \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
Captured data (US, 2026-11-15; 1 of 24 items shown, 2 of 5 sale pages):
{
"sort": "featured",
"sorts_offered": ["featured", "discount", "price_asc", "newest", "ending_soon"],
"country": "us",
"language": "en",
"currency": "USD",
"region": "americas",
"items": [
{
"nsuid": "70070000033531",
"slug": "q-collection-switch",
"url": "https://www.nintendo.com/us/store/products/q-collection-switch/",
"title": "Q Collection",
"platform": "switch",
"release_date": "2026-05-21",
"publisher": "Aksys Games",
"price": 20.99,
"regular_price": 29.99,
"sale_price": 20.99,
"discount_percent": 30,
"currency": "USD",
"is_free": false,
"sale_start": "2026-11-11T17:00:00Z",
"sale_end": "2026-11-19T07:59:59Z",
"sales_status": "onsale",
"amount_off": 9,
"type": "game",
"age_rating": {"system": "ESRB", "rating": "Everyone 10+"},
"sale": {"sale": "aksys-games", "name": "Aksys Games", "headline": "Aksys Games Sale"},
"on_sale": true
}
],
"count": 24,
"total": 103,
"page": 1,
"page_size": 24,
"total_pages": 5,
"sale": null,
"heading": "Sales & deals",
"sales": [
{"sale": "best-sellers", "name": "Best sellers"},
{"sale": "square-enix", "name": "Square Enix"}
],
"requested_filters": {},
"notes": [
"On the Americas markets this is Nintendo's featured sale selection (the sale pages of nintendo.com), not every discounted game: check any id with the prices endpoint.",
"sale picks one sale page (sales[].sale); sale_start / sale_end come from the eShop price service."
]
}
Releases
curl -X POST https://api.scavio.dev/api/v1/nintendo/releases \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country": "gb"}'
Captured data (UK, 2026-11-15; 1 of 24 items shown):
{
"type": "new",
"country": "gb",
"language": "en",
"currency": "GBP",
"region": "europe",
"items": [
{
"nsuid": "70010000135060",
"page_id": "3188744",
"title": "Pikmin 4 – Nintendo Switch 2 Edition + Dandori Academy",
"url": "https://www.nintendo.com/en-gb/Games/Nintendo-Switch-2-Edition/Pikmin-4-Nintendo-Switch-2-Edition-Dandori-Academy-3188744.html",
"platform": "switch_2",
"release_date": "2026-11-12",
"publisher": "Nintendo",
"price": 58.99,
"regular_price": 58.99,
"sale_price": null,
"discount_percent": null,
"sale_start": null,
"sale_end": null,
"currency": "GBP",
"is_free": false,
"sales_status": "onsale",
"type": "game",
"age_rating": {"system": "PEGI", "rating": "3", "label": "PEGI 3"}
}
],
"count": 24,
"total": 20137,
"page": 1,
"page_size": 24,
"total_pages": 840,
"requested_filters": {},
"notes": ["Prices are the GB eShop's (GBP), not the catalog's own."]
}
DLC
curl -X POST https://api.scavio.dev/api/v1/nintendo/dlc \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"slug": "super-smash-bros-ultimate-switch"}'
Captured data (US, 2026-11-15; 2 of 69 items shown, image dropped):
{
"game": {"nsuid": "70010000012332", "title": "Super Smash Bros.™ Ultimate", "url": "https://www.nintendo.com/us/store/products/super-smash-bros-ultimate-switch/"},
"dlc": [
{"nsuid": "70070000009788", "title": "Super Smash Bros.™ Ultimate: Fighters Pass Vol. 2", "url": "https://www.nintendo.com/us/store/products/super-smash-bros-ultimate-fighters-pass-vol-2-70070000009788-switch/", "slug": "super-smash-bros-ultimate-fighters-pass-vol-2-70070000009788-switch", "type": "bundle", "release_date": "2020-01-28", "price": 29.99, "regular_price": 29.99, "sale_price": null, "discount_percent": null, "currency": "USD", "is_free": false, "sale_start": null, "sale_end": null, "sales_status": "onsale"},
{"nsuid": "70050000018966", "title": "Super Smash Bros.™ Ultimate: Challenger Pack 11", "url": "https://www.nintendo.com/us/store/products/super-smash-bros-ultimate-challenger-pack-11-70050000018966-switch/", "slug": "super-smash-bros-ultimate-challenger-pack-11-70050000018966-switch", "type": "dlc", "release_date": "2021-10-18", "price": 5.99, "regular_price": 5.99, "sale_price": null, "discount_percent": null, "currency": "USD", "is_free": false, "sale_start": null, "sale_end": null, "sales_status": "onsale"}
],
"count": 69,
"country": "us",
"language": "en",
"currency": "USD",
"region": "americas"
}
Python
import time
import requests
BASE = "https://api.scavio.dev"
# Your key from https://scavio.dev. Load it from your environment or secret
# store in real code - keep it out of source control.
API_KEY = "sk_your_key_here"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
def nd(endpoint, body, timeout=180):
r = requests.post(f"{BASE}/api/v1/nintendo/{endpoint}", headers=HEADERS, json=body, timeout=timeout)
if r.status_code == 404:
return None # not in that region's eShop (charged)
r.raise_for_status()
return r.json()["data"]
# Item ids per eShop region for one game (Mario Kart World), found once with
# search / product and kept: ids do not change.
IDS = {
"americas": "70010000095431", # product on us
"europe": "70010000096802", # search on gb
}
COUNTRIES = {"americas": ["us", "ca", "mx", "br"], "europe": ["gb", "de", "pl", "se", "au"]}
captured_at = time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime())
rows = []
for region, countries in COUNTRIES.items():
for cc in countries: # 1 credit per country, up to 50 ids per call
d = nd("prices", {"ids": [IDS[region]], "country": cc})
for p in d["prices"]:
rows.append({"country": cc, "currency": p["currency"], "price": p["price"],
"regular_price": p["regular_price"], "sale_end": p["sale_end"]})
for r in rows:
print(captured_at, r["country"], r["price"], r["currency"], "sale ends " + r["sale_end"] if r["sale_end"] else "")
# Store rows with captured_at and run this on a schedule: that stored series is
# your price history (Nintendo publishes none). Currencies differ: convert
# explicitly, with the rate and its date, before comparing countries.
Response shapes
Every response uses the envelope { data, response_time, fetched_at, credits_used, credits_remaining }. Everything is fetched live; nothing is cached. Every data echoes country, language, currency and region (americas, europe, japan or asia). Prices are numbers in the country's currency, never converted. notes appears when there is something to say.
- Grid item (search, deals, releases) -
nsuid,slug(Americas),page_id(Europe),url,title(in the request language),platform(switch/switch_2),release_date,release_date_text(Americas,jp),upcoming(Americas),publisher,price,regular_price,sale_price,discount_percent,sale_start,sale_end,currency,is_free,sales_status,image,type,age_rating{system,rating,labelorcode}. Americas search tiles addbadges[]andcategory; deals addon_saleand, on the Americas,amount_offandsale{sale,name,headline}. - Grid -
items[],count,total(nullon Americas search),page,page_size,total_pages,has_more(Americas search),requested_filters. Search and deals addsortandsorts_offered; search addsquery; releases addstype; Americas deals addsale,heading,sales[]{sale,name}. - product - under
data.product. Americas:nsuid,sku,application_id,title,url,slug,platform,platform_label,platforms,category,type,release_date,release_date_text,publisher,developer,genres,features,ways_to_play,players{system,local,online},languages,file_size_bytes,age_rating{system,rating,code,descriptors},headline,description, the price fields,sales_status,purchasable,preorder,has_demo,demo_nsuid,edition,editions[],is_upgrade,nintendo_switch_online{required,features},play_modes,availability,stock(My Nintendo Store goods),dlc[],image,images[]. Europe:nsuid,nsuids,page_id,application_id,title,url,platform,platforms,type,release_date,release_date_text,publisher,developer,genres,players{min,max,system,local,online},languages,file_size,age_rating,description, the price fields,has_demo,nintendo_switch_online{required,online_play,cloud_saves,game_voucher},physical_version,digital_version,game_series,base_game,images[],copyright. Japan:nsuid,title,title_reading,url,platform,type,release_date,release_date_text,publisher,genres,players,languages,age_rating{system:CERO,rating,code},description,headline, the price fields,has_demo,nintendo_switch_online,play_modes,format,dlc_nsuids,image,copyright. - prices -
prices[]{nsuid,sales_status,price,regular_price,sale_price,discount_percent,sale_start,sale_end,currency,is_free},not_found[](ids that eShop does not sell),count. - dlc -
game{nsuid,title,url},dlc[]{nsuid,title,url,slug(Americas),type(dlc,bundleorupgrade),release_date, the price fields,sale_start,sale_end,sales_status,image},count.
Guardrails
- Item ids are per eShop region (Americas; Europe with AU, NZ, ZA and IL; Japan; Korea; Hong Kong and Taiwan). Never send an id from one region to another region's country:
/priceslists it innot_foundand/productanswers404. There is no cross-region title mapping: when you match one game across regions, say you matched it by title. /pricestakes at most 50 ids per call and one country per call. Batch ids by region, one call per country.- Americas search tiles have
nsuid: nulland no exacttotal(has_moreinstead): call/productwith theslugto get the id. Americas search mixes games, hardware and merchandise (typeper item) and sorts byrelevanceornewestonly; it takes no filters. - Americas deals are Nintendo's featured sale pages, not every discounted game in the Americas eShop: never say a game is not on sale because it is missing from
/dealson an Americas market; check it with/prices. European and Japanese deals list every discounted game in the catalog. sale_startandsale_endare UTC timestamps from Nintendo.discount_percentis computed fromregular_priceandsale_price. Nintendo shows no price history or historical low: never call a sale price a record low. For a measured change, compare your own stored readings.- In Europe the catalog is priced in GBP (English) or EUR; every answer carries the requested country's own eShop price, never the catalog's. European price sorts follow the catalog's own price, so on countries with another currency the order can be slightly off (
notessays so). Grid items that country's eShop does not sell are kept withsales_status: "not_found"andprice: null. - Prices-only markets (
kr,hk,tw,il) have no search, product, deals, releases or DLC (400). Their ids must come from elsewhere; Taiwan uses Hong Kong ids, Israel European ids. - Nintendo Switch 2 Editions and upgrade packs are separate items with their own ids and prices (
platform: "switch_2";/dlctype: "upgrade"). - The European catalog includes adult-rated titles listed by Nintendo; check
age_ratingbefore showing deals or search results to a general audience. - Not available: user reviews (Nintendo's stores have none; age ratings only), best-seller charts, search suggestions, price history, cross-region title mapping, the Philippines and Russia.
- Prices are for research and pricing analysis. Nintendo's account terms tie purchases to the account's country: do not advise users to switch regions, change account country, use another region's gift cards or VPNs, or look for tax-free addresses.
- Terms: Nintendo of America's website terms ask users not to use robots, crawlers, scrapers or other automated means to access its websites to copy or extract data. We do not interpret them. This is not legal advice; the user is responsible for their own compliance. Do not republish box art, screenshots or logos; link store pages instead.
- Never fabricate prices, item ids, sale dates, release dates or titles. Only return what the API returned, with the country, the currency and the product
url.
Failure handling
400means a missing or invalid parameter, and it is not charged: acountryoutside the endpoint's markets (a prices-only market on a catalog endpoint;ph,ru,ukor a country with no eShop data); alanguagethe market does not serve; noqueryon/search; none or more than one ofnsuid,urlandslug; annsuidthat is not 14 digits starting70;slugoff the Americas; anything butnsuidonjp; aurlthat is not a served nintendo.com product link, or aurlandcountryin different regions; more than 50ids; asortor filter the catalog does not support;price_min/price_maxwhere the catalog is priced in another currency, orprice_maxbelowprice_min;page_sizeother than 40 on Americas search;pageorpage_sizeon Americas releases;salethat is not a sale page slug.401means the API key is invalid or missing. CheckSCAVIO_API_KEY.402means the balance is out of credits. The body carriesbilling_url.404means not found, and it is charged: "Nintendo has no Americas eShop item ... on nintendo.com/us (item ids are per region: an id from another region is not found here).", "Nintendo has no europe eShop item ... in its en catalog (item ids are per region: ...)", "Nintendo has no store product ... on nintendo.com/...", "Nintendo has no European game page ...". Take ids from a previous answer in the same region rather than guessing them.429means rate or usage limit exceeded. Wait before retrying. See rate limits.502means Nintendo data was temporarily unavailable ("Nintendo is temporarily unavailable. Please try again."). It is not charged, so retry after a few seconds.503with aRetry-Afterheader means Nintendo is busy ("Nintendo is busy right now. Please retry in a few seconds."): wait theRetry-Afterseconds (5) and send it again. Not charged.- If
SCAVIO_API_KEYis not set, prompt the user to export it before continuing.
SDKs
pip install scavio==0.61.0
npm install scavio@0.62.1
import { Scavio } from "scavio";
const scavio = new Scavio(); // reads SCAVIO_API_KEY
const { data: found } = await scavio.nintendo.search({ query: "mario", country: "gb", sort: "price_asc" });
const { data: game } = await scavio.nintendo.product({ slug: "mario-kart-world-switch-2" });
const { data: prices } = await scavio.nintendo.prices({ ids: ["70010000096802"], country: "pl" });
const { data: deals } = await scavio.nintendo.deals({ country: "de", sort: "discount" });
const { data: upcoming } = await scavio.nintendo.releases({ country: "jp", type: "upcoming" });
const { data: dlc } = await scavio.nintendo.dlc({ slug: "super-smash-bros-ultimate-switch" });
In Python (from scavio import ScavioClient, client = ScavioClient()) the same methods are client.nintendo.search(...), client.nintendo.product(...), client.nintendo.prices(...), client.nintendo.deals(...), client.nintendo.releases(...) and client.nintendo.dlc(...), with the same parameter names as keyword arguments.
MCP
The Scavio MCP server exposes all six endpoints as tools: search_nintendo, get_nintendo_product, get_nintendo_prices, get_nintendo_deals, get_nintendo_releases and get_nintendo_dlc. Nintendo is opt-in: add nintendo to SCAVIO_PLATFORMS.
{
"mcpServers": {
"scavio": {
"command": "npx",
"args": ["-y", "@scavio/mcp-server@0.59.0"],
"env": {
"SCAVIO_API_KEY": "sk_live_your_key",
"SCAVIO_PLATFORMS": "default,nintendo"
}
}
}
}
Docs
Full reference per endpoint: search, product, prices, deals, releases, DLC. Overview: Nintendo eShop API.
- Downloads
- Security audit
- Pass
- Last updated
- 3d ago
- Current version
- v1.0.0
- License
- MIT-0
