# SonoVault

> Music metadata REST API for developers. ISRC, genre, release dates, and cross-platform IDs for 90M+ tracks.

SonoVault is a music metadata API that provides structured data for over 90 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, genre, subgenre, artist credits, label, release dates
- **Artist profiles**: country, formation date, social links, Wikidata ID — 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
- **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: 90M+ tracks, growing daily
- Open catalog sources: Discogs, MusicBrainz (data dumps under each project's terms)
- Streaming platforms: track IDs only — Spotify, Apple Music, Tidal, Beatport (via official developer APIs)
- 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
- Uptime: 99.9%

## Common Use Cases

- Catalog management and deduplication via ISRC
- Music library enrichment (genre, subgenre, label, release dates)
- 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
- ISRC lookup for music rights and royalty platforms
- 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
- ISRC Code Lookup (free tool + plain-English guide): https://sonovault.now/isrc-lookup
- Bulk Lookup (free tool — resolve lists of tracks, ISRCs, or platform IDs): https://sonovault.now/bulk-lookup
- 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