Welcome to the online documentation of Tekore! We provide a client for the Spotify Web API for Python, complete with all available endpoints and authentication methods, async support and loads of additional features. Tekore allows you to interact with the API effortlessly. Here’s five lines to get you full access and start playing your top songs.

from tekore import Spotify, util, scope

cred = (client_id, client_secret, redirect_uri)
token = util.prompt_for_user_token(*cred, scope=scope.every)

spotify = Spotify(token)
tracks = spotify.current_user_top_tracks(limit=10)
spotify.playback_start_tracks([t.id for t in tracks.items])

See our homepage on PyPI for more information about the package and its versions. If you’ve found a bug or would like to propose a feature, please submit an issue on GitHub. Join our Discord community to ask for help or discuss just about anything related to Tekore.

If you’re new here, have a look at Getting started. After your first calls to the API you might want to look at Advanced usage. More ellaborate example scripts can be found in Examples. Detailed information can be found in our concise Reference.

Features

The Web API provides access to a plethora of data on music and users. Tekore implements these most integral features completely.

• tekore.auth: authentication for application and user tokens, self-refreshing tokens

• tekore.client: endpoints for access to every resource in the API. Responses are parsed into models with explicit attributes to ease examining the contents of a response.

Additional features and various convenience modules are provided too.

• tekore.util

  • Command line prompt for user autentication

  • Read and write configuration from files and environment variables

• tekore.sender

  • Async support

  • Session persistence

  • Request retries

  • Response caching

• tekore.convert ID, URI and URL conversions

• tekore.scope Access right scopes for user tokens

• tekore.serialise Additional response model features

  • Readable repr

  • JSON serialisation & dictionary conversion

  • Pretty-printing