The full documentation can be viewed here.
- 100% Code coverage
- Completely type annotated
- Completely async
- Scales up to (theoretically) unlimited requests per second (tested with 1000 simultaneous requests which lead to a 429)
- Customize the timeout, maximal simultaneous request
- Throws custom errors, so you can catch different errors easily + Token expiration + Rate limit violation + An invalid album id
- Gets rid of the client credential workflow if you provide spotify cookies
- Good for automated testing
- Offers a hook which gets called if the token expires, so you can automatically update the token
You need at least python3.6 to install the package
pip install async-spotifyFor more in depth examples take a look here or visit the documentation.
fromasync_spotifyimportSpotifyApiClientfromasync_spotify.authentificationimportSpotifyAuthorisationTokenfromasync_spotify.authentification.authorization_flowsimportAuthorizationCodeFlow# Create a auth_code_flow object and load the auth_code_flow from env variablesauth_flow=AuthorizationCodeFlow()
auth_flow.load_from_env()
# Create a new Api client and pass the auth_code_flowapi_client=SpotifyApiClient(auth_flow, hold_authentication=True)
# Get the auth token with your codecode: str="Your Spotify Code"auth_token: SpotifyAuthorisationToken=awaitapi_client.get_auth_token_with_code(code)
# Create a new clientawaitapi_client.create_new_client(request_limit=1500)
# Start making queries with the internally saved tokenalbum_tracks: dict=awaitapi_client.albums.get_tracks('03dlqdFWY9gwJxGl3AREVy')
# If you pass a valid auth_token this auth_token will be used for making the requestsalbum_tracks: dict=awaitapi_client.albums.get_tracks('03dlqdFWY9gwJxGl3AREVy', auth_token)
# Every argument mentioned by the Spotify API can be passed as kwarg. The client will figure out if your provided kwarg# should be added to the request body, or the urlawaitapi_client.player.play(context_uri="spotify:album:5ht7ItJgpBH7W6vJ5BqpPr", device_id="whatever_id")
# ^ ^# URL BODYSee here.