Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/jonathan343/spotify-sdk/llms.txt

Use this file to discover all available pages before exploring further.

The Spotify SDK for Python is available on PyPI and can be installed using standard Python package managers.

Requirements

Before installing, ensure you have a compatible Python version:
  • Python 3.10 or higher is required
  • Supported versions: 3.10, 3.11, 3.12, 3.13, 3.14
The SDK follows the official Python release cycle. All versions that have not reached end-of-life are supported.

Install with pip

1

Install the package

Run the following command in your terminal:
pip install spotify-sdk
This will install the SDK and all required dependencies:
  • httpx - HTTP client for making API requests
  • pydantic - Data validation and type hints
  • anyio - Async I/O abstraction
  • sniffio - Async library detection
2

Verify the installation

Check that the SDK is installed correctly:
import spotify_sdk
print(spotify_sdk.__version__)
You should see the installed version number (e.g., 0.9.1).

Install with uv

If you’re using uv, a fast Python package installer and resolver:
1

Add to your project

uv add spotify-sdk
This will add the SDK to your project’s dependencies and install it.
2

Verify the installation

import spotify_sdk
print(spotify_sdk.__version__)

Dependencies

The SDK has the following core dependencies, which are automatically installed:
PackageVersionPurpose
httpx≥0.28.1HTTP client for API requests
pydantic≥2.12.5Data validation and models
anyio≥4.12.1Async I/O support
sniffio≥1.3.1Async library detection
There are no optional dependencies. All required packages are installed automatically.

Development installation

If you want to contribute to the SDK or run it from source:
1

Clone the repository

git clone https://github.com/jonathan343/spotify-sdk.git
cd spotify-sdk
2

Install with uv

uv sync
This installs the SDK in editable mode with all development dependencies.
3

Run tests

uv run pytest

Next steps

Now that you have the SDK installed, you’re ready to start building:

Quickstart

Learn how to authenticate and make your first API call

Build docs developers (and LLMs) love