Beta founding offer: lock in 50% off any plan for life, before the beta ends. Claim founding pricing →
ISRC API

ISRC lookup
& reverse search

Developer reference: query track metadata by ISRC code, or find the ISRC for any track by artist and title.

Not a developer? Use the free ISRC lookup tool. No code required.

Look up by ISRC

Enter an ISRC code to get full track metadata including genres, release dates, and platform links.

curl
curl https://api.sonovault.now/v1/tracks/isrc/GBDUW0000053 \
  -H "x-api-key: YOUR_API_KEY"
View API docs →
Find ISRC by track

Search by artist and title to find the ISRC code for any track in the database.

curl
curl https://api.sonovault.now/v1/tracks/search \
  -H "x-api-key: YOUR_API_KEY" \
  -G   -d "artist=Daft Punk" \
  -d "title=One More Time"
Overview

ISRC lookup, both directions

The ISRC (International Standard Recording Code) is the recording industry's 12-character serial number for a single master: a two-letter country code, a three-character registrant, a two-digit year, and a five-digit designation. SonoVault resolves it both ways.

Have the code? GET /v1/tracks/isrc/:isrc is an exact path lookup that returns the full recording. Have the track but not the code? The reverse direction searches on artist + title, a fuzzy match built for real-world metadata, so DJ-pool tags, feature credits, and casing or diacritic noise still resolve to the right recording and its ISRC. Need to process a whole list? One call handles up to 100 at a time.

Response

What you get back

Every ISRC lookup returns the public track shape: factual recording metadata, reconciled across sources. Audio features (BPM, key, popularity), previews, artwork, and lyrics are deliberately not part of it.

titleThe recording's title.
artists[]Every credited artist, each flagged is_primary / is_remixer.
releases[]The releases it appears on: title, artist, label, and release_date.
isrcA representative ISRC for the recording.
durationLength in seconds.
genre[] · subgenre[]Normalised genre and subgenre tags.

Cross-platform IDs for all six sources come from a companion call, GET /v1/tracks/links, which resolves an ISRC (or any platform ID) to every other platform's ID and URL.

Reference

ISRC endpoints at a glance

WhatRequestReturns
Look up by ISRCGET /v1/tracks/isrc/:isrcFull track metadata for the recording with that ISRC.
Find ISRC by trackGET /v1/tracks/search?artist=&title=Matching recordings, each with its ISRC. Fuzzy-matched on artist + title.
Resolve many at oncePOST /v1/tracks/resolveUp to 100 ISRCs (or names / platform IDs) → canonical tracks plus links.
Cross-platform linksGET /v1/tracks/links?isrc=Every known platform ID and URL for the recording, in one call.
Recipes

What developers build with it

Resolve an ISRC across six platforms

One ISRC → its Spotify, Apple Music, Tidal, Beatport, Discogs, and MusicBrainz IDs in a single call.

Read the guide →
Dedupe a messy library by ISRC

Collapse duplicate rows from different sources onto one canonical recording using the ISRC as the key.

Read the guide →
Backfill cross-platform IDs

Walk an existing catalog and fill in the platform IDs each track is missing, keyed on ISRC.

Read the guide →
Notes & limits

Good to know

One key, no OAuth

Authenticate every /v1/* request with a single x-api-key header: no token refresh, no approval queue.

Free tier included

ISRC lookup and platform links are available on the free tier (1,000 requests/month).

Many ISRCs per recording

A canonical track can carry several ISRCs; every edit, remaster, and reissue mints its own. The endpoint returns a representative ISRC, and resolves any of a track's ISRCs to the same record.

Aggregated, not authoritative

Metadata is merged from third-party sources and can be incomplete or wrong. Verify before any commercial, financial, or legal use.

Official SDKs

Client libraries for Node/TypeScript (npm sonovault) and Python (PyPI sonovault), plus an MCP server for AI agents.

FAQ

Frequently asked questions

Yes. ISRC lookup and cross-platform platform links are both included on the free tier, which allows 1,000 requests per month with no card required. Higher-volume tiers unlock the same endpoints at larger request limits plus paid features like charts, browse, and audio recognition.
Often many. Labels mint a fresh ISRC for every commercial variant (the radio edit, extended mix, remaster, reissue, and regional release each get their own), and SonoVault retains all of them on one canonical track. The /v1/tracks/isrc/:isrc endpoint returns a single representative ISRC, and looking up any of a track's ISRCs resolves to the same record.
Use POST /v1/tracks/resolve with input_type set to isrc and up to 100 codes in the items array. Each line resolves to a canonical track plus its cross-platform links, and the response returns partial results rather than failing if you run out of credits mid-batch.
Cross-platform IDs for all six sources, a canonical release date drawn from Discogs/MusicBrainz rather than 'first available on Spotify', the record label, and normalised genre and subgenre. The public track shape does not include audio features (BPM, key, popularity) or previews, artwork, or lyrics.
Yes: sonovault on npm (Node/TypeScript) and sonovault on PyPI (Python), plus sonovault-mcp, an MCP server that exposes the same lookups to AI agents. All three mirror the /v1 endpoint surface and are open source.
Related

Keep exploring

Free ISRC lookup toolISRC ⇄ ISWC converterISRC validatorISWC (composition codes)Cross-platform linksFull API docs