spotipyFree
A Spotipy-compatible wrapper using SpotAPI
What it is and what it does
SpotipyFree is a lightweight wrapper that mimics the Spotipy library interface but retrieves Spotify metadata without using Spotify's official API. It was created to work around Spotify's restriction of API access to non-premium users. The package does not require Spotify credentials or an account and returns data structured to match official Spotify API responses, making it a potential drop-in replacement for code written against Spotipy.
The package implements core search and metadata retrieval methods (search, track, artist, album, playlist lookups) as well as user-specific features like saved tracks and playback control when logged in. It also supports hosting a Flask-based web API endpoint. The project is marked experimental, with an active maintenance status but a limited and evolving feature set.
Use it for:
- Search Spotify tracks, artists, and playlists without owning a premium account or API credentials
- Retrieve track and album metadata for music information systems or recommendation tools
- Build a web service that proxies Spotify lookups through a Flask endpoint without official API access
- Migrate existing Spotipy code to work with non-premium Spotify access by swapping the import
- Fetch user's saved tracks and playback history after login without official API authentication
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
Provides a Spotipy-compatible interface to search and retrieve Spotify metadata without requiring official API credentials or a premium account.
Yes, with conditions. Install if you need Spotify metadata access without premium credentials and accept experimental status. The low install friction, active maintenance, and MIT license are favorable. However, verify that the spotapi and pymongo dependencies suit your environment, confirm the legal standing of non-API Spotify access in your use case, and be prepared for API changes as the project is explicitly experimental.
Install
spotipyfree on PyPI
pip
pip install spotipyfreeuv
uv add spotipyfreepoetry
poetry add spotipyfreeInstalling spotipyFree
Before you install
Low install friction with a pure Python wheel and only two runtime dependencies (spotapi and pymongo). Maintenance status is active with a recent release 12 days ago, though the project is marked experimental.
License in practice
Licensed under MIT (permissive), allowing free use, modification, and distribution with minimal restrictions. The license text is present but SPDX classification is unclear in the metadata.
Quickstart
pip install spotipyFree
from SpotipyFree import Spotify
sp = Spotify()
search = sp.search("Blinding Light - Weekend")
track = sp.track("67Hna13dNDkZvBpTXRIaOJ")
Requires Python 3.9 or later. Project is experimental; behavior and API surface may change.
Verify before relying
- Whether spotapi and pymongo dependencies are reliably maintained and compatible with current versions
- Stability and completeness of the Spotipy response format compatibility across all implemented methods
- Legal status of accessing Spotify data without official API (terms of service compliance)
- Performance and rate-limiting behavior when used at scale
Package facts
| License | Copyright (c) <2026> <Tzur Soffer> Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the… (full text in the JSON record) (unclear) |
| Python support | supports the current Python release (>=3.9) |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | 2 — spotapi, pymongo |
| Maintenance | actively maintained — 12 days since the last release |
| First released | |
| Downloads | 75,981/month — #14,661 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: spotipyfree-1.9.14-py3-none-any.whl
Tags
More Internet packages
Botocore provides low-level, data-driven access…
permissive · top 100 on PyPI
aiobotocoreProvides an async client for AWS services using…
permissive · top 100 on PyPI
pydanticPydantic validates Python data structures…
permissive · top 100 on PyPI
filelockProvides a platform-independent file locking…
permissive · top 100 on PyPI
fastapiFastAPI is a Python web framework for building…
permissive · top 100 on PyPI
googleapis-common-protosProvides common Protocol Buffer message…
permissive · top 100 on PyPI
soundcloud-v2A Python wrapper for SoundCloud's internal v2…
permissive · top 15,000 on PyPI
spotapiSpotAPI wraps Spotify's private and public APIs…
unclear · top 15,000 on PyPI
spotipySpotipy is a Python client library for the…
permissive · top 15,000 on PyPI
spotdlspotDL downloads songs from Spotify playlists…
permissive · top 15,000 on PyPI
spotifywebapipythonA Python library that wraps the Spotify Web…
permissive · top 15,000 on PyPI
youtube-search-pythonSearch YouTube for videos, channels, and…
permissive · top 15,000 on PyPI
pylibrespot-javaProvides a Python interface to communicate with…
permissive · top 15,000 on PyPI
tinytagReads metadata (artist, title, duration,…
permissive · top 5,000 on PyPI
shazamioAsynchronous Python library that recognizes…
permissive · top 15,000 on PyPI
ytmusicapiytmusicapi lets you programmatically interact…
permissive · top 15,000 on PyPI