# Spotify UPC Finder & API

**Use case:** 

Find the UPC (EAN) barcode of any Spotify album, single or EP from its link, or look up a UPC to get the matching Spotify release. Each row has the UPC, label, release date, popularity and the full track list with every track's ISRC and play count. Check a whole catalog in one run, or call it as an API from Python, JavaScript or cURL for distribution, royalty and metadata checks.

## Input

```json
{
  "startUrls": [
    "https://open.spotify.com/album/4yP0hdKOZPNshxUOjY0cZj",
    "https://open.spotify.com/album/3iPSVi54hsacKKl1xIR2eH"
  ],
  "searchType": "tracks",
  "maxResultsPerSearch": 50,
  "scrapeDetails": true,
  "maxItemsPerResult": 1000,
  "includeIsrc": true,
  "includeCredits": false,
  "includeDiscography": false,
  "compareWithPreviousRun": false,
  "minFollowers": 0,
  "maxFollowers": 0,
  "excludeSpotifyPlaylists": false
}
```

## Output

```json
{
  "type": {
    "label": "Type",
    "format": "text"
  },
  "imageUrl": {
    "label": "Image",
    "format": "image"
  },
  "name": {
    "label": "Name",
    "format": "text"
  },
  "artistName": {
    "label": "Artist",
    "format": "text"
  },
  "playCount": {
    "label": "Play count",
    "format": "number"
  },
  "monthlyListeners": {
    "label": "Monthly listeners",
    "format": "number"
  },
  "followers": {
    "label": "Followers",
    "format": "number"
  },
  "popularity": {
    "label": "Popularity",
    "format": "number"
  },
  "url": {
    "label": "Link",
    "format": "link"
  },
  "searchTerm": {
    "label": "Search term",
    "format": "text"
  }
}
```

## 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 UPC Finder & API". [Sign up or log in](https://console.apify.com/create-task-from-example/aSwwEBIZd5U3ci7oq) and you'll land in Apify Console with a copy of this exact task.

### 2. Start the "Spotify UPC Finder & 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 UPC Finder & 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 type, image, name, 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 UPC Finder & API" task via API](https://apify.com/epicscrapers/spotify-scraper.md).

## FAQ

### What is a UPC on Spotify?

The Universal Product Code is the barcode of a release: an album, single or EP. Distributors assign it, and Spotify stores it with every release. EAN codes (13 digits) work too.

### How do I find the UPC of a Spotify album?

Copy the album link in Spotify (Share, then Copy link), paste it into Spotify links and start the run. The upc field of the album row holds the barcode.

### Can I find a Spotify album by its UPC?

Yes. Paste the UPC as an input and the run returns the Spotify album with its link, label, release date and tracks. Leading zeros may differ; both forms work.

### Does it give the ISRC of every track on the album?

Yes. With ISRC, UPC and label on (as in this task), every track in the album's track list gets its ISRC, popularity and exact play count.

### Is this a general barcode lookup for products?

No. It finds UPCs of music releases on Spotify only. For shop products, use a product barcode database instead.

### Can I look up a whole catalog at once?

Yes. Paste hundreds of album links or UPCs, one per line. Each release is one row with its full track list, ready for a spreadsheet or database.

### Do I need a Spotify API key?

No. No developer app, OAuth or Spotify login is needed. You only need an Apify account; the free plan's monthly credit covers your first lookups.

### How much does it cost?

$0.004 per album plus $0.001 per UPC or ISRC found. A 12-track album with every track's ISRC costs $0.017. Releases that aren't found are free.

### Can I call it as an API?

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

### What other album data do I get?

Album type, artists, release date, label, copyright lines, track count, total play count and each track's name, number, duration and play count.

## 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`).