Repository navigation
SpotAPI 2.1.0
SpotAPI 2.1 makes the async rewrite immediately usable from the terminal as well as Python.
python -m pip install "spotapi[demo]"
spotapi discover "Daft Punk"Requires Python 3.11+. No API key, login or config for public data.
Highlights
- Packaged Discover TUI and optional desktop Studio
- Typed artist discovery, concerts, captions, media assets and image palettes
SyncCataloguefor synchronous applications- Optional browser login, keyring-backed sessions and read-only MCP integration
- JSON-safe models, partial-failure batches and anonymous response caching
- More reliable player acknowledgements, disconnect handling and playback restoration
- Corrected migration documentation based on the actual synchronous 1.2.8 release
Upgrading from 1.x
SpotAPI 2 is a breaking async release. Synchronous projects can pin spotapi==1.2.8 or move to SyncCatalogue. See the migration guide.
For the story behind the rewrite: I wrote a Python library at 16. Here are 5 things I'd fix in the async rewrite