Nintendo
Nintendo eShop Prices API
The Nintendo eShop price of 1 to 50 item ids in one country, on all 46 markets: for each id the price now, regular price, sale price, discount, the sale start and end dates, currency, free flag and sales status, plus the ids that eShop does not sell. Item ids are per eShop region, so call it once per country with that region's ids. Nintendo shows no price history: poll this endpoint to build one. Costs 1 credit per request.
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsonidsstring | string[]required1 to 50 eShop item ids (nsuid), as an array or comma-separated. All from the requested country's eShop region (Americas, Europe, Japan, Korea, or Hong Kong + Taiwan). More than 50 answers 400.
Example: 70010000095431,70010000063714,70010000094234
countrystringdefault:usThe eShop market, as a lowercase country code. This endpoint serves all 46 markets: the 42 catalog markets plus South Korea (kr, KRW), Hong Kong (hk, HKD), Taiwan (tw, TWD, which uses the Hong Kong item ids) and Israel (il, EUR, European item ids). 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.kr— South Korea, KRW, ko (Korean); prices only.hk— Hong Kong, HKD, zh (Chinese); prices only.tw— Taiwan, TWD, zh (Chinese); prices only.il— Israel, EUR, en (English); prices only.
languagestringThe 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)
# One game's price in every Americas eShop: the Americas id works in all eight.
ids = ["70010000094234"] # Pokemon Legends: Z-A, Americas id
for country in ["us", "ca", "mx", "br", "ar", "cl", "co", "pe"]:
r = client.nintendo.prices(ids=ids, country=country)["data"]
for p in r["prices"]:
print(country, p["price"], p["regular_price"], p["currency"], p["sale_end"])Response