# Spotify ISRC Finder & Lookup API

**Use case:** 

Find the ISRC code of any Spotify track from its link, URI or ID, or look up an ISRC to get the matching Spotify track. Each row has the ISRC, label, release date, popularity (0-100), exact play count and artists. Paste thousands of links in one run or call it as an API from Python, JavaScript or cURL to check a catalog, match royalty statements or fix metadata. Export to CSV, Excel or JSON.

## Input

```json
{
  "startUrls": [
    "https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b",
    "https://open.spotify.com/track/2qSkIjg1o9h3YT9RAgYN75",
    "USUM72404101"
  ],
  "searchType": "tracks",
  "maxResultsPerSearch": 50,
  "scrapeDetails": true,
  "maxItemsPerResult": 1000,
  "includeIsrc": true,
  "includeCredits": false,
  "includeDiscography": false,
  "compareWithPreviousRun": false,
  "minFollowers": 0,
  "maxFollowers": 0,
  "excludeSpotifyPlaylists": false
}
```

## Output

```json
{
  "imageUrl": {
    "label": "Cover",
    "format": "image"
  },
  "name": {
    "label": "Track",
    "format": "text"
  },
  "artistName": {
    "label": "Artist",
    "format": "text"
  },
  "playCount": {
    "label": "Play count",
    "format": "number"
  },
  "popularity": {
    "label": "Popularity",
    "format": "number"
  },
  "isrc": {
    "label": "ISRC",
    "format": "text"
  },
  "albumName": {
    "label": "Album",
    "format": "text"
  },
  "releaseDate": {
    "label": "Released",
    "format": "text"
  },
  "label": {
    "label": "Label",
    "format": "text"
  },
  "songwriters": {
    "label": "Songwriters",
    "format": "text"
  },
  "producers": {
    "label": "Producers",
    "format": "text"
  },
  "url": {
    "label": "Link",
    "format": "link"
  }
}
```

## How it works

### 1. Sign up on Apify or log in

The Spotify Scraper: Artists, Tracks, Playlists, Podcasts Actor is ready to run with the inputs already set for "Spotify ISRC Finder & Lookup API". [Sign up or log in](https://console.apify.com/create-task-from-example/df1xZVhd6jbWFP9e9) and you'll land in Apify Console with a copy of this exact task.

### 2. Start the "Spotify ISRC Finder & Lookup API" task

The Spotify Scraper: Artists, Tracks, Playlists, Podcasts Actor will start running based on the input automatically. You can also change all the input fields, like spotify links, ids, isrcs or upcs, search for, and more, to match your specific use case.

### 3. Receive the "Spotify ISRC Finder & Lookup API" output

Monitor the progress in real time. You will be notified as soon as your dataset is complete and ready for review. Each result includes data such as cover, track, artist, and more.

### 4. Integrate into your workflow

The final output is delivered in JSON, CSV, or Excel format, ready to be plugged into your workflow. You can also [run the "Spotify ISRC Finder & Lookup API" task via API](https://apify.com/epicscrapers/spotify-scraper.md).

## FAQ

### What is an ISRC code?

The International Standard Recording Code is a 12-character ID for one recording, such as USUG11904206. Labels and distributors use it to report streams and pay royalties.

### How do I find the ISRC of a Spotify song?

Copy the song link in Spotify (Share, then Copy link), paste it into Spotify links and start the run. The isrc column of each row holds the code.

### Can I look up a Spotify track by its ISRC?

Yes. Paste the ISRC itself as an input. The run returns the matching Spotify track with its link, artists, album, label and play count. Codes Spotify doesn't have are skipped and free.

### Can I look up thousands of ISRCs at once?

Yes. Paste them one per line or send them as a list through the API. Up to 10 are read at the same time, so a few thousand codes take minutes, not hours.

### What if one ISRC matches several Spotify releases?

A recording can be on a single and an album. The run returns the most-played Spotify release of that exact ISRC.

### What else does each row include?

Track name, artists, album, album type, release date, label, popularity (0-100), exact play count, duration, explicit flag, track and disc number, and the Spotify link.

### Do I need a Spotify developer account or API key?

No. There is no developer app, OAuth or Spotify login. You only need an Apify account; the free plan's monthly credit covers hundreds of lookups.

### How much does an ISRC lookup cost?

$0.004 per track plus $0.001 for the ISRC, so $5 per 1,000 tracks. There is no start fee, and links or codes that aren't found are free.

### Can I call it as an API from my code?

Yes. Use the Apify API or the Python and JavaScript clients with the actor epicscrapers/spotify-scraper and the same input. Results come back as JSON.

### Can I also get songwriter and producer credits?

Yes. Turn on Track credits to add songwriters, producers and the full credits list to every track, for $0.002 more per track.

## About this Actor

This example demonstrates how to use [Spotify Scraper: Artists, Tracks, Playlists, Podcasts](https://apify.com/epicscrapers/spotify-scraper.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/epicscrapers/spotify-scraper.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

This Task's input is already configured above. Use it as-is rather than inventing a new one.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/epicscrapers/spotify-scraper.md

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).