---
id: spotifyaio
version: "2.0.2"
license: MIT
license_treatment: permissive
maintenance: active
---

# spotifyaio — Asynchronous Python client for Spotify.

License: permissive · Maintenance: active · Downloads: 94.0K/mo

## What it is and what it does

spotifyaio is an async Python wrapper around Spotify's API, built on aiohttp for non-blocking I/O. It lets you query Spotify data—tracks, artists, playlists, and more—using Python's async/await syntax, making it suitable for concurrent applications, bots, and services that need to fetch Spotify metadata without blocking. The package depends on aiohttp for HTTP requests, mashumaro and orjson for efficient serialization, and yarl for URL handling.

The library targets Python 3.13+ and is actively maintained. It uses semantic versioning and publishes releases via GitHub. The MIT license places no restrictions on commercial or private use. With low install friction and no known vulnerabilities, it's a straightforward choice for developers building async Spotify integrations.

Use it for:

- Build a Discord bot or Telegram bot that queries Spotify for track info, artist details, or playlist data asynchronously.
- Create a web service that aggregates Spotify metadata for multiple users concurrently without blocking.
- Fetch Spotify data in a background task or scheduled job within an async application.
- Integrate Spotify search and recommendation endpoints into an async music recommendation engine.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Asynchronous Python client for fetching data from Spotify's API using modern async/await patterns.

Yes. The package is actively maintained, has no known vulnerabilities, uses a permissive MIT license, and requires only common async dependencies. Install friction is low and Python 3.13+ support is current. Install it if you need to query Spotify's API from async Python code; the only gotcha is the Python 3.13+ requirement.

## Install

pip install spotifyaio
uv add spotifyaio
poetry add spotifyaio

## Installing spotifyaio

Before you install: Low install friction with a pure-Python wheel distribution. Actively maintained as of 2026-08-13 with recent releases; requires Python 3.13 or later.

License in practice: MIT license is permissive; you can use, modify, and distribute this package freely with minimal restrictions, provided you retain the license notice.

Quickstart:

pip install spotifyaio

import asyncio
from spotifyaio import SpotifyClient

async def main():
    async with SpotifyClient(token='your_token') as client:
        data = await client.get_track('track_id')

asyncio.run(main())

Requires Python 3.13 or later; you must provide valid Spotify API credentials (token or client ID/secret).

Verify before relying:

- Exact API endpoints and methods available in version 2.0.2 are not detailed in the fact sheet.
- Whether the package handles Spotify authentication flows (OAuth, client credentials) or requires pre-obtained tokens.
- Rate limiting and error handling behavior for Spotify API responses.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 94.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

spotify api client async, async spotify data fetching, python spotify aiohttp, spotify api wrapper async, spotify client library python, async-http, music-api

[View on SkillFed](https://skillfed.io/packages/spotifyaio) · [View on PyPI](https://pypi.org/project/spotifyaio/)