Skip to content

API Reference

This section documents the public SDK surface area. Sync and async implementations share the same service names and method signatures, so the reference is grouped by service with code tabs for the sync and async styles.

Sync and async docs together

The SDK is async-first internally, and the sync API is generated from it. To avoid duplicate pages and keep examples aligned, the reference keeps both variants on the same page using tabs. If a method ever diverges, the sync or async tab will call it out explicitly.

  • Clients


    Construction, lifecycle, and configuration for the main entry points.

    Clients

  • Auth


    Client credentials and auth provider utilities.

    Auth

  • Services


    Albums, artists, playlists, and tracks operations.

    Services

  • Models


    Pydantic models for Spotify API responses.

    Models