Metadata-Version: 2.4
Name: musiciwant
Version: 1.0.0
Summary: Independent music analysis API client — BPM, dynamic range, sensory intensity, moods, misophonia flags. A Spotify Audio Features alternative.
Author: Music I Want
License: MIT
Project-URL: Homepage, https://musiciwant.com/developers
Project-URL: Repository, https://github.com/musiciwant/musiciwant-api
Project-URL: Issues, https://github.com/musiciwant/musiciwant-api/issues
Keywords: music,bpm,tempo,audio-features,spotify-alternative,music-analysis,dynamic-range,misophonia,sensory,music-data
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# musiciwant (Python)

Tiny, dependency-free client for the [Music I Want API](https://musiciwant.com/developers) — independent sensory + musical analysis for ~19,000 songs. BPM, dynamic range, sudden changes, texture, vocal style, a 0–100 **intensity** score, moods, use-case fits, and **misophonia** flags no other public API carries.

An honest alternative to the data that disappeared when Spotify deprecated its Audio Features API.

## Install

```bash
pip install musiciwant
```

## Quickstart

```python
from musiciwant import MusicIWant

miw = MusicIWant()  # works key-less at 100 req/day/IP

song = miw.song(title="Black", artist="Pearl Jam")["song"]
print(song["bpm"], song["dynamic_range"], song["intensity"], song["sensory_level"])
# 75 7 47 moderate

results = miw.search("radiohead")["results"]
```

## A free key (2,000 requests/day)

```python
from musiciwant import MusicIWant, get_key

key = get_key("you@example.com")["key"]
miw = MusicIWant(api_key=key)
miw.usage()  # {'tier': 'free', 'remaining_today': 1999, ...}
```

Or set `MUSICIWANT_API_KEY` in your environment.

## Tiers

| Tier | Limit | How |
| --- | --- | --- |
| anonymous | 100 req/day/IP | nothing |
| free | 2,000 req/day | `get_key(email)` |
| pro | 100,000 req/day | $19/mo — see [docs](https://musiciwant.com/developers) |

Bulk dataset licensing for apps, platforms, and research: [musiciwant.com/developers](https://musiciwant.com/developers#data).

## License

MIT (client code). Song data © Music I Want, free to use with attribution; bulk/commercial use licensed separately.
