Nintendo

Nintendo eShop Product API

One Nintendo eShop or My Nintendo Store product by item id (nsuid), nintendo.com link or (Americas) store slug, on 42 markets: title, platform (Switch or Switch 2), type, release date, publisher, developer, genres, players, languages, file size, age rating, description, price, regular price, sale price, discount, sale start and end, free demo, Nintendo Switch Online requirements and images. The Americas store adds sku, editions, upgrade packs, play modes, availability and the game's DLC with prices; hardware, amiibo and merchandise carry a stock signal. Costs 1 credit per request.

POST/api/v1/nintendo/product

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

nsuidstring

An eShop item id: 14 digits starting 70 (items[].nsuid, prices[].nsuid). Ids are per eShop region: an Americas id is not found in Europe. Send one of nsuid, url or slug; jp takes nsuid only.

Example: 70010000095431

urlstring

A nintendo.com product link: an Americas store page (/us/store/products/<slug>/), a European game page (ending -<id>.html) or a nintendo.com/au game page. The link's region must agree with country.

Example: https://www.nintendo.com/us/store/products/mario-kart-world-switch-2/

slugstring

Americas markets only: the store slug (items[].slug of an Americas search).

Example: mario-kart-world-switch-2

countrystringdefault:us

The eShop market, as a lowercase country code. This endpoint serves 42 markets: the Americas (us, ca, mx, br, ar, cl, co, pe), Europe with a catalog in its own language (gb, ie, de, at, ch, fr, be, nl, lu, it, es, pt, au, nz, za), 18 European countries with no Nintendo site of their own that read the English European catalog with their own prices (pl, cz, se, no, dk, fi, sk, hu, ro, bg, gr, hr, si, ee, lv, lt, mt, cy), and Japan (jp). kr, hk, tw and il are prices only and answer 400 here. Titles come back in the market's language and prices in its currency, never converted; the answer echoes country, language, currency and region. ph (Nintendo has not published Philippines item ids yet), ru (no eShop), uk (use gb) and countries with no eShop data answer 400, not charged.

Example: us

us — United States, USD, en (English); Americas store. The default.
ca — Canada, CAD, en (English) or fr (French); default en; Americas store.
mx — Mexico, MXN, es (Spanish); Americas store.
br — Brazil, BRL, pt (Portuguese); Americas store.
ar — Argentina, ARS, es (Spanish); Americas store.
cl — Chile, CLP, es (Spanish); Americas store.
co — Colombia, COP, es (Spanish); Americas store.
pe — Peru, PEN, es (Spanish); Americas store.
gb — United Kingdom, GBP, en (English); European catalog in the market's language.
ie — Ireland, EUR, en (English); European catalog in the market's language.
de — Germany, EUR, de (German); European catalog in the market's language.
at — Austria, EUR, de (German); European catalog in the market's language.
ch — Switzerland, CHF, de (German) or fr (French) or it (Italian); default de; European catalog in the market's language.
fr — France, EUR, fr (French); European catalog in the market's language.
be — Belgium, EUR, fr (French) or nl (Dutch); default fr; European catalog in the market's language.
nl — Netherlands, EUR, nl (Dutch); European catalog in the market's language.
lu — Luxembourg, EUR, fr (French); European catalog in the market's language.
it — Italy, EUR, it (Italian); European catalog in the market's language.
es — Spain, EUR, es (Spanish); European catalog in the market's language.
pt — Portugal, EUR, pt (Portuguese); European catalog in the market's language.
au — Australia, AUD, en (English); European catalog in the market's language.
nz — New Zealand, NZD, en (English); European catalog in the market's language.
za — South Africa, ZAR, en (English); European catalog in the market's language.
pl — Poland, PLN, en (English); English European catalog, this country's prices.
cz — Czechia, CZK, en (English); English European catalog, this country's prices.
se — Sweden, SEK, en (English); English European catalog, this country's prices.
no — Norway, NOK, en (English); English European catalog, this country's prices.
dk — Denmark, DKK, en (English); English European catalog, this country's prices.
fi — Finland, EUR, en (English); English European catalog, this country's prices.
sk — Slovakia, EUR, en (English); English European catalog, this country's prices.
hu — Hungary, EUR, en (English); English European catalog, this country's prices.
ro — Romania, EUR, en (English); English European catalog, this country's prices.
bg — Bulgaria, EUR, en (English); English European catalog, this country's prices.
gr — Greece, EUR, en (English); English European catalog, this country's prices.
hr — Croatia, EUR, en (English); English European catalog, this country's prices.
si — Slovenia, EUR, en (English); English European catalog, this country's prices.
ee — Estonia, EUR, en (English); English European catalog, this country's prices.
lv — Latvia, EUR, en (English); English European catalog, this country's prices.
lt — Lithuania, EUR, en (English); English European catalog, this country's prices.
mt — Malta, EUR, en (English); English European catalog, this country's prices.
cy — Cyprus, EUR, en (English); English European catalog, this country's prices.
jp — Japan, JPY, ja (Japanese); Japanese catalog.

languagestring

The answer's language, from the market's own list (the first is the default): ca en or fr; ch de, fr or it; be fr or nl; mx, ar, cl, co, pe and es es; br and pt pt; de and at de; fr and lu fr; it it; nl nl; jp ja; kr ko; hk and tw zh; every other market en. Titles, genres and descriptions come back in it. A language the market does not serve answers 400.

Example: fr

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key", timeout=120)

p = client.nintendo.product(slug="mario-kart-world-switch-2", country="us")["data"]["product"]
print(p["nsuid"], p["title"], p["platform"], p["price"], p["regular_price"], p["sale_end"])
print(p["age_rating"]["system"], p["age_rating"]["rating"], p["has_demo"], len(p["dlc"]), "DLC")

Response

"country": "us",

"language": "en",

"currency": "USD",

"region": "americas"

"response_time": 2655

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key", timeout=120) p = client.nintendo.product(slug="mario-kart-world-switch-2", country="us")["data"]["product"] print(p["nsuid"], p["title"], p["platform"], p["price"], p["regular_price"], p["sale_end"]) print(p["age_rating"]["system"], p["age_rating"]["rating"], p["has_demo"], len(p["dlc"]), "DLC")