¶

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.

import tekore as tk

conf = (client_id, client_secret, redirect_uri)
token = tk.prompt_for_user_token(*conf, scope=tk.scope.every)

spotify = tk.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. You can also ask a question on Stack Overflow.

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.

Warning

Tekore 2 has been released! It brings major improvements to the library. See Release notes for more information.

Features¶

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

Authorisation for applications and users.
Endpoints for access to every resource in the API.

Additional features are provided for your pleasure and convenience.

Support for asynchronous programming using async/await.
A self-refreshing access token.
Responses are parsed into models with explicit attributes. They have a readable repr and can be serialised back to JSON.
Senders, a hook between Tekore and the Web API. Enables retries on failed requests, response caching and session persistence.
Access rights for user tokens.
Conversions between Spotify IDs, URIs and URLs.
Read and write configuration from files and environment variables.