Nintendo eShop API
Nintendo eShop regional prices as structured JSON: one game's regular price, sale price and sale end date in each eShop country, in that country's currency, up to 50 games per call. Plus catalog search, full game pages, deals, new and upcoming releases and DLC for Nintendo Switch and Nintendo Switch 2.
50 free credits on signup. No card.
{ "data": { "prices": [ { "nsuid": "70010000095431", "sales_status": "onsale", "price": 79.99, "regular_price": 79.99, "sale_price": null, "discount_percent": null, "sale_start": null, "sale_end": null, "currency": "USD", "is_free": false }, "… 2 more (trimmed for preview)" ], "not_found": [], "count": 3, "country": "us", "language": "en", "currency": "USD", "region": "americas", "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.", "… 1 more (trimmed for preview)" ] }, "response_time": 1147}Live calls against the real endpoints. Prices takes any of the 46 eShop countries and sends that region's ids for Mario Kart World, Tears of the Kingdom and Pokémon Legends: Z-A. 3 free runs across every tab, then it's your own key.
What is the Scavio Nintendo eShop API?
The Scavio Nintendo eShop API is a REST API that returns Nintendo eShop prices, sales, games, deals, releases and DLC as JSON for 46 countries. For up to 50 item ids per call it returns the price, regular price, sale price and sale end date in the requested country's currency. Every call costs 1 credit.
- 6
- endpoints, all live in production
- 46
- eShop countries: the Americas, Europe, Oceania, South Africa, Japan, Korea, Hong Kong, Taiwan, Israel
- 1
- credit per call, up to 50 item ids per prices call
The eShop data deal sites and price trackers need
What a game costs in each eShop, when its sale ends, what is on sale now, what is coming out and which DLC it has.
One game, every eShop country
POST /api/v1/nintendo/pricesUp to 50 item ids per call, priced in the requested country's currency. Mario Kart World on 2026-11-15: 79.99 USD, 109.99 CAD, 439.90 BRL, 66.99 GBP, 79.99 EUR, 879 SEK, 8,980 JPY.
Sale start and end dates
POST /api/v1/nintendo/pricessale_start and sale_end are the eShop's own sale window, next to regular_price, sale_price and discount_percent, so a tracker knows when a price ends.
Every game on sale
POST /api/v1/nintendo/dealsEvery discounted game in a European or Japanese eShop, sorted by discount, price or newest; Nintendo's featured sale pages on the Americas stores.
Search the catalog in its language
POST /api/v1/nintendo/search42 markets, titles in the market's language. Europe filters by Switch 2, on sale, price range, genre, players, publisher and demo.
Full game pages
POST /api/v1/nintendo/productRelease date, publisher, genres, players, languages, file size, ESRB, PEGI, USK or CERO rating, demo and Nintendo Switch Online needs.
DLC and upgrade packs
POST /api/v1/nintendo/dlcEvery add-on for a game with its price and sale window. Super Smash Bros. Ultimate listed 69 in the US eShop on 2026-11-15.
New and upcoming releases
POST /api/v1/nintendo/releasesNewly released games newest first, or upcoming games by release date, for Switch or Switch 2.
46 countries, 23 currencies
POST /api/v1/nintendo/pricesThe Americas, Europe, Oceania, South Africa, Japan, Korea, Hong Kong, Taiwan and Israel, each in its own currency, never converted.
All 6 Nintendo eShop API endpoints
Every route is a POST, returns JSON and takes the same API key. Credits are charged per successful call and per not-found; a 400 and failed upstream calls are not charged.
| Endpoint | Returns | Credits |
|---|---|---|
Prices/api/v1/nintendo/prices | Up to 50 item ids priced in any of 46 eShop countries: price now, regular price, sale price, discount, sale start and end, currency | 1 |
Search/api/v1/nintendo/search | Keyword search on 42 markets: item id (slug on the Americas), title, Switch or Switch 2, release date, price and sale fields, age rating; sorts and filters per catalog | 1 |
Product/api/v1/nintendo/product | One game by item id, link or Americas slug: price and sale window, release date, publisher, genres, players, languages, file size, age rating, demo, Switch Online needs | 1 |
Deals/api/v1/nintendo/deals | Games on sale now with sale price, discount and end date: every discounted game in Europe and Japan, Nintendo's featured sale pages in the Americas | 1 |
Releases/api/v1/nintendo/releases | New releases (newest first) or upcoming games (soonest first), filtered by Switch or Switch 2 | 1 |
DLC/api/v1/nintendo/dlc | A game's DLC, bundles and upgrade packs, each with its item id, release date, price and sale window in the country's currency | 1 |
50 free credits on signup covers 50 calls, and a prices call covers up to 50 games. See plans
46 eShop countries, 10 languages, 23 currencies
One country parameter, plus language where the market offers more than one. Titles come in the market's language; every answer echoes country, language, currency and region.
| country | Market | Language(s), first = default | Currency | Endpoints |
|---|---|---|---|---|
| us (default) | United States | English | USD | All 6 |
| ca | Canada | English or French | CAD | All 6 |
| mx, ar, cl, co, pe | Mexico, Argentina, Chile, Colombia, Peru | Spanish | MXN, ARS, CLP, COP, PEN | All 6 |
| br | Brazil | Portuguese | BRL | All 6 |
| gb, ie | United Kingdom, Ireland | English | GBP, EUR | All 6 |
| de, at | Germany, Austria | German | EUR | All 6 |
| ch | Switzerland | German, French or Italian | CHF | All 6 |
| fr, lu | France, Luxembourg | French | EUR | All 6 |
| be | Belgium | French or Dutch | EUR | All 6 |
| nl, it, es, pt | Netherlands, Italy, Spain, Portugal | Dutch, Italian, Spanish, Portuguese | EUR | All 6 |
| au, nz, za | Australia, New Zealand, South Africa | English | AUD, NZD, ZAR | All 6 |
| pl, cz, se, no, dk | Poland, Czechia, Sweden, Norway, Denmark | English (European catalog) | PLN, CZK, SEK, NOK, DKK | All 6, with that country's prices |
| fi, sk, hu, ro, bg, gr, hr, si, ee, lv, lt, mt, cy | 13 more European countries | English (European catalog) | EUR | All 6, with that country's prices |
| jp | Japan | Japanese | JPY | All 6 |
| kr | South Korea | Korean | KRW | prices |
| hk, tw | Hong Kong, Taiwan | Chinese | HKD, TWD | prices |
| il | Israel | English | EUR | prices |
1 credit per call everywhere. The 18 European countries without a Nintendo site of their own read the English European catalog with their own eShop prices. Korea, Hong Kong, Taiwan and Israel have no searchable catalog, so they answer prices only. The Philippines (Nintendo has not published its item ids yet), Russia (no eShop) and countries with no eShop data answer 400, not charged; send gb for the United Kingdom.
Same game, every eShop
Regular prices read with the prices endpoint on 2026-11-15, one call per country, each region's own item ids. Local currency as each eShop showed it, never converted. None of the three was on sale that day.
| country | Currency | Mario Kart World (Switch 2) | Tears of the Kingdom (Switch) | Pokémon Legends: Z-A (Switch) |
|---|---|---|---|---|
| us | USD | 79.99 | 69.99 | 59.99 |
| ca | CAD | 109.99 | 99.99 | 84.99 |
| mx | MXN | 1,649 | 1,449 | 1,229 |
| br | BRL | 439.90 | 389.90 | 329.90 |
| ar | ARS | 120,999 | 105,999 | 90,999 |
| cl | CLP | 82,990 | 71,990 | 61,990 |
| co | COP | 319,900 | 279,900 | 239,900 |
| pe | PEN | 319 | 279 | 239 |
| gb | GBP | 66.99 | 59.99 | 49.99 |
| ie, de, at, fr, be, nl, lu, it, es, pt, fi, sk, hu, ro, bg, gr, hr, si, ee, lv, lt, mt, cy, il | EUR | 79.99 | 69.99 | 59.99 |
| ch | CHF | 79.90 | 69.90 | 59.90 |
| pl | PLN | 329.80 | 289.80 | 249.80 |
| cz | CZK | 1,999 | 1,749 | 1,499 |
| se | SEK | 879 | 769 | 659 |
| no | NOK | 879 | 769 | 659 |
| dk | DKK | 599 | 519 | 449 |
| au | AUD | 119.95 | 89.95 | 89.95 |
| nz | NZD | 129.95 | 99.95 | 99.95 |
| za | ZAR | 1,529 | 1,329 | 1,129 |
| jp | JPY | 8,980 | 7,900 | 7,100 |
| kr | KRW | - | 74,800 | - |
| hk | HKD | - | - | 359 |
| tw | TWD | - | - | 1,449 |
A dash means that eShop's list had no id for the game when we read it. Item ids used: Americas 70010000095431, 70010000063714, 70010000094234; Europe (every European country plus au, nz, za and il) 70010000096802, 70010000063715, 70010000094235; Japan 70010000092842, 70010000063713, 70010000094233; Korea 70010000063716; Hong Kong and Taiwan 70010000094237. Prices on one date, before any sale and excluding sales tax where a market adds it at checkout; a price comparison is for research and pricing analysis, and Nintendo account terms tie purchases to the account's country.
How item ids work
An item id (nsuid, 14 digits starting 70) belongs to one eShop region. Look the game up once per region, then price it in any country of that region.
| eShop region | Countries | Find the id with | Mario Kart World id |
|---|---|---|---|
| Americas | us, ca, mx, br, ar, cl, co, pe | search (slug), then product; or product with a store link | 70010000095431 |
| Europe | gb, ie, de, at, ch, fr, be, nl, lu, it, es, pt, au, nz, za, the 18 overlay countries, il | search or product (items carry nsuid) | 70010000096802 |
| Japan | jp | search or product | 70010000092842 |
| Korea | kr | your own list (no searchable catalog) | not in its list on 2026-11-15 |
| Hong Kong + Taiwan | hk, tw | your own list (no searchable catalog) | not in its list on 2026-11-15 |
An id from another region is not found: prices lists it under not_found, product answers 404. There is no cross-region title mapping, so store one id per region for each game you track.
What deals returns, by region
The deals endpoint mirrors what each regional store publishes.
| Region | What it lists | Sorts | Extra fields |
|---|---|---|---|
| Americas (8 markets) | Nintendo's featured sale pages (the nintendo.com sales and deals pages), not every discounted game | featured, discount, price_asc, newest, ending_soon | sale { sale, name, headline } per item, sales[] with every sale page's slug |
| Europe (33 markets) | Every discounted game in the catalog, at the country's own sale price | discount, price_asc, newest | on_sale, amount_off |
| Japan | Every discounted game in the catalog | newest, price_asc | on_sale, amount_off |
On the Americas, check any game that is not on a featured page with the prices endpoint: its sale_price and sale_end show whether it is discounted. The US capture of 2026-11-15 listed 103 featured items across 5 sale pages; Q Collection read 20.99 USD (29.99 regular, 30% off) with sale_end 2026-11-19T07:59:59Z.
Price one game in every eShop
A regional price tracker sends each region's item id to prices, once per country, and stores price, sale_end and currency. The response on the right is a real prices capture from the US eShop.
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=120)
# Item ids are per eShop region: each region's id for Mario Kart World.
mario_kart_world = {
"americas": ("70010000095431", ["us", "ca", "mx", "br", "ar", "cl", "co", "pe"]),
"europe": ("70010000096802", ["gb", "de", "fr", "pl", "se", "au", "nz", "za"]),
"japan": ("70010000092842", ["jp"]),
}
for region, (nsuid, countries) in mario_kart_world.items():
for country in countries:
p = client.nintendo.prices(ids=[nsuid], country=country)["data"]["prices"][0]
print(country, p["price"], p["regular_price"], p["currency"], p["sale_end"]){
"data": {
"prices": [
{
"nsuid": "70010000095431",
"sales_status": "onsale",
"price": 79.99,
"regular_price": 79.99,
"sale_price": null,
"discount_percent": null,
"sale_start": null,
"sale_end": null,
"currency": "USD",
"is_free": false
},
{
"nsuid": "70010000063714",
"sales_status": "onsale",
"price": 69.99,
"regular_price": 69.99,
"sale_price": null,
"discount_percent": null,
"sale_start": null,
"sale_end": null,
"currency": "USD",
"is_free": false
},
{
"nsuid": "70010000094234",
"sales_status": "onsale",
"price": 59.99,
"regular_price": 59.99,
"sale_price": null,
"discount_percent": null,
"sale_start": null,
"sale_end": null,
"currency": "USD",
"is_free": false
}
],
"not_found": [],
"count": 3,
"country": "us",
"language": "en",
"currency": "USD",
"region": "americas",
"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)."
]
},
"response_time": 1147
}Why not an official Nintendo API?
Nintendo's developer program is built for making games. Here is what it covers, and where the Scavio API fits.
Nintendo Developer Portal
- For building and publishing games for Nintendo platforms
- Registration open to companies and individuals
- Self-publish on the Nintendo eShop with your own price and release date
- No public store price, sale or catalog API
Scavio Nintendo eShop API
- One Scavio key issued at signup, 1 credit per call
- Any game's price in 46 eShop countries, up to 50 ids per call
- Sale start and end dates, deals, new releases and DLC
- Titles in the market's language, prices in its currency
- Search and full game pages on 42 markets
- The same JSON envelope and key as every other Scavio platform
Nintendo facts from developer.nintendo.com, read 2026-11-15. Not legal advice.
What developers build with it
Regional price comparison
Price one game in every eShop country it is sold in and keep each currency, for research and pricing analysis.
search + pricesSale and price-drop alerts
Poll a watch list of up to 50 ids per call and alert when sale_price appears, with the date the sale ends.
pricesDeal sites and newsletters
List every game on sale in a European or Japanese eShop, or Nintendo's featured sales in the Americas, sorted by discount or end date.
dealsPrice history you own
Nintendo shows no price history: poll prices daily and store each reading to build your own record and historical lows.
pricesPublisher and launch pricing research
See how comparable games are priced per country, how deep their sales go, and when new releases land in each region.
search + releases + pricesDLC and Switch 2 upgrade tracking
Track a game's DLC, bundles and Switch 2 upgrade packs with their prices and sale windows.
dlc + pricesDiscord and Telegram bots
Post new releases and sales ending soon to a community channel, in the community's eShop currency.
releases + dealsShopping agents and assistants
Give an AI agent the eShop as tools: find a game, read its page and DLC, and price it in the user's country.
MCP + RESTHow to get Nintendo eShop prices by country
- 1
Get an API key
Sign up for a Scavio account and copy your key from the dashboard. You get 50 free credits on signup (50 calls), with no card.
- 2
Find the game's item id in each region
Send {"query": "mario kart", "country": "gb"} to https://api.scavio.dev/api/v1/nintendo/search with an Authorization: Bearer header: European items carry nsuid. On the Americas, search returns a slug: send it to /api/v1/nintendo/product for the nsuid.
- 3
Price it in every country of the region
Send {"ids": ["70010000096802"], "country": "pl"} to /api/v1/nintendo/prices, one call per country, up to 50 ids each. Each answer has price, regular_price, sale_price, discount_percent, sale_start, sale_end and currency.
- 4
Poll and store each reading
Run the same calls on a schedule and store price, sale_end, currency and fetched_at. Nintendo publishes no price history, so your readings are the record.
Nintendo eShop API FAQ
Does Nintendo have a public eShop API?
+
No. Nintendo has no public eShop data API. The Nintendo Developer Portal is for building and publishing games for Nintendo platforms; it does not offer store prices or catalog data to third parties. The Scavio Nintendo eShop API is a separate option: 6 POST endpoints on one API key.
How do I get Nintendo eShop prices by country?
+
Call prices with the game's item id and a country: it returns the price in that eShop's currency, with the regular price, sale price, discount and sale dates. Item ids are per region, so use the Americas id for us, ca, mx, br, ar, cl, co and pe, the European id for the European countries plus au, nz, za and il, and the Japanese id for jp. Mario Kart World read 79.99 USD, 109.99 CAD, 66.99 GBP, 79.99 EUR and 8,980 JPY on 2026-11-15. Nintendo eShop Prices API docs
Does it return when an eShop sale ends?
+
Yes. sale_start and sale_end are the eShop's own sale window (ISO 8601, UTC), returned by prices, search, deals, product and dlc next to regular_price, sale_price and discount_percent. Nintendo announced a US eShop sale on select digital games from November 19 through December 2, 2026; Black Friday is November 27, 2026.
Is there Nintendo eShop price history or a historical low?
+
Nintendo shows no price history or historical low, so no endpoint returns one. Poll prices on a schedule (50 ids per call) and store each reading; 200 games read daily in one country is about 120 credits a month, since 50 ids cost 1 credit.
Why are item ids different per region?
+
Nintendo numbers each game separately in each eShop region: the Americas, Europe (with Australia, New Zealand, South Africa and Israel), Japan, Korea, and Hong Kong + Taiwan. Mario Kart World is 70010000095431 in the Americas, 70010000096802 in Europe and 70010000092842 in Japan. An id from another region comes back under not_found, and there is no cross-region title mapping: look the game up in each region once and store the ids.
Which countries, currencies and languages are covered?
+
46 countries. Search, product, deals, releases and DLC run on 42: the US, Canada (English or French), Mexico, Brazil, Argentina, Chile, Colombia and Peru; the UK, Ireland, Germany, Austria, Switzerland (German, French or Italian), France, Belgium (French or Dutch), the Netherlands, Luxembourg, Italy, Spain, Portugal, Australia, New Zealand and South Africa in their own language; 18 more European countries on the English European catalog with their own prices; and Japan. Prices adds South Korea, Hong Kong, Taiwan and Israel. The Philippines and Russia are not served.
Does deals return every discounted game?
+
In Europe and Japan, yes: every discounted game in the catalog, at the country's sale price. In the Americas it returns Nintendo's featured sale pages (the nintendo.com sales and deals pages), not every discounted game, with the sale page each item belongs to; check any other game with prices. Nintendo eShop Deals API docs
Can I tell Switch 2 games from Switch games?
+
Yes. Every item carries platform switch or switch_2, and search, deals and releases filter by it in Europe and Japan (deals and releases everywhere). Switch 2 Edition upgrade packs come back from dlc with type upgrade, and the Americas product page flags is_upgrade. Nintendo had sold 26.35 million Nintendo Switch 2 consoles by September 30, 2026.
Does it return DLC and bundles?
+
Yes. dlc takes a game's item id, link or Americas slug and returns each DLC, bundle and upgrade pack with its item id, release date, price and sale window in the country's currency. Super Smash Bros. Ultimate listed 69 add-ons in the US eShop on 2026-11-15. Nintendo eShop DLC API docs
Does it show which games have a free demo?
+
Yes. product returns has_demo (and demo_nsuid on the Americas), European search filters to games with a demo with has_demo true, and Americas search tiles carry the store's Free demo badge.
Does it return user reviews or ratings?
+
No. Nintendo's stores show no user reviews or star ratings, so there are none to return. Each game carries its age rating instead (ESRB, PEGI, USK, CERO or CLASSIND, with descriptors on the Americas). There are also no best-seller charts and no search autocomplete.
What do Nintendo's terms say?
+
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, and to get written consent before building third-party apps that interact with its services. We do not interpret them for you: read the current terms for your use case. You are responsible for your own compliance. This is not legal advice.
How much does a Nintendo eShop request cost?
+
1 credit per call on every endpoint and country, and a prices call covers up to 50 item ids. New accounts get 50 free credits on signup, one time and with no card. Paid plans start with Hobby at $15 per month for 3,000 credits; on Growth credits cost $1 per 1,000, so a call costs $0.001. A 400 and a failed upstream call are not charged; a not-found is charged.
How fresh is the data, and how long does a call take?
+
Every request reads Nintendo's store when you call it and carries fetched_at; nothing is cached. Most calls answer in 1 to 10 seconds; Americas search takes about 7 to 19 seconds. Set a client timeout of 120 seconds.
Explore more of Scavio
Best Nintendo eShop regional price APIs
Seven options priced, plus 50 games in 39 eShops: the median cost 73% more in its dearest eShop.
How to get Nintendo eShop prices by country
Ids per region, 50 games per prices call, sale end dates, DLC and a daily poll, step by step.
Are Switch games more expensive in Canada?
50 games in Canada and the US: 33 of 34 Nintendo titles match the US price at the exchange rate.
TCGplayer API
Trading card market prices, listings and sales history.
Google Play API
Google Play search, full app listings and reviews.
App Store API
Apple App Store search, listings and reviews.
Amazon API
Search, product and offers across 22 marketplaces, games included.
Best Buy API
Best Buy products, open-box offers and store pickup.
Nintendo eShop API docs
All 6 endpoints with params and real responses.
Start reading Nintendo eShop prices
50 free credits on signup, no card. One key for the Nintendo eShop and every other Scavio platform.