Nintendo

Nintendo eShop Releases API

New Nintendo eShop releases (released games, newest first) or upcoming games (future release dates, soonest first), on 42 markets, with the item id, title, platform (Switch or Switch 2), release date, publisher, price, sale fields and age rating. Europe and Japan are paged (up to 50 a page); the Americas return Nintendo's new releases or coming soon list in one page. Every market filters by Switch or Switch 2. Costs 1 credit per request.

POST/api/v1/nintendo/releases

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

typeenum<string>default:new

new (released games, newest first) or upcoming (future release dates, soonest first).

Example: upcoming

new — Released games, newest first. The default.
upcoming — Games with a future release date, soonest first.

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

platformenum<string>

switch or switch_2.

Example: switch_2

switch — Nintendo Switch.
switch_2 — Nintendo Switch 2.

pageintegerdefault:1

Results page, 1-based, up to 400 (Europe and jp). The Americas lists are one page: another page answers 400.

Example: 2

page_sizeintegerdefault:24

Items per page, 1 to 50 (Europe and jp). Not accepted on the Americas.

Example: 50

Request

from scavio import ScavioClient

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

# Upcoming Switch 2 games in Japan, soonest first.
r = client.nintendo.releases(type="upcoming", country="jp", platform="switch_2")["data"]
for i in r["items"]:
    print(i["release_date"], i["title"], i["price"], i["currency"])

Response

"type": "new",

"country": "gb",

"language": "en",

"currency": "GBP",

"region": "europe",

"count": 24,

"total": 20137,

"page": 1,

"page_size": 24,

"total_pages": 840,

"requested_filters": {},

"response_time": 4490

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key", timeout=120) # Upcoming Switch 2 games in Japan, soonest first. r = client.nintendo.releases(type="upcoming", country="jp", platform="switch_2")["data"] for i in r["items"]: print(i["release_date"], i["title"], i["price"], i["currency"])