# Spotify SDK

## Docs

- [AsyncSpotifyClient](https://mintlify.wiki/jonathan343/spotify-sdk/api/async-spotify-client.md): Asynchronous client for interacting with the Spotify Web API
- [AccessToken Authentication](https://mintlify.wiki/jonathan343/spotify-sdk/api/auth/access-token.md): Direct access token authentication for the Spotify SDK
- [AuthorizationCode Authentication](https://mintlify.wiki/jonathan343/spotify-sdk/api/auth/authorization-code.md): OAuth authorization code flow with refresh tokens for user authentication
- [ClientCredentials Authentication](https://mintlify.wiki/jonathan343/spotify-sdk/api/auth/client-credentials.md): OAuth client credentials flow with automatic token refresh
- [Exceptions](https://mintlify.wiki/jonathan343/spotify-sdk/api/exceptions.md): Exception classes and error handling in the Spotify SDK
- [Album Models](https://mintlify.wiki/jonathan343/spotify-sdk/api/models/album.md): Pydantic models for Spotify album objects
- [Artist Models](https://mintlify.wiki/jonathan343/spotify-sdk/api/models/artist.md): Pydantic models for Spotify artist objects
- [Audiobook Models](https://mintlify.wiki/jonathan343/spotify-sdk/api/models/audiobook.md): Pydantic models for Spotify audiobook and chapter objects
- [Common Models](https://mintlify.wiki/jonathan343/spotify-sdk/api/models/common.md): Shared Pydantic models used across multiple Spotify API responses
- [Playlist Models](https://mintlify.wiki/jonathan343/spotify-sdk/api/models/playlist.md): Pydantic models for Spotify playlist objects
- [Show and Episode Models](https://mintlify.wiki/jonathan343/spotify-sdk/api/models/show.md): Pydantic models for Spotify show (podcast) and episode objects
- [Track Models](https://mintlify.wiki/jonathan343/spotify-sdk/api/models/track.md): Pydantic models for Spotify track objects
- [User Models](https://mintlify.wiki/jonathan343/spotify-sdk/api/models/user.md): Pydantic models for Spotify user objects
- [Albums Service](https://mintlify.wiki/jonathan343/spotify-sdk/api/services/albums.md): API reference for Spotify SDK album operations including retrieving albums, tracks, new releases, and managing saved albums
- [Artists Service](https://mintlify.wiki/jonathan343/spotify-sdk/api/services/artists.md): API reference for Spotify SDK artist operations including retrieving artist info, albums, and top tracks
- [Audiobooks Service](https://mintlify.wiki/jonathan343/spotify-sdk/api/services/audiobooks.md): API reference for Spotify SDK audiobook operations including retrieving audiobooks and chapters
- [Chapters Service](https://mintlify.wiki/jonathan343/spotify-sdk/api/services/chapters.md): API reference for Spotify SDK chapter operations for retrieving audiobook chapters
- [Episodes Service](https://mintlify.wiki/jonathan343/spotify-sdk/api/services/episodes.md): API reference for Spotify SDK episode operations including retrieving podcast episodes and managing saved episodes
- [Library Service](https://mintlify.wiki/jonathan343/spotify-sdk/api/services/library.md): API reference for Spotify SDK library operations for saving, removing, and checking items in the user's library
- [PlaylistService](https://mintlify.wiki/jonathan343/spotify-sdk/api/services/playlists.md): Complete API reference for managing Spotify playlists - create, modify, and manage playlist content
- [SearchService](https://mintlify.wiki/jonathan343/spotify-sdk/api/services/search.md): Complete API reference for searching Spotify's catalog of tracks, albums, artists, playlists, shows, episodes, and audiobooks
- [ShowService](https://mintlify.wiki/jonathan343/spotify-sdk/api/services/shows.md): Complete API reference for accessing Spotify shows (podcasts) and their episodes
- [TrackService](https://mintlify.wiki/jonathan343/spotify-sdk/api/services/tracks.md): Complete API reference for accessing Spotify track information and metadata
- [UserService](https://mintlify.wiki/jonathan343/spotify-sdk/api/services/users.md): Complete API reference for managing Spotify user profiles, follows, and personalized content
- [SpotifyClient](https://mintlify.wiki/jonathan343/spotify-sdk/api/spotify-client.md): Synchronous client for interacting with the Spotify Web API
- [Authentication](https://mintlify.wiki/jonathan343/spotify-sdk/concepts/authentication.md): Learn how to authenticate with the Spotify API using access tokens, client credentials, or authorization code flows
- [Clients](https://mintlify.wiki/jonathan343/spotify-sdk/concepts/clients.md): Understand the SpotifyClient and AsyncSpotifyClient classes, configuration options, and resource management
- [Error Handling](https://mintlify.wiki/jonathan343/spotify-sdk/concepts/error-handling.md): Learn about exception types, error hierarchy, and how to handle errors when using the Spotify SDK
- [Pagination](https://mintlify.wiki/jonathan343/spotify-sdk/concepts/pagination.md): Learn how to work with paginated responses from the Spotify API using limit, offset, and Page objects
- [Async Usage](https://mintlify.wiki/jonathan343/spotify-sdk/guides/async-usage.md): Complete guide to using AsyncSpotifyClient with async/await patterns for high-performance API interactions
- [Context Managers](https://mintlify.wiki/jonathan343/spotify-sdk/guides/context-managers.md): Using context managers with the Spotify SDK for automatic resource cleanup and best practices for both sync and async clients
- [Retries and Timeouts](https://mintlify.wiki/jonathan343/spotify-sdk/guides/retries-and-timeouts.md): Understanding automatic retry behavior, exponential backoff with jitter, and timeout configuration in the Spotify SDK
- [Installation](https://mintlify.wiki/jonathan343/spotify-sdk/installation.md): Install the Spotify SDK for Python and set up your development environment
- [Introduction](https://mintlify.wiki/jonathan343/spotify-sdk/introduction.md): A Python SDK for the Spotify Web API with full type safety, sync and async support, and automatic retry handling
- [Quickstart](https://mintlify.wiki/jonathan343/spotify-sdk/quickstart.md): Get started with the Spotify SDK in minutes by making your first API call

## OpenAPI Specs

- [openapi](https://mintlify.wiki/jonathan343/spotify-sdk/api-reference/openapi.json)