---
id: spotipyfree
version: "1.9.14"
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)
license_treatment: unclear
maintenance: active
---

# spotipyFree — A Spotipy-compatible wrapper using SpotAPI

License: unclear · Maintenance: active · Downloads: 76.0K/mo

## 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 above — 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

pip install spotipyfree
uv add spotipyfree
poetry add spotipyfree

## Installing 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_current
- Install friction: low
- Maintenance: active
- Downloads: 76.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

spotify api alternative, spotipy without premium, spotify search without credentials, spotify metadata scraper, drop-in spotipy replacement, spotify data without api key, spotify track lookup, spotify playlist metadata, spotify-client, music-metadata, api-wrapper

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