Skip to the content
Get an API key
  1. API reference
  2. Search and match the catalog

Look up an ISRC

GET/public/isrc/{isrc}
CoreAuthBasicTokenDevTokenDocsSession

Finds the track of one ISRC on each store that can search by ISRC: Spotify, Apple Music, Deezer, Amazon Music and Boomplay. Needs no connected user. The stores run in parallel, and each store has its own timeout, so one slow store does not hold the answer. Each store answers on its own: found with the track, notFound, or error. Only a track with the same ISRC counts. A found track is cached for a day and a miss for an hour; ask again later for a release that is not out yet. Each store you ask counts as one request on your usage.

Path parameters

isrc
stringrequired

The ISRC: 12 characters. Dashes, spaces and lower case are accepted (us-rc1-76-07839).

Query parameters

sources
string

The stores to ask, comma-separated: spotify, appleMusic, deezer, amazonMusic, boomplay. Leave it out to ask every store.

Response

200application/json · IsrcLookupResponseok
isrc
string
requiredThe ISRC, in its normal form.
results
object
requiredOne entry for each store asked, keyed by the store.
Example answer
{
  "isrc": "USRC17607839",
  "results": {
    "deezer": {
      "status": "found",
      "track": {
        "externalId": "2451377",
        "url": "https://www.deezer.com/track/2451377",
        "name": "Crazy Eyes",
        "artistNames": [
          "Daryl Hall & John Oates"
        ],
        "albumName": "Bigger Than Both Of Us",
        "albumId": "241202",
        "duration": 187000,
        "isrc": "USRC17607839",
        "imageUrl": null
      }
    },
    "boomplay": {
      "status": "notFound",
      "track": null
    }
  }
}

Errors

400

The ISRC is not a 12-character ISRC, or sources names a store that is not on the list.

401

No valid credential.

429

Your account sent more calls this minute than its rate limit allows.