Nintendo

Nintendo eShop DLC API

A Nintendo eShop game's DLC, bundles and upgrade packs, on 42 markets, by the game's item id, nintendo.com link or (Americas) store slug: the game, then each add-on with its item id, title, link, type (dlc, bundle or upgrade), release date, price, regular price, sale price, discount, sale start and end, currency and sales status, priced for the requested country. Costs 1 credit per request.

POST/api/v1/nintendo/dlc

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

The game's eShop item id (14 digits starting 70), from that region's eShop. Send one of nsuid, url or slug.

Example: 70010000012332

urlstring

The game's nintendo.com link (Americas store page, European game page or nintendo.com/au game page). Its region must agree with country.

Example: https://www.nintendo.com/us/store/products/super-smash-bros-ultimate-switch/

slugstring

Americas markets only: the game's store slug.

Example: super-smash-bros-ultimate-switch

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)

r = client.nintendo.dlc(nsuid="70010000012332", country="us")["data"]
print(r["game"]["title"], r["count"], "add-ons")
for d in r["dlc"]:
    print(d["type"], d["title"], d["price"], d["regular_price"], d["sale_end"])

Response

"count": 69,

"country": "us",

"language": "en",

"currency": "USD",

"region": "americas"

"response_time": 6347

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key", timeout=120) r = client.nintendo.dlc(nsuid="70010000012332", country="us")["data"] print(r["game"]["title"], r["count"], "add-ons") for d in r["dlc"]: print(d["type"], d["title"], d["price"], d["regular_price"], d["sale_end"])