skillfed

spotipyFree

A Spotipy-compatible wrapper using SpotAPI

spotipyfree v1.9.14 76.0K downloads/30d#14,661 on PyPI
License unclear 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) Active released

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 spotipyfree

uv

uv add spotipyfree

poetry

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 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

spotify api alternativespotipy without premiumspotify search without credentialsspotify metadata scraperdrop-in spotipy replacementspotify data without api keyspotify track lookupspotify playlist metadata
spotify-clientmusic-metadataapi-wrapper

More Internet packages