nintendo-switch-eshop
Advanced tools
Unofficial API lib for Nintendo Switch eShop game listing and pricing information.
nintendo-switch-eshop is a npm lib module written to extract Nintendo Switch's eShop game and pricing information.
To install it just type the following at your command line
npm install --save nintendo-switch-eshop
And require it in your node module as follows:
const SwitchEshop = require('nintendo-switch-eshop');
Promise<Array<GameUS>>Fetches all games on american eshops. Paginates every 200 games.
Promise<Array<GameJP>>Fetches all games on japanese eshop. Paginates every 16 games.
Promise<Array<GameEU>>Fetches all games on european eshop. Paginates every 9999 games.
Promise<Array<Eshop>>Gets all active eshops given a list of countries.
Promise<Array<Eshop>>Gets all active eshops on american countries. This method will launch several requests at nintendo web services, so don't abuse it.
Promise<Array<Eshop>>Gets all active eshops on european countries. Please note that South Africa and Oceania countries are included. This method will launch several requests at nintendo web services, so don't abuse it.
Promise<Array<Eshop>>Gets all active eshops on asian countries. This method will launch several requests at nintendo web services, so don't abuse it.
Promise<Array<Eshop>>Gets all active eshops. This method will launch several requests at nintendo web services, so don't abuse it.
Promise<PriceResponse>Get pricing information for the requested games. Paginates every 50 games.
stringParses the game code to extract the cross-region protion.
stringExtracts NSUID information from the game object.
ObjectObjectObjectObjectObjectObjectObjectObjectObjectenumRegion code constant.
Read only: true
Properties
| Name | Type | Default |
|---|---|---|
| AMERICAS | number | 1 |
| EUROPE | number | 2 |
| ASIA | number | 3 |
Promise<Array<GameUS>>Fetches all games on american eshops. Paginates every 200 games.
Returns: Promise<Array<GameUS>> - Promise containing all the games.
Promise<Array<GameJP>>Fetches all games on japanese eshop. Paginates every 16 games.
Returns: Promise<Array<GameJP>> - Promise containing all the games.
Promise<Array<GameEU>>Fetches all games on european eshop. Paginates every 9999 games.
Returns: Promise<Array<GameEU>> - Promise containing all the games.
Promise<Array<Eshop>>Gets all active eshops given a list of countries.
Returns: Promise<Array<Eshop>> - A list of shop objects with country code, name and default currency.
| Param | Type | Description |
|---|---|---|
| countryCodes | Array<string> | A list of 2 digit country codes for every country eshop to lookup. (ISO 3166-1 alpha-2 country codes) |
| gamecode | string | A 14 digits game NSUID from the desired region. |
| region | number | A region id that will be appendend in the final shop object for filtering purposes. |
Promise<Array<Eshop>>Gets all active eshops on american countries. This method will launch several requests at nintendo web services, so don't abuse it.
Returns: Promise<Array<Eshop>> - A list of shop objects with country code, name and default currency.
Promise<Array<Eshop>>Gets all active eshops on european countries. Please note that South Africa and Oceania countries are included. This method will launch several requests at nintendo web services, so don't abuse it.
Returns: Promise<Array<Eshop>> - A list of shop objects with country code, name and default currency.
Promise<Array<Eshop>>Gets all active eshops on asian countries. This method will launch several requests at nintendo web services, so don't abuse it.
Returns: Promise<Array<Eshop>> - A list of shop objects with country code, name and default currency.
Promise<Array<Eshop>>Gets all active eshops. This method will launch several requests at nintendo web services, so don't abuse it.
Returns: Promise<Array<Eshop>> - A list of shop objects with country code, name and default currency.
Promise<PriceResponse>Get pricing information for the requested games. Paginates every 50 games.
Returns: Promise<PriceResponse> - A promise containing the pricing information.
| Param | Type | Description |
|---|---|---|
| country | string | A two digit country code. (ISO 3166-1 alpha-2 country code) |
| gameIds | Array<string> | string | One or more NSUID of the corresponding games. |
stringParses the game code to extract the cross-region protion.
Returns: string - The 4-digit resulting game code.
| Param | Type | Description |
|---|---|---|
| game | GameUS | GameEU | GameJP | The game object returned from one of the other methods. |
| region | number | Region code. (use the Region constant) |
stringExtracts NSUID information from the game object.
Returns: string - The 14-digit NSUID.
| Param | Type | Description |
|---|---|---|
| game | GameUS | GameEU | GameJP | The game object returned from one of the other methods. |
| region | number | Region code. (use the Region constant) |
ObjectProperties
| Name | Type |
|---|---|
| category | Array<string> |
ObjectProperties
| Name | Type | Description |
|---|---|---|
| game_code | string | Product code. Can be parsed for a region wide code. |
| buyonline | boolean | |
| front_box_art | string | |
| eshop_price | number | USA eShop price (in dollars) |
| nsuid | string | 14-digit game unique identifier |
| video_link | string | |
| number_of_players | string | |
| ca_price | number | Canada eShop price (in canadian dollars) |
| id | string | |
| title | string | |
| system | string | Gaming platform |
| free_to_start | boolean | |
| digitaldownload | boolean | |
| release_date | string | |
| categories | Categories | |
| slug | string | Game URL name |
| buyitnow | boolean |
ObjectProperties
| Name | Type | Description |
|---|---|---|
| age_rating_type | string | |
| age_rating_value | string | |
| copyright_s | string | |
| developer | string | |
| excerpt | string | |
| fs_id | string | |
| game_series_t | string | |
| gift_finder_carousel_image_url_s | string | |
| gift_finder_description_s | string | |
| gift_finder_detail_page_image_url_s | string | |
| gift_finder_detail_page_store_link_s | string | |
| gift_finder_wishlist_image_url_s | string | |
| image_url | string | |
| image_url_sq_s | string | |
| image_url_tm_s | string | |
| originally_for_t | string | |
| pretty_agerating_s | string | |
| pretty_date_s | string | |
| publisher | string | |
| sorting_title | string | |
| title | string | |
| type | string | |
| url | string | |
| add_on_content_b | boolean | |
| club_nintendo | boolean | |
| near_field_comm_b | boolean | |
| physical_version_b | boolean | |
| play_mode_handheld_mode_b | boolean | |
| play_mode_tabletop_mode_b | boolean | |
| play_mode_tv_mode_b | boolean | |
| change_date | Date | |
| date_from | Date | |
| priority | Date | |
| age_rating_sorting_i | number | |
| players_from | number | |
| players_to | number | |
| compatible_controller | Array<string> | |
| game_categories_txt | Array<string> | |
| game_category | Array<string> | |
| language_availability | Array<string> | |
| nsuid_txt | Array<string> | Array containing the 14-digit game unique identifier |
| playable_on_txt | Array<string> | |
| product_code_txt | Array<string> | Array containing the product code |
| system_names_txt | Array<string> | |
| system_type | Array<string> | |
| title_extras_txt | Array<string> |
ObjectProperties
| Name | Type | Description |
|---|---|---|
| Row | Array<string> | |
| TitleName | Array<string> | A single item array containing the game title |
| LinkUrl | Array<string> | A single item array containing the game url |
| Imgpath | Array<string> | A single item array containing the game thumbnail url |
| ImgpathSp | Array<string> | A single item array containing the game cover art url |
| Detail | Array<string> | A single item array containing the HTML markup for game details |
| HardId | Array<string> | |
| TrialFlg | Array<string> | |
| TermType | Array<string> | |
| MediaType | Array<string> | |
| SoftType | Array<string> |
ObjectProperties
| Name | Type |
|---|---|
| code | string |
| country | string |
| currency | string |
| region | Region |
ObjectProperties
| Name | Type |
|---|---|
| code | string |
| message | string |
ObjectProperties
| Name | Type |
|---|---|
| amount | string |
| currency | string |
| raw_value | string |
ObjectProperties
| Name | Type |
|---|---|
| title_id | number |
| sales_status | string |
| regular_price | Array<PriceData> |
ObjectProperties
| Name | Type |
|---|---|
| error | PriceError |
| personalized | boolean |
| country | string |
| prices | Array<TitleData> |
1.0.6 - 2017-06-23
FAQs
Unofficial API lib for Nintendo Switch eShop game listing and pricing information.
The npm package nintendo-switch-eshop receives a total of 58 weekly downloads. As such, nintendo-switch-eshop popularity was classified as not popular.
We found that nintendo-switch-eshop demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
TC39 met in Seattle and advanced 9 JavaScript proposals, including three to Stage 4, introducing new features and enhancements for a future ECMAScript release.
Security News
Deno 2.2 enhances Node.js compatibility, improves dependency management, adds OpenTelemetry support, and expands linting and task automation for developers.
Security News
React's CRA deprecation announcement sparked community criticism over framework recommendations, leading to quick updates acknowledging build tools like Vite as valid alternatives.