musiciwant (JavaScript / TypeScript)

Tiny, zero-dependency client for the Music I Want API — 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

npm install musiciwant

Quickstart

const { MusicIWant } = require('musiciwant');

const miw = new MusicIWant(); // works key-less at 100 req/day/IP

const { song } = await miw.song({ title: 'Black', artist: 'Pearl Jam' });
console.log(song.bpm, song.dynamic_range, song.intensity, song.sensory_level);
// 76 7 47 "moderate"

const { results } = await miw.search('radiohead');

A free key (2,000 requests/day)

const { key } = await MusicIWant.getKey('[email protected]');
const miw = new MusicIWant({ apiKey: key });
await miw.usage(); // { tier, requests_today, remaining_today, ... }

Or set MUSICIWANT_API_KEY in your environment and the client picks it up.

Tiers

| Tier | Limit | How | | --- | --- | --- | | anonymous | 100 req/day/IP | nothing | | free | 2,000 req/day | MusicIWant.getKey(email) | | pro | 100,000 req/day | $19/mo — see docs |

Bulk dataset licensing for apps, platforms, and research: musiciwant.com/developers.

License

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