llms.txt
Compare with other sites' llms.txt files →# Sonovault
> Music metadata REST API for developers. ISRC, genre, release dates, BPM, musical key, and cross-platform IDs for 93M+ tracks.
Sonovault is a music metadata API that provides structured data for over 93 million tracks. It is designed for developers building catalog management systems, music discovery apps, sync and royalty platforms, and any workflow that needs accurate track-level metadata.
## What Sonovault Provides
- **Track metadata**: ISRC, duration, BPM, musical key, genre, subgenre, artist credits, label, release dates
- **BPM and musical key**: every track carries `bpm` (full tempo, up to two decimals: drum & bass reads 174, not 87) and its key in three notations: `key_alphanumeric` (`10B`), `key_musical` (`D`) and `key_open` (Open Key, `3d`), plus `keys[]` naming the source of each key. Measured from the audio by our own analysis: key by OpenKeyScan, tempo by the Lexicon DJ beat detector. `null` (and `keys: []`) when a track has not been analysed yet. No BPM/key filter parameters
- **Tracklists**: a release returns its tracks in playing order, with disc and track numbers
- **MusicBrainz IDs**: release and release-group MBIDs per release (arrays, one per edition), plus the artist MBID
- **Release editions**: a SonoVault release groups every edition of an album onto one record, so each one lists the real editions behind it (format, release date, track count, barcode, country, label, catalog number) from Spotify, Discogs and MusicBrainz. Ask for a specific edition to get that pressing's own disc and track numbering
- **ISWC (work codes)**: Resolve a recording to its composition code(s) via ISRC or track ID (`GET /v1/tracks/iswc`), or list every recording of a composition by ISWC (`GET /v1/tracks/iswc/:iswc`); one-to-many in both directions
- **Artist profiles**: country, formation date, social links, Wikidata ID, MusicBrainz artist MBID, plus paginated releases per artist
- **Label catalogs**: paginated releases and artists per label
- **Cross-platform links**: Resolve track IDs across Spotify, Apple Music, Beatport, Tidal, Discogs, MusicBrainz, and YouTube
- **Browse**: Discover tracks by filtering on label, artist, genre, and year; newest releases first by default, or pass `randomize=true` for random sampling (paid plans only)
- **New releases**: Paginated feed of latest releases sorted by artist popularity (paid plans only)
- **Search**: Fuzzy search for tracks, artists, releases, and labels
- **Bulk resolve**: Resolve up to 100 track names, ISRCs, or platform IDs per request to canonical tracks + cross-platform links (`POST /v1/tracks/resolve`), billed one credit per line
- **Audio recognition**: Identify a track from a raw audio upload (`POST /v1/tracks/identify`). Returns ranked catalog matches, each slim (`id`, `title`, `artists`, `confidence` 0–1); look up full metadata by id. 10 + ceil(MB) credits per upload (paid plans)
- **Stream monitoring**: Register a live radio/broadcast stream URL (`POST /v1/streams`) and get a continuous timestamped "now playing" log by polling (`GET /v1/streams/:id` for the current track, `GET /v1/streams/:id/history` for the log), plus an airplay/spin report over a date range with ISRC (`GET /v1/streams/report`, JSON). Billed €29 per active stream/month (paid plans)
- **Push delivery (webhooks + live feed)**: Instead of polling, have events pushed to you. Register a signed webhook (`POST /v1/webhooks`; HMAC-SHA256 `Sonovault-Signature`, retried with backoff, delivery log) for the confirmed log, delivered about 5 minutes after a play begins because a detection is settled before it is sent (one event per airing, none for a detection later discarded); or open a Server-Sent Events stream (`GET /v1/streams/live`) for the same events in real time, unsettled. Events: `stream.play.started`, `stream.offline`, `stream.online` (webhooks default to play.started; subscribe to the others via `event_types`). No reliable track-end signal yet. Bundled with stream monitoring (no API credits)
- **Genres**: Full canonical genre list (`GET /v1/genres`); paid users can suggest genre corrections on tracks, reviewed by the Sonovault team before they affect the catalog
## Key Facts
- Catalog: 93M+ tracks, growing daily
- Open catalog sources: Discogs, MusicBrainz (data dumps under each project's terms)
- Streaming and store platforms: Spotify, Apple Music, Tidal, Beatport, and YouTube are cross-referenced for track IDs, links, and some catalog fields (no audio, previews, or artwork)
- Audio analysis (our own): BPM and musical key are measured from the audio by Sonovault itself (OpenKeyScan for key, the Lexicon DJ beat detector for tempo), not aggregated from a platform
- Authentication: API key in x-api-key header
- Format: JSON REST API
- Base URL: https://api.sonovault.now/v1
- Free tier: 1,000 requests/month, no credit card required
- Paid plans: see https://sonovault.now/pricing
- One-time credit packs: 10,000 credits for EUR 9 or 50,000 for EUR 29, never expire, used after the monthly allowance
- Beta founding offer: new subscribers lock in 50% off any paid plan for life, applied automatically at checkout during the open beta
- Uptime: 99.9%
## Common Use Cases
- Catalog management and deduplication via ISRC
- Music library enrichment (genre, subgenre, label, release dates, BPM, musical key)
- DJ, playlist, radio-programming and fitness apps: harmonic mixing and tempo matching with BPM and key in alphanumeric, musical and Open Key notation
- Cross-platform track ID resolution (given a Spotify ID, find the Beatport/Apple Music/Tidal ID)
- Bulk resolution of track lists, ISRC lists, or platform-ID lists in a single request
- Audio recognition / track identification from an audio file
- Broadcast / radio monitoring: register a stream URL and track what's playing over time (airplay logging), then pull an airplay/spin report (ISRC) for any date range
- Push integrations: receive confirmed plays on your server via signed webhooks, or consume a live SSE feed for real-time now-playing, instead of polling
- ISRC lookup for music rights and royalty platforms
- ISWC work-code resolution for publishing and royalty workflows (recording ↔ composition mapping)
- Music discovery apps surfacing new releases by genre or label
- Crowd-sourced catalog corrections: paid users suggest better genres, reviewed before they go live
## Links
- Website: https://sonovault.now
- Official TypeScript/Node client (`npm install sonovault`): https://github.com/rekordcloud/sonovault-js
- Official Python client (`pip install sonovault`): https://github.com/rekordcloud/sonovault-python
- Music Metadata API (what a music metadata API returns: recording vs release vs work fields, why sources disagree, how to evaluate one): https://sonovault.now/music-metadata-api
- Key and BPM API (tempo and musical key for any track in three notations, how they are measured, harmonic mixing): https://sonovault.now/bpm-key-api
- Music Collection Societies (how PROs and neighbouring-rights societies differ, what stations report, links to each society guide): https://sonovault.now/collection-societies
- ISRC Code Lookup (free tool + plain-English guide): https://sonovault.now/isrc-lookup
- ISWC Lookup (free tool + plain-English guide): https://sonovault.now/iswc-lookup
- ISRC ⇄ ISWC Converter (free tool: recording ↔ composition crosswalk): https://sonovault.now/isrc-to-iswc
- ISRC Validator & Decoder (free tool: check an ISRC's format and decode its parts): https://sonovault.now/isrc-validator
- ISRC Registrant Codes (reference: how the registrant block works, common prefixes like USUM7/QZ/TC): https://sonovault.now/isrc-registrant-codes
- ISRC Code Generator explained (why generators don't exist and how real codes are assigned): https://sonovault.now/isrc-code-generator
- DistroKid ISWC (find the ISWC behind a distributed release, starting from its ISRC): https://sonovault.now/distrokid-iswc
- Bulk Lookup (free tool: resolve lists of tracks, ISRCs, or platform IDs to ISRC, platform IDs, genre, label, BPM and key; CSV export): https://sonovault.now/bulk-lookup
- Audio Recognition (identify tracks from audio: overview + code examples): https://sonovault.now/identify
- Build a Music Recognition App (for startups & builders: product ideas + how to add song recognition): https://sonovault.now/build-music-recognition
- Stream Monitoring / Radio Airplay Detection (live "now playing" recognition per stream, with webhooks: overview + code examples): https://sonovault.now/streams
- Radio Monitoring (what airplay monitoring gets you, plus a plain-language explanation of how the detection engine works): https://sonovault.now/radio-monitoring
- ACRCloud Alternative (where ACRCloud wins, where Sonovault wins, and how to pick between them): https://sonovault.now/compare/acrcloud
- Spotify API Alternative (every Spotify Web API restriction from 2024 to 2026, what still works, and what to use instead for metadata and IDs): https://sonovault.now/compare/spotify-api
- Apple Music API guide (developer tokens, ISRC/UPC lookups, storefronts, MusicKit terms, and mapping Apple Music IDs to other platforms): https://sonovault.now/apple-music-api
- TIDAL API guide (app registration, OAuth 2.1, ISRC/barcode filters, development mode, developer terms, and mapping TIDAL IDs): https://sonovault.now/tidal-api
- Beatport API guide (licensee-only v4 access, what it covers, and resolving Beatport track IDs across platforms): https://sonovault.now/beatport-api
- MCP Server (sonovault-mcp: 15 read-only tools for Claude, Cursor and other MCP clients, with setup per client): https://sonovault.now/mcp
- API Documentation: https://sonovault.now/docs
- API Documentation (Markdown, AI-friendly): https://sonovault.now/docs/markdown
- OpenAPI 3.1 specification: https://sonovault.now/openapi.json
- Pricing: https://sonovault.now/pricing
- Developer Resources: https://sonovault.now/resources
- Status: https://sonovault.now/status
- Data Sources & Attribution: https://sonovault.now/data-sources
- Full LLM context: https://sonovault.now/llms-full.txt