Obtaining A Session Token¶

To use this package, you must first obtain a valid Nintendo session token. This requires a Nintendo Switch Online membership and does not require having played at least one online match in Splatoon 3. Neither the scraper module nor the query module currently provide any functionality for obtaining a session token, but the auth module provides the functions necessary to do so through the NSO class. The following example shows the first step in obtaining a session token, which is to obtain a login URL. Details of the login flow can be found in the Nintendo Switch Online Login Flow page.

from splatnet3_scraper.auth import NSO

nso = NSO.new_instance()
print(nso.generate_login_url())

The above code will print a very long URL to the console. Copy this URL and paste it into your browser. You will be redirected to a Nintendo login page. Enter your Nintendo Switch Online credentials and you will be redirected to a page that looks like this:

Right-click on the red “Select this account” button and select “Copy link address”. You may click the button if you wish, but it will not work as the URL begins with npf. With the copied URL in hand, you can now obtain a session token. Use the following code to do so:

copied_url = ...
session_token_code = nso.parse_npf_uri(copied_url)
session_token = nso.get_session_token(session_token_code)

The copied_url variable should be replaced with the URL you copied from the browser. The session_token_code variable will contain the code that is required to obtain the session token. The session_token variable will contain the session token itself, as a string. You can now use this session token to make requests to the Splatoon 3 API.