Skip to content

Services

Each service wraps a portion of the Spotify Web API. Services are exposed as attributes on the client instance.

Auto-generated API details

Each service page includes an auto-generated API section rendered from the async implementation, which is the canonical source for the SDK.

from spotify_sdk import SpotifyClient

with SpotifyClient(access_token="your-access-token") as client:
    album = client.albums.get("7ycBtnsMtyVbbwTfJwRjSP")
import asyncio
from spotify_sdk import AsyncSpotifyClient


async def main() -> None:
    async with AsyncSpotifyClient(access_token="your-access-token") as client:
        album = await client.albums.get("7ycBtnsMtyVbbwTfJwRjSP")


asyncio.run(main())

Service list

Service Description
Albums Album details, tracks, and saved albums
Audiobooks Audiobook details and chapter lookups
Chapters Single chapter lookups
Episodes Episode details and saved-episode lookups
Artists Artist profiles and album listings
Library Save, remove, and check items in the user's library
Player Playback state, queue, devices, and playback controls
Playlists Playlist details, items, and images
Search Catalog search across supported Spotify resource types
Shows Show details, episode lists, and saved shows
Tracks Track details and saved-track lookups
Users Current-user profile, top items, and followed artists