# Shazam Song Recognition & Charts - Audio, Video, ISRC (`clearpath/shazam-scraper`) Actor

Identify songs in audio and video files like the Shazam app, even every song in a DJ set with start and end times. ISRC, label, UPC, composer, audio quality and streaming links. Plus Shazam charts for 70 countries and 175 cities, ISRC and song lookup, artists and search. No login needed.

- **URL**: https://apify.com/clearpath/shazam-scraper.md
- **Developed by:** [ClearPath](https://apify.com/clearpath) (community)
- **Categories:** Videos, Social media
- **Features:** Limited permissions
- **Stats:** 15 total users, 14 monthly users, 98.1% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.39 / 1,000 recognized songs

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

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 examples already wired to this Actor's own input schema, see the [API](#api) section below.

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

# README

[![5,200 Shazam chart results. Under 90 seconds. Rankings, artists, albums and release details.](https://api.apify.com/v2/key-value-stores/rfpznBPgVbyLYqNaQ/records/shazam-charts-ff0ff779bd17.png)](https://console.apify.com/actors/WJgyBULr4R5W0pjFq/input)

From **Clearpath**.

### Shazam rankings with the song details included

- **Thousands of chart results in seconds.** A full-detail export returned 5,200 chart entries in 88.7 seconds. Timing varies with the charts and settings you choose.
- **Rankings and music data together.** Get the chart position, title, artist and album, plus ISRC, record label, release date and artwork where available. Full song details are included in the result price.
- **Choose the charts that matter.** Collect global and country Top 200 charts, explore genres and cities, or follow Discovery charts. Combine chart selections in one run and export as JSON, CSV or Excel.

<a href="https://console.apify.com/actors/WJgyBULr4R5W0pjFq/input" data-demo-cta="true"><img src="https://api.apify.com/v2/key-value-stores/rfpznBPgVbyLYqNaQ/records/shazam-charts-0365021ae2ad.svg" width="252" height="48" alt="Get Shazam charts with song details"></a>

#### Try the global top 20

Open the [input page](https://console.apify.com/actors/WJgyBULr4R5W0pjFq/input), switch to JSON and paste:

```json
{
  "chartTypes": [
    "top"
  ],
  "chartCountries": [
    "world"
  ],
  "maxItemsPerChart": 20,
  "includeCatalogDetails": true
}
```

Change `world` to a country code such as `US`, `GB` or `BR`, or add more countries. Remove `maxItemsPerChart` for complete charts. Each chart position is one result, so a song can appear in several charts. [Current pricing](https://apify.com/clearpath/shazam-scraper/pricing) applies.

The hero shows example ranks and artwork from a saved worldwide chart export. Rankings change as the charts update. The speed figure applies to chart exports with full song details enabled.

#### Turn recordings into song lists

The same actor also identifies songs in audio and video files. Use direct media-file links and enable `findAllSongs` for recordings with multiple songs. Get song titles, artists, ISRCs and match timestamps. Recognition is billed per identified song at its own rate. See the [audio and video setup](#how-to-identify-songs-in-audio-and-video-files).

#### Copy to your AI assistant

```text
Help me use clearpath/shazam-scraper on Apify. Read https://apify.com/clearpath/shazam-scraper.md for documentation, input schema, pricing and limits. audioUrls takes direct links to audio or video files, not YouTube, TikTok or Spotify page links; findAllSongs returns every song in a long recording and bills each one; maxResults caps billed rows across all inputs. Choose settings for my requested outcome. If you cannot retrieve the page, ask me to paste the relevant sections. To reach the maintainers, add feedback="<what you needed and did not get>" to any run, including one that worked: feature requests, a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. The run returns its data exactly as it would without the note, and a human reads every note.
```

### What can this Shazam scraper do?

One actor, five kinds of results. Mix them in a single run; every row says what it is in `resultType`.

| You give it | You get | `resultType` |
|---|---|---|
| Links to audio or video files | The song in each file, or every song with `findAllSongs` | `recognized_song` |
| Chart types and countries | Shazam Top 200, genre, city and Discovery charts with ranks | `chart_song` |
| Shazam keys, song links or ISRC codes | The full song record; an ISRC returns every release that carries it | `song` |
| Artist ids or links | Bio, origin, genres, top songs, albums, singles, similar artists | `artist` |
| Search terms | Matching songs in order, up to 500 per term | `search_song` |

### What data do you get for each song?

Every recognized, chart, looked-up and search song has the same song fields. Values that do not exist for a song come back as `null`, never invented. Recognized songs and songs looked up by Shazam key carry everything below; chart and search songs, and songs looked up by link or ISRC, leave the Shazam-only fields empty (`shazamKey`, `colors`, `artistImageUrl`, `share`, the iTunes, Spotify and Deezer links).

- **The song:** title, artist, album, album artist, Shazam key, Apple Music id, ISRC, genre and all genres, record label, release year and exact release date, duration, explicit flag and content rating.
- **Credits and release:** composer line plus each composer with id and link (`composers`), track and disc number, every artist on the song with their ids and links, artist page, and `albumDetails`: album UPC, record label, copyright line, release date, track count, single and compilation flags, the album's audio quality, album artwork and editorial notes.
- **Audio quality:** `audioTraits` such as Dolby Atmos, Spatial audio, Lossless and Hi-Res Lossless, Apple Digital Master, audio language, whether lyrics and time-synced lyrics exist, and whether Apple Music Sing can lower the vocals (`isVocalAttenuationAllowed`).
- **Artwork and colours:** cover art at 400 px, 1000 px and full resolution (often 3000 px), artist image, the artwork's five main colours as hex values.
- **Links:** Shazam page, Apple Music, iTunes, 30-second preview audio, Spotify and Deezer search links, a YouTube Music link when one exists, Shazam share texts, and music videos with ISRC, release date, 4K and HDR flags, artwork and preview clips.
- **Recognition details** (recognized songs only): where in the song the clip plays (`offsetInSongSeconds`), where in your file the song was heard (`startInFileSeconds`, `endInFileSeconds`), the file's length and size, every listening attempt, every match with its time and frequency skew, and `partialFile` when only the first part of a large file was read. With `findAllSongs`: `songNumberInFile`, `windowsChecked` and `windowsFailed`.
- **Details flag:** `detailsIncluded` is true when the full song details were added. It is false when `includeCatalogDetails` is off or the details could not be loaded for that song; the basic song fields are still there.

Chart rows add rank, chart name, type, country, city or genre and chart size. Search rows add the search term and position. Artist rows have their own fields, shown further down.

#### Real output: one recognized song

This is the row from the example input above, unchanged except that the album's editorial notes are cut to their first paragraph. The full row carries the complete text.

```json
{
  "resultType": "recognized_song",
  "status": "recognized",
  "inputUrl": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview221/v4/47/10/0e/47100e1b-b0db-71fa-2f39-696e426fbb89/mzaf_13973670849236078346.plus.aac.ep.m4a",
  "shazamKey": "11243053",
  "appleMusicId": "528437020",
  "isrc": "USWB11201125",
  "title": "Somewhere I Belong",
  "artist": "LINKIN PARK",
  "album": "Meteora",
  "albumAppleMusicId": "528435845",
  "albumArtistName": "LINKIN PARK",
  "genre": "Hard Rock",
  "genres": [
    "Hard Rock",
    "Rock",
    "Alternative",
    "Metal"
  ],
  "label": "Warner Records",
  "releaseYear": 2003,
  "releaseDate": "2003-02-24",
  "durationMs": 214074,
  "durationText": "3:34",
  "explicit": false,
  "contentRating": null,
  "contentRatingLabel": "Not rated",
  "composer": "Brad Delson, Chester Bennington, Dave Farrell, Joe Hahn, Mike Shinoda & Rob Bourdon",
  "trackNumber": 3,
  "discNumber": 1,
  "audioLocale": "en-US",
  "audioTraits": [
    "hi-res-lossless",
    "lossless",
    "lossy-stereo"
  ],
  "audioTraitLabels": [
    "Hi-Res Lossless",
    "Lossless",
    "Standard stereo"
  ],
  "hasLyrics": true,
  "hasTimeSyncedLyrics": true,
  "isAppleDigitalMaster": true,
  "isMasteredForItunes": true,
  "isVocalAttenuationAllowed": true,
  "artists": [
    {
      "name": "LINKIN PARK",
      "appleMusicId": "148662",
      "shazamArtistId": null,
      "url": "https://music.apple.com/us/artist/linkin-park/148662"
    }
  ],
  "artistUrl": "https://music.apple.com/us/artist/linkin-park/148662",
  "composers": [
    {
      "name": "Brad Delson",
      "appleMusicId": "256399647",
      "url": "https://music.apple.com/us/artist/brad-delson/256399647"
    },
    {
      "name": "Chester Bennington",
      "appleMusicId": "799055",
      "url": "https://music.apple.com/us/artist/chester-bennington/799055"
    },
    {
      "name": "Dave Farrell",
      "appleMusicId": "41334100",
      "url": "https://music.apple.com/us/artist/dave-farrell/41334100"
    },
    {
      "name": "Joe Hahn",
      "appleMusicId": "325096253",
      "url": "https://music.apple.com/us/artist/joe-hahn/325096253"
    },
    {
      "name": "Mike Shinoda",
      "appleMusicId": "41334108",
      "url": "https://music.apple.com/us/artist/mike-shinoda/41334108"
    },
    {
      "name": "Rob Bourdon",
      "appleMusicId": "256399673",
      "url": "https://music.apple.com/us/artist/rob-bourdon/256399673"
    }
  ],
  "coverArtUrl": "https://is1-ssl.mzstatic.com/image/thumb/Features125/v4/dd/7d/72/dd7d7259-d27f-5b3e-ce64-9e304d2cb40f/dj.rxzrauer.jpg/400x400cc.jpg",
  "coverArtHqUrl": "https://is1-ssl.mzstatic.com/image/thumb/Features125/v4/dd/7d/72/dd7d7259-d27f-5b3e-ce64-9e304d2cb40f/dj.rxzrauer.jpg/1000x1000cc.jpg",
  "artworkMaxUrl": "https://is1-ssl.mzstatic.com/image/thumb/Features125/v4/dd/7d/72/dd7d7259-d27f-5b3e-ce64-9e304d2cb40f/dj.rxzrauer.jpg/1425x1425bb.jpg",
  "artworkWidth": 1425,
  "artworkHeight": 1425,
  "artworkColors": {
    "bgColor": "#171008",
    "textColor1": "#d6c19f",
    "textColor2": "#ccb896",
    "textColor3": "#af9d80",
    "textColor4": "#a7967a"
  },
  "artistImageUrl": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/ba/91/04/ba91045f-f613-c7a2-e1da-3195779b40a0/ami-identity-640bb7a837fee9170cc487c37709e42e-2026-03-08T16-34-26.425Z_cropped.png/800x800cc.jpg",
  "colors": {
    "background": "#171008",
    "primary": "#d6c19f",
    "secondary": "#ccb896",
    "tertiary": "#af9d80",
    "quaternary": "#a7967a"
  },
  "shazamUrl": "https://www.shazam.com/track/11243053/somewhere-i-belong",
  "appleMusicUrl": "https://music.apple.com/us/album/somewhere-i-belong/528435845?i=528437020",
  "previewUrl": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview221/v4/47/10/0e/47100e1b-b0db-71fa-2f39-696e426fbb89/mzaf_13973670849236078346.plus.aac.ep.m4a",
  "itunesUrl": "https://itunes.apple.com/us/album/somewhere-i-belong/528435845?i=528437020",
  "spotifyUrl": "https://open.spotify.com/search/Somewhere%20I%20Belong%20LINKIN%20PARK",
  "deezerUrl": "https://www.deezer.com/search/Somewhere%20I%20Belong%20LINKIN%20PARK",
  "youtubeMusicUrl": null,
  "youtubeVideoUrl": null,
  "streamingProvider": "APPLE MUSIC",
  "relatedTracksId": "track-similarities-id-11243053",
  "shazamType": "MUSIC",
  "share": {
    "subject": "Somewhere I Belong - LINKIN PARK",
    "text": "Somewhere I Belong by LINKIN PARK",
    "href": "https://www.shazam.com/track/11243053/somewhere-i-belong",
    "twitter": "I used @Shazam to discover Somewhere I Belong by LINKIN PARK.",
    "snapchat": "https://www.shazam.com/partner/sc/track/11243053",
    "html": "https://www.shazam.com/snippets/email-share/11243053?lang=en-US&country=US",
    "image": "https://is1-ssl.mzstatic.com/image/thumb/Features125/v4/dd/7d/72/dd7d7259-d27f-5b3e-ce64-9e304d2cb40f/dj.rxzrauer.jpg/400x400cc.jpg",
    "avatar": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/ba/91/04/ba91045f-f613-c7a2-e1da-3195779b40a0/ami-identity-640bb7a837fee9170cc487c37709e42e-2026-03-08T16-34-26.425Z_cropped.png/800x800cc.jpg"
  },
  "albumDetails": {
    "appleMusicId": "528435845",
    "name": "Meteora",
    "artist": "LINKIN PARK",
    "upc": "093624949350",
    "recordLabel": "Warner Records",
    "copyright": "℗ 2003 Warner Records Inc.",
    "releaseDate": "2003-03-25",
    "trackCount": 13,
    "isSingle": false,
    "isCompilation": false,
    "isComplete": true,
    "isPrerelease": false,
    "genres": [
      "Hard Rock",
      "Rock",
      "Alternative",
      "Metal"
    ],
    "contentRating": null,
    "audioTraits": [
      "hi-res-lossless",
      "lossless",
      "lossy-stereo"
    ],
    "isMasteredForItunes": true,
    "artistUrl": "https://music.apple.com/us/artist/linkin-park/148662",
    "url": "https://music.apple.com/us/album/meteora/528435845",
    "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Features125/v4/dd/7d/72/dd7d7259-d27f-5b3e-ce64-9e304d2cb40f/dj.rxzrauer.jpg/1425x1425bb.jpg",
    "editorialNotes": "When LINKIN PARK started writing the album that would become 2003's <i>Meteora</i>, they were touring behind their 2000 debut <i>Hybrid Theory</i>, a wildfire hit that took even the band by surprise. Their blend of guitar rock's pummeling riffs, hip-hop's swaggering grooves, and intricately emotional lyrics delivered by co-vocalists Chester Bennington and Mike Shinoda turned them into one of the 21st century's biggest new artists."
  },
  "musicVideos": [
    {
      "appleMusicId": "1677893648",
      "title": "Somewhere I Belong (4K UPGRADE)",
      "artist": "LINKIN PARK",
      "isrc": "USWBV2300347",
      "releaseDate": "2007-03-05",
      "durationMs": 225767,
      "url": "https://music.apple.com/us/music-video/somewhere-i-belong-4k-upgrade/1677893648",
      "has4K": true,
      "hasHDR": false,
      "videoTraits": [
        "4K"
      ],
      "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Video126/v4/a8/98/b1/a898b10c-6c57-2057-eab4-15ac90d67f16/USWBV2300347.sca1.jpg/640x324mv.jpg",
      "previewUrl": "https://video-ssl.itunes.apple.com/itunes-assets/Video116/v4/49/a1/dd/49a1dd0b-c376-d9b4-4273-c36cf6490d24/mzvf_12125820806053741408.720w.h264lc.U.p.m4v"
    },
    {
      "appleMusicId": "207921133",
      "title": "Somewhere I Belong",
      "artist": "LINKIN PARK",
      "isrc": "USWBV0300024",
      "releaseDate": "2003-03-25",
      "durationMs": 224973,
      "url": "https://music.apple.com/us/music-video/somewhere-i-belong/207921133",
      "has4K": false,
      "hasHDR": false,
      "videoTraits": [],
      "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Video123/v4/91/6c/8d/916c8d35-4641-9369-dc04-721dc46f1eae/dj.uaxlydvq.jpg/640x336mv.jpg",
      "previewUrl": "https://video-ssl.itunes.apple.com/itunes-assets/Video116/v4/8a/2f/99/8a2f9997-9419-3814-342a-1c9d3d7ee3f8/mzvf_15814734000299680918.640x336.h264lc.U.p.m4v"
    }
  ],
  "editorialNotes": null,
  "detailsIncluded": true,
  "recognition": {
    "offsetInSongSeconds": 96.907,
    "startInFileSeconds": 38.988,
    "endInFileSeconds": 50.988,
    "listenedSeconds": 12.0,
    "matchCount": 1,
    "fileDurationSeconds": 89.976,
    "fileBytes": 3130107,
    "attempts": [
      {
        "offsetSeconds": 38.988,
        "durationSeconds": 12.0,
        "matched": true
      }
    ],
    "recognizedAt": "2026-11-03T12:03:27.868Z",
    "partialFile": false
  },
  "matches": [
    {
      "shazamKey": "221208326",
      "offsetSeconds": 96.907046875,
      "timeSkew": -0.000800848,
      "frequencySkew": -0.0007246733
    }
  ],
  "scrapedAt": "2026-11-03T12:03:27.868Z"
}
```

`spotifyUrl` and `deezerUrl` open a search for the song on those services. `coverArtUrl` is the 400 px cover, `coverArtHqUrl` 1000 px and `artworkMaxUrl` the largest size available. Lyrics fields say whether lyrics exist; the lyrics text itself is not included.

### How to identify songs in audio and video files

Paste one or more links into **Audio or video links** (`audioUrls`). Each link must open the file itself.

- **Audio:** mp3, m4a, aac, ogg, opus, wav, flac and more.
- **Video:** mp4, webm, mov and more. The soundtrack is used; you do not need to extract it.
- **Size:** for one song per file, the first 50 MB and up to 30 minutes from the start point are read; a bigger file is read from its beginning and `partialFile` is true. With `findAllSongs`, files up to 200 MB and 4 hours are read in full.
- **How many:** up to 1,000 links per run.
- **Your own files:** upload them to a key-value store in your Apify account and paste the record's link. Files in your own account are read with your run's access, so they can stay private.
- **Not supported:** links to web pages such as YouTube, TikTok, Instagram or Spotify pages. They are pages, not files.

By default the actor listens to 12 seconds, as the Shazam app does. On long files it starts in the middle, then tries the start and the rest of the file until it finds the song, so a song that starts late is still found without any setting. If nothing is found after several tries, you get a free `no_match` row. If the file could not be checked, you get a free `failed` row instead, never a false "no match".

| Parameter | Type | Default | Meaning |
|---|---|---|---|
| `audioUrls` | list of links | none | Direct links to audio or video files, up to 1,000 per run |
| `findAllSongs` | true / false | false | Listen across the whole file (up to 200 MB and 4 hours) and return every song with its start and end time |
| `startSeconds` | number | empty | Listen here first, in seconds from the start of the file |
| `listenSeconds` | 3 to 30 | 12 | Seconds of audio per attempt |
| `includeCatalogDetails` | true / false | true | Full song details: composer, UPC, audio quality, music videos and more. No extra charge |
| `country` | 2-letter code | US | Country for song details, links and search results |
| `maxResults` | number | empty | Stop after this many billed rows across all inputs |

#### Find every song in a DJ set, radio show or podcast

```json
{
  "audioUrls": [
    "https://example.com/your-radio-show.mp3"
  ],
  "findAllSongs": true
}
```

Replace the link with your recording. The actor listens across the whole file, 12 seconds at a time, and returns one row per song in playing order. Each row has the full song record plus `songNumberInFile`, `startInFileSeconds` and `endInFileSeconds`. Times are accurate to one listening window (12 seconds by default; a shorter `listenSeconds` gives finer times). Speech, jingles and silence between songs produce no rows and no charge. `windowsChecked` says how many parts of the file were checked and `windowsFailed` how many could not be checked; if any failed, run the file again to fill the gaps.

Real result from a 3-minute test file with two songs back to back (excerpt: the two rows' song and `recognition` fields; both rows also carry every song field shown above):

```json
[
  {
    "resultType": "recognized_song",
    "status": "recognized",
    "title": "Housewife",
    "artist": "Tate McRae",
    "isrc": "USRC12601916",
    "recognition": {
      "songNumberInFile": 1,
      "startInFileSeconds": 0.0,
      "endInFileSeconds": 96.0,
      "offsetInSongSeconds": 47.995,
      "fileDurationSeconds": 179.951,
      "windowsChecked": 15,
      "windowsFailed": 0
    }
  },
  {
    "resultType": "recognized_song",
    "status": "recognized",
    "title": "Back 2 U",
    "artist": "Seyi Vibez",
    "isrc": "USUYG1830608",
    "recognition": {
      "songNumberInFile": 2,
      "startInFileSeconds": 96.0,
      "endInFileSeconds": 179.951,
      "offsetInSongSeconds": 36.001,
      "fileDurationSeconds": 179.951,
      "windowsChecked": 15,
      "windowsFailed": 0
    }
  }
]
```

#### When the song is not found

Rows that are not a delivered result are free and say why in `statusMessage`:

| `status` | When | Charged |
|---|---|---|
| `recognized` / `ok` | A song, chart song, search result or artist was returned | Yes |
| `no_match` | No song was recognized in the file | No |
| `failed` | The file could not be read or checked, or a chart, song, artist or search could not be read at that moment | No |
| `not_found` | No song or artist exists for the id, link or ISRC you gave | No |
| `invalid_input` | The value is not a Shazam key, song link, artist link or ISRC | No |

For a `no_match` file, try `startSeconds` at a part where the music is clear, or a longer `listenSeconds`. Live recordings, covers and remixes that Shazam does not know cannot be matched.

### Shazam charts: Top 200, genres, cities and Discovery

```json
{
  "chartTypes": ["top", "genre", "city", "discovery"],
  "chartCountries": ["world", "US"],
  "chartGenres": ["Pop", "Dance"],
  "chartCities": ["Chicago", "Boston"]
}
```

This input reads 10 charts in one run and returns 1,675 chart songs with full details: Top 200 worldwide and US, Pop and Dance worldwide and US, Discovery worldwide and US, and the Chicago and Boston city charts. A larger run of 36 charts returned 5,200 chart songs in under 90 seconds.

| Parameter | Meaning |
|---|---|
| `chartTypes` | `top` (Top 200), `genre` (one chart per genre), `city` (one Top 200 per city, named like "Top 200 Chicago"), `discovery` (songs on the rise) |
| `chartCountries` | `world` or 2-letter country codes such as `US`, `GB`, `BR`, `NG`, `ZA`, `IN`. Shazam has charts for 70 countries. Empty means worldwide |
| `chartGenres` | Keep only these genres, for example `Pop`, `Hip-Hop/Rap`, `Dance`. Empty means every genre the country has |
| `chartCities` | Keep only these cities, for example `London`, `New York City`. 175 cities in total. Empty means every city in the country |
| `maxItemsPerChart` | Songs per chart; empty means the whole chart, up to 200 |

Not every country has every chart type; the run log says when one is missing. Chart rows carry `chartRank`, `chartName`, `chartType`, `chartCountry`, `chartCountryName`, `chartCity`, `chartGenre`, `chartId` and `chartSize` on top of the song fields. Chart songs carry the Apple Music id; their `shazamKey` is empty. To track charts over time, schedule the run daily and compare ranks by `appleMusicId` or `isrc`.

### Look up songs, ISRC codes and artists, or search songs

```json
{
  "songs": [
    "503576063",
    "https://www.shazam.com/song/1499378607/blinding-lights",
    "USUG11904206"
  ],
  "artists": ["https://www.shazam.com/artist/the-weeknd/479756766", "148662"],
  "searchQueries": ["blinding lights"],
  "maxSearchResults": 25
}
```

- **`songs`:** Shazam keys, Shazam song links, Apple Music song links or ISRC codes. Each returns the full song record. An ISRC returns every release that carries it; `USUG11904206` returned five releases of "Blinding Lights", including After Hours and The Highlights.
- **`artists`:** artist ids, or Shazam or Apple Music artist links. One row per artist, with the bio and, where one exists, a one-line `shortBio`.
- **`searchQueries`:** song or artist names. Up to `maxSearchResults` songs per term (1 to 500, default 25), with `searchPosition` in result order. Like chart songs, search results carry the Apple Music id and an empty `shazamKey`.

The artist row for `148662` (LINKIN PARK), real values, with each list cut to its first entry. The full row had 10 top songs, 10 albums, 10 singles and 10 similar artists:

```json
{
  "resultType": "artist",
  "status": "ok",
  "appleMusicId": "148662",
  "name": "LINKIN PARK",
  "genres": [
    "Hard Rock"
  ],
  "genre": "Hard Rock",
  "bio": "Rooted at the crossroads of aggressive metal and beat-driven hip-hop, Linkin Park became one of the most successful acts of the early 21st century by incorporating elements from rap, punk, electronic, and even polished pop stylings into their music. From the commercial peak of their hip-hop-influenced, multi-platinum breakthrough albums Hybrid Theory (2000) and Meteora (2003), into a brief electronic phase (2010's A Thousand Suns), and a pop moment (2017's One More Light), they stayed ahead of the curve without sacrificing heaviness or chart success. Months after the release of their seventh and final album with the founding lineup, frontman Chester Bennington passed away, closing a nearly two-decade first chapter that included five chart-topping albums and tens of millions of records sold worldwide. In 2024, they re-formed with a new singer (Emily Armstrong) and drummer (Colin Brittain), launching a world tour and releasing their eighth album, From Zero.",
  "shortBio": null,
  "editorialNotes": null,
  "origin": "Agoura Hills, CA, United States",
  "bornOrFormed": "1996",
  "isGroup": true,
  "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/ba/91/04/ba91045f-f613-c7a2-e1da-3195779b40a0/ami-identity-640bb7a837fee9170cc487c37709e42e-2026-03-08T16-34-26.425Z_cropped.png/2400x2400bb.jpg",
  "url": "https://music.apple.com/us/artist/linkin-park/148662",
  "shazamUrl": "https://www.shazam.com/artist/linkin-park/148662",
  "topSongs": [
    {
      "appleMusicId": "590431785",
      "title": "In the End",
      "artist": "LINKIN PARK",
      "album": "Hybrid Theory (Deluxe Edition)",
      "isrc": "USWB11201118",
      "releaseDate": "2000-10-24",
      "durationMs": 216294,
      "url": "https://music.apple.com/us/album/in-the-end/590431776?i=590431785",
      "previewUrl": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview211/v4/d9/33/34/d933341d-ba95-dc3b-11a3-34d6632dd62e/mzaf_15858614099982706639.plus.aac.ep.m4a",
      "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/53/a7/7f/53a77fab-c54c-a57b-8130-248fc12d0c80/093624948995.jpg/1425x1425bb.jpg"
    }
  ],
  "latestRelease": {
    "appleMusicId": "6794460856",
    "name": "Unshatter Film Soundtrack (Live in São Paulo)",
    "releaseDate": "2026-09-25",
    "trackCount": 20,
    "isSingle": false,
    "recordLabel": "Warner Records",
    "upc": "093624821380",
    "url": "https://music.apple.com/us/album/unshatter-film-soundtrack-live-in-s%C3%A3o-paulo/6794460856",
    "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/cd/7b/91/cd7b9189-5c62-5f99-c39a-e268a31ec7c2/093624821380.jpg/1500x1500bb.jpg"
  },
  "albums": [
    {
      "appleMusicId": "1801842323",
      "name": "From Zero (Deluxe Edition)",
      "releaseDate": "2024-11-15",
      "trackCount": 14,
      "isSingle": false,
      "recordLabel": "Warner Records",
      "upc": "093624831402",
      "url": "https://music.apple.com/us/album/from-zero-deluxe-edition/1801842323",
      "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/0e/5a/da/0e5ada8d-046b-2685-3a81-8160eaa54f5f/093624831402.jpg/3750x3750bb.jpg"
    }
  ],
  "singles": [
    {
      "appleMusicId": "1742621002",
      "name": "QWERTY (Live in Tokyo, 2006) - Single",
      "releaseDate": "2024-04-26",
      "trackCount": 3,
      "isSingle": false,
      "recordLabel": "Warner Records",
      "upc": "093624842033",
      "url": "https://music.apple.com/us/album/qwerty-live-in-tokyo-2006-single/1742621002",
      "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/12/a7/c9/12a7c985-2fad-4a77-073e-281e9aabc15e/093624842033.jpg/2000x2000bb.jpg"
    }
  ],
  "similarArtists": [
    {
      "appleMusicId": "325215284",
      "name": "Dead By Sunrise",
      "url": "https://music.apple.com/us/artist/dead-by-sunrise/325215284"
    }
  ],
  "input": "148662",
  "scrapedAt": "2026-11-03T12:02:09.101Z"
}
```

### Integrations and scheduling

Run the actor from Python or JavaScript with Apify's client libraries, or connect it to n8n, Make or Zapier. Schedule it in Apify to collect Shazam charts every day, or trigger it from your own workflow whenever new recordings arrive. Results export as JSON, CSV, Excel or XML; JSON keeps the nested fields (`artists`, `albumDetails`, `recognition`) intact.

### Pricing

You pay per result. Files with no song, files that could not be read or checked, and inputs that were not found or not valid are free.

| Event | When charged | Free plan | Bronze | Silver | Gold and above |
|---|---|---|---|---|---|
| Recognized song | Each song identified in a file; with `findAllSongs`, each song found | $1.99 per 1,000 | $1.79 | $1.69 | $1.39 |
| Result | Each chart song, looked-up song, search result or artist | $0.99 per 1,000 | $0.89 | $0.79 | $0.69 |
| Actor start | Once per run, per GB of run memory | $0.00005 | $0.00005 | $0.00005 | $0.00005 |

Full song details are included in both result prices. The start charge is nominal: 1,000 runs at 1 GB of memory cost $0.05 in total.

Examples on the Free plan: 1,000 files that each contain a song cost $1.99. The worldwide and US Top 200 charts (400 songs) cost about $0.40. A recording in which `findAllSongs` finds 20 songs costs about $0.04. Set `maxResults` to cap any run.

### FAQ

**Can I Shazam an audio file, an mp3 or a recording?** Yes. Paste a direct link to the file in `audioUrls`. mp3, m4a, aac, wav, flac, ogg and opus files work. For one song per file the first 50 MB are read; with `findAllSongs`, files up to 200 MB and 4 hours.

**How many files can I check in one run?** Up to 1,000 links per run. The same limit applies to `songs`, `artists`, `searchQueries` and `chartCountries`; split bigger lists into several runs.

**Can I identify the song in a video file?** Yes. mp4, mov and webm files work; the actor listens to the soundtrack.

**Can I paste a YouTube, TikTok or Instagram link?** No. Those are web pages, not files. Download the video or audio file you have the rights to use, or upload it to your Apify key-value store, and paste that file link.

**How do I find a song's ISRC code?** Every recognized song comes with its `isrc`. If you already know the song, put its Shazam or Apple Music link in `songs`. If you have an ISRC, put it in `songs` to get every release that carries it.

**Can it make a tracklist for a DJ set or radio show?** Yes. Turn on `findAllSongs`. You get one row per song in playing order with start and end times in the file. Each song found is billed as one recognized song.

**Why was no song found?** The clip may be speech, a live version or a song Shazam does not know, or the music may be too quiet under talking. Set `startSeconds` to a clear part of the music or raise `listenSeconds`. No-match rows are free. A file that could not be checked comes back as a free `failed` row; run it again.

**What does `detailsIncluded: false` mean?** The full song details (composer, UPC, audio quality and more) were off or could not be loaded for that song. The basic song fields (title, artist, ISRC, links) are still in the row.

**How accurate is it?** On our 12-clip test set (chart songs from six countries, plus noisy, video, low-bitrate, sped-up and late-starting clips) all 11 songs were identified with the correct ISRC and the clip without a song was reported as no match. Songs that Shazam does not know cannot be matched.

**Do I need a Shazam account?** No account, login or app is needed.

**Which country do the song links use?** `country` sets the store country for Apple Music links, song details and search (default `US`). Charts use the country you ask for.

**Does it return lyrics?** It says whether lyrics and time-synced lyrics exist (`hasLyrics`, `hasTimeSyncedLyrics`). The lyrics text is not included.

**Can I call it from my own code?** Yes. Use Apify's Python or JavaScript client and read the results from the run's dataset.

**Is my audio stored?** Files are read for the run and not kept. Results stay in your own Apify dataset.

**Is this an official Shazam product?** No. It is an independent tool, not affiliated with Shazam or Apple. Use files you are allowed to process and follow the terms that apply to how you use the results.

### Support

Questions, problems or a field you need: open the **Issues** tab on this actor, or email **max@mapa.slmail.me**. Bug reports with the run id get answered fastest.

# Actor input Schema

## `audioUrls` (type: `array`):

Direct http(s) links to audio or video files: mp3, m4a, aac, ogg, opus, wav, flac, mp4, webm, mov and more. One song per file reads the first 50 MB (and 30 minutes from the start point); with "Find every song in each file" files up to 200 MB and 4 hours work. Links to web pages (YouTube, TikTok, Spotify pages) are not files. Files in your Apify key-value store work too. Up to 1,000 links per run.

## `maxResults` (type: `integer`):

Stops the run after this many billed results across all inputs (recognized songs, chart rows, songs, search rows and artists). Leave empty for no limit.

## `startSeconds` (type: `integer`):

Where in each file to listen first. Leave empty and the actor tries the middle of long files, then the start, then the rest of the file until it finds the song.

## `listenSeconds` (type: `integer`):

Seconds of audio per attempt, 3 to 30. 12 is what the Shazam app sends.

## `findAllSongs` (type: `boolean`):

For DJ sets, radio recordings, podcasts and long videos: listens across the whole file (up to 200 MB and 4 hours) and returns every song with where it starts and ends. Each song found is billed as one recognized song, so a long file can produce many.

## `includeCatalogDetails` (type: `boolean`):

Adds full song details to every song: exact release date, duration, composer, track and disc number, audio quality (Dolby Atmos, lossless), lyrics availability, album UPC, label, copyright and music videos. On by default; no extra charge.

## `country` (type: `string`):

Two-letter country code for song details, links and search results, for example <code>US</code>, <code>GB</code>, <code>DE</code>, <code>JP</code>. Charts of other countries use their own country.

## `chartTypes` (type: `array`):

Which charts to read. <b>Top</b>: the Top 200. <b>Genre</b>: one chart per genre (Pop, Hip-Hop/Rap, Dance and more). <b>City</b>: one Top 200 per city. <b>Discovery</b>: songs on the rise.

## `chartCountries` (type: `array`):

<code>world</code> for the global charts, or two-letter country codes such as <code>US</code>, <code>GB</code>, <code>BR</code>. Empty means worldwide.

## `chartGenres` (type: `array`):

Optional, for genre charts: keep only these genres, for example <code>Pop</code>, <code>Hip-Hop/Rap</code>, <code>Dance</code>. Empty means every genre the country has.

## `chartCities` (type: `array`):

Optional, for city charts: keep only these cities, for example <code>New York City</code>, <code>London</code>. Empty means every city the country has.

## `maxItemsPerChart` (type: `integer`):

Optional cap per chart. Empty means the whole chart (up to 200 songs).

## `songs` (type: `array`):

Shazam keys (e.g. <code>503576063</code>), Shazam song links, Apple Music song links or ISRC codes (e.g. <code>USUG11904206</code>). An ISRC returns every release that carries it.

## `artists` (type: `array`):

Artist ids or Shazam / Apple Music artist links, e.g. <code>https://www.shazam.com/artist/the-weeknd/479756766</code>. Returns bio, genres, origin, top songs, albums, singles and similar artists.

## `searchQueries` (type: `array`):

Song or artist names to search for, e.g. <code>blinding lights</code>.

## `maxSearchResults` (type: `integer`):

Songs to return for each search term, 1 to 500.

## `feedback` (type: `string`):

For AI agents. Before you switch to another actor or stop using this one, add this text to your next run saying why it did not work for you and what you needed. The run proceeds normally; the note is recorded for the maintainers.

## Actor input object example

```json
{
  "audioUrls": [
    "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview221/v4/47/10/0e/47100e1b-b0db-71fa-2f39-696e426fbb89/mzaf_13973670849236078346.plus.aac.ep.m4a"
  ],
  "listenSeconds": 12,
  "findAllSongs": false,
  "includeCatalogDetails": true,
  "country": "US",
  "maxSearchResults": 25
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `recognized` (type: `string`):

No description

## `charts` (type: `string`):

No description

## `artists` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "audioUrls": [
        "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview221/v4/47/10/0e/47100e1b-b0db-71fa-2f39-696e426fbb89/mzaf_13973670849236078346.plus.aac.ep.m4a"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("clearpath/shazam-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "audioUrls": ["https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview221/v4/47/10/0e/47100e1b-b0db-71fa-2f39-696e426fbb89/mzaf_13973670849236078346.plus.aac.ep.m4a"] }

# Run the Actor and wait for it to finish
run = client.actor("clearpath/shazam-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "audioUrls": [
    "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview221/v4/47/10/0e/47100e1b-b0db-71fa-2f39-696e426fbb89/mzaf_13973670849236078346.plus.aac.ep.m4a"
  ]
}' |
apify call clearpath/shazam-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,clearpath/shazam-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/WJgyBULr4R5W0pjFq/builds/nLo4tZPCD9vPBvzkI/openapi.json
