Prepend all routes with https://lp1.nso.nintendo.net.
All requests are made with HTTP2.
Grabs your account's basic user information. Not a full response of data; just what appears to be necessary for the NSO Applet's purposes.
| Parameter | Type | Description |
|---|---|---|
| country | str | the account's country code |
| Type | Description |
|---|---|
| User_Info | an object with your returned user information |
Stores the following cookies: CloudFront-Key-Pair-Id, CloudFront-Policy, CloudFront-Signature.
They are returned in the Set-Cookie header of the response. NSOAppletAPI.getV1Cookies() only returns a Cookie object.
| Parameter | Type | Description |
|---|---|---|
| country | str | the account's country code |
| Type | Description |
|---|---|
| Cookie | an object that contains the expiry information |
Posts a login and receives a Login object with point-related data.
| Parameter | Type | Description |
|---|---|---|
| country | str | the account's country code |
| Type | Description |
|---|---|
| Login | an object that contains your Point_Wallet |
This route appears to have been removed in favor of /api/v2/classic_games
Gets the current titles available under NSO's emulation softwares.
| Parameter | Type | Description |
|---|---|---|
| statuses | str | correlates to statuses[] - commonly is published |
| country | str | the account's country code |
| Type | Description |
|---|---|
| list<Classic_Game> | a list of objects containing all NSO games available under NSO's emulation softwares |
Returns the current Gift Categories that are available.
| Parameter | Type | Description |
|---|---|---|
| country | str | the account's country code |
| Type | Description |
|---|---|
| list<Gift_Category> | a list of objects containing gift category information |
Returns the user's available Right Categories.
| Parameter | Type | Description |
|---|---|---|
| country | str | the account's country code |
| Type | Description |
|---|---|
| list<Right_Category> | a list of objects containing right category information |
An object with the following:
| Name | Type | Description |
|---|---|---|
| id | str | Your Nintendo Account ID |
| country | str | Your account's country code |
| birthday | str | Your account's birthday |
| banned | bool | Whether your account is banned or not |
| analytics_opted_in | bool | If you're opted in to submitting analytical data |
| is_region_quebec | bool | Whether your account is from Quebec -- required because of specific laws regarding rewards systems, I believe |
An object with the following:
| Name | Type | Description |
|---|---|---|
| expires | int | UNIX timestamp with cookie expiry date |
An object with the following:
| Name | Type | Description |
|---|---|---|
| received_points | list | A list with your received points -- I've only ever seen this empty |
| point_wallet | Point_Wallet | A list of your current points, as well as expirations |
An object with the following:
| Name | Type | Description |
|---|---|---|
| total_point | Total_Point | This object includes your total amount of platinum points |
| expirations | list<Expiration> | Your points alongside their expiration dates |
An object with the following:
| Name | Type | Description |
|---|---|---|
| platinum | int | Your total number of platinum points |
An object with the following:
| Name | Type | Description |
|---|---|---|
| expires_at | str | A date of when the points will expire |
| point | Point | The points that will expire |
An object with the following:
| Name | Type | Description |
|---|---|---|
| platinum | int | Total number of platinum points for a context |
An object with the following:
| Name | Type | Description |
|---|---|---|
| status | str | Seems to always be publishing |
| title_id | str | Title IDs for respective console |
| title_name | str | Name of the game |
| application_id | str | Matches an NSO console emulator title ID |
| application_type | str | Console type description |
| bundled_region | Bundled_Region | Includes special region information. Commonly, this is None |
| icon_url | str | Game's icon URL |
| publisher | str | Game's publisher |
| is_unknown_release_date | bool | Whether the release date is known or not |
| released_at | str | When game was initially released |
| published_at | str | When game was added to NSO |
An object with the following:
| Name | Type | Description |
|---|---|---|
| region | str | Region code (i.e. EUR, KR, etc) |
| languages | list | List of language codes. Can be None |
An object with the following:
| Name | Type | Description |
|---|---|---|
| id | str | The category ID |
| key | str | The category's key |
| name | str | The category's name |
| image_url | str | The category's image icon URL |
| description | str | The category's description info (often updated) |
| required_membership_type | str | The membership type required to access the category for rewards. Often 'membership' |
| supported_tags | list | The supported tags by the category (['character', 'background', 'frame']) |
| key_color | str | The HEX color code for the category's theme color |
| rating_info | Rating_Info | The rating information |
| gifts | list<Gift> | The gifts obtainable from this category |
An object with the following:
| Name | Type | Description |
|---|---|---|
| nsuid | int | The nsuId of the game |
| rating_system | Rating_System | The Rating System information -- i.e. US is ESRB |
| rating | Rating | The Rating information |
| content_descriptors | list<Content_Descriptor> | The Content Descriptor |
An object with the following:
| Name | Type | Description |
|---|---|---|
| id | int | Rating ID |
| name | Rating_System | Rater name -- i.e. 'ESRB' |
An object with the following:
| Name | Type | Description |
|---|---|---|
| id | int | The rating ID |
| name | str | The rating type ('E', 'E10+', etc) |
| age | int | The starting age |
| provisional | bool | Unfinished, temporary rating |
| image_url | str | Rating image URL |
An object with the following:
| Name | Type | Description |
|---|---|---|
| id | int | The content descriptor ID |
| name | str | The descriptor name (i.e. 'Comic Mischief') |
| type | str | Typically 'descriptor' |
| image_url | str | Is an image URL. Usually None |
An object with the following:
| Name | Type | Description |
|---|---|---|
| id | str | ID of Gift. Normally Gift_Category.key_%4d |
| name | str | Name of Gift. Can be None |
| tags | list | Type of gift. One of Gift_Category.supported_tags |
| meta | str | Can be None. Usually reserved for Animal Crossing characters with stringified JSON birthdays |
| created_at | str | Gift creation date |
| updated_at | str | Gift update date |
| reward | Reward | Reward object |
An object with the following:
| Name | Type | Description |
|---|---|---|
| id | str | ID of Reward |
| thumbnail_url | str | Reward image URL |
| point | Point | Points for purchase |
| begins_at | str | Time of Reward release date |
| ends_at | str | Time of Reward expiry date |
| reward_status | Reward_Status | Reward Status |
An object with the following:
| Name | Type | Description |
|---|---|---|
| user_id | str | The accessor's user ID |
| limited | bool | If the item is limited(?) |
An object with the following:
| Name | Type | Description |
|---|---|---|
| id | str | The category ID |
| key | str | The category's key |
| name | str | The category's name |
| image_url | str | The category's image icon URL |
| supported_tags | list | The supported tags by the category (['character', 'background', 'frame']) |
| rights | list<Right> | The rights obtainable from this category |
An object with the following:
| Name | Type | Description |
|---|---|---|
| id | str | UUID of Right |
| user_id | str | Your Nintendo Account ID |
| tags | list | Type of right. One of Right_Category.supported_tags |
| content_url | str | Same as thumbnail_url in Reward |
| created_at | str | Right creation date |
| updated_at | str | Right update date |
| gift | Gift | Gift object (gift.reward will always be empty) |
Show basic tutorial
Some quick documentation on getting the NSO webapplet in your browser (from information discovered by Samuel Elliot):https://accounts.nintendo.com/connect/1.0.0/authorize?client_id=f4e5f2f3e022208b&response_type=id_token&scope=openid&redirect_uri=nintendo://lhub.nx.sys&state=a
Get id_token from the above.
Go to https://lp1.nso.nintendo.net -- set your user agent to something like Mozilla/5.0 (Nintendo Switch; NsoApplet; Nintendo Switch) AppleWebKit/609.4 (KHTML, like Gecko) NF/6.0.2.22.5 NintendoBrowser/5.1.0.23519
Add breakpoints to the index's script at var n = navigator.userAgent.includes("NintendoBrowser"); and the static/js/main.1d72eb58.js at setNaAuthTokenAvailableCallback: function(e) {e(void 0, void 0, EP.b)},
Reload page and, on first breakpoint, paste the below
Object.defineProperty(navigator, 'userAgent', {get: () => 'no'})
Then resume and on second breakpoint, paste the below, replacing "id_token" with your id_token from before
e(undefined, undefined, 'id_token')
If you'd like a bunch of info dump, make a breakpoint anywhere with r.getState(), then run r.getState(); in the Console whenever it breaks there.