Shazam API & Scraper
This API returns what shazam.com publishes, logged out, as JSON.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
`chart` returns any Shazam chart in Shazam's own order: the world Top 200, the Top 200 of 70 countries, city lists for 175 cities, world and country genre charts, viral charts, discovery charts and radio-spins charts, each row with the Shazam track key, Apple Music id, ISRC, album, genres, release date, duration, composer and preview link; `charts_list` lists every chart that exists. `track` resolves a song from a Shazam key, an Apple Music id, an ISRC or a link and returns its metadata, album (label, UPC, copyright), artists and music videos; `tracks` does up to 50 songs in one call. `track_insights` returns what the song page adds: the all-time Shazam count, Shazam's audio analysis (BPM, energy, danceability, valence, acousticness, melodicness), the most-Shazamed moment of the song, songwriter and producer credits, 20 similar songs and whether the song has lyrics. `artist`, `album`, `search` and `autocomplete` cover the catalogue; `artist_insights` adds the artist's most-Shazamed songs this week and of all time and their Shazam Global Chart appearances. `artist_events`, `events` and `event` return concerts with venue, coordinates, time zone and ticket link. `recognize` identifies a song from an audio link or an uploaded clip, like the Shazam app.
What a Shazam field actually contains
Fields that read differently from how they look. Every row was measured against live shazam.com on 2026-11-16.
| Field | What it holds |
|---|---|
| rank (chart) | The position in Shazam's chart. Equal to the rank in the chart file shazam.com publishes for 200 of 200 rows of the world, United States, Nigeria and world Pop charts. Country charts come with song names in that country's Apple Music language (Japan: 結び where Shazam's file writes musubi), so names can differ while the order is the same. |
| shazam_key | Shazam's own track id, the number in shazam.com/track/<key>. Filled on 186 to 199 of 200 rows per chart; a song Shazam has not linked to its catalogue has none. |
| apple_id | The Apple Music song id, the number in shazam.com/song/<id>. track, track_insights and tracks accept it, the Shazam key, an ISRC or a link. |
| beyond_site_list (city charts) | City charts hold 200 songs while shazam.com prints the Top 50 of a city. Rows 51 to 200 are returned and flagged true; the first 50 equal the site's list 50 of 50 (New York City). |
| shazam_count | The all-time number of Shazams printed on the song page (Blinding Lights: 32,577,744). The artist page shows the same figure rounded (32.5M). |
| audio_analysis | BPM and five 0-1 scores exactly as the song page shows them (Blinding Lights: 171 BPM, energy 0.68, danceability 0.76). Shazam labels them AI generated; the label is returned with them. |
| popular_moments | The point of the song people Shazam most, as the page marks it (Blinding Lights: 00:45). The page draws the rest as a curve without numbers, so no per-second counts are returned. |
| lyrics | Whether the song has lyrics, the provider (Apple Music), whether they are time-synced and how many sections and lines they have. The lyric text itself is not returned. |
| isrc lookups | One ISRC can belong to several catalogue songs (USUG11904206: the original Blinding Lights and a 2021 cover). track picks the song Shazam itself links to the ISRC and lists the others in other_apple_ids. |
| events (concert finder) | shazam.com lists 50 concerts per search. The filters really narrow the list: a date window returned only concerts inside it (50 of 50), an artist filter only that artist (25 of 25 for Metallica in the United States). |
Song names, genres and credits are in the language of the Apple Music storefront asked for (country, default us). Shazam counts and audio analysis are worldwide figures.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/shazam/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "blinding lights",
"types": "songs"
}
}{
"ok": true,
"meta": {
"api": "shazam",
"endpoint": "search",
"mode": "live",
"latency_ms": 588.6,
"record_count": 10,
"bytes": 10883,
"cache_hit": false,
"upstream_requests": 1,
"charged_credits": 1,
"version": "0.1.0",
"request_id": "2689d000a5164e2e",
"queue_ms": 7.3,
"fetched_at": "2026-11-16T21:05:25.989Z"
},
"data": {
"results": {
"songs": [
{
"apple_id": "1488408568",
"title": "Blinding Lights",
"artist_name": "The Weeknd",
"album_name": "Blinding Lights - Single",
"isrc": "USUG11904206",
"genres": [
"[trimmed-depth]",
"[trimmed-depth]"
],
"composer": "Max Martin, Oscar Holter, Abel Tesfaye, Ahmad Balshe & Jason 'Daheala' Quenneville",
"release_date": "2019-11-29",
"duration_ms": 201570,
"duration": "3:22",
"track_number": 1,
"disc_number": 1,
"explicit": false,
"content_rating": null,
"has_lyrics": true,
"is_apple_digital_master": true,
"preview_url": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview211/v4/17/b4/8f/17b48f9a-0b93-6bb8-fe1d-3a16623c2cfb/mzaf_9560252727299052414.plus.aac.p.m4a",
"artwork": {
"url": "[trimmed-depth]",
"url_template": "[trimmed-depth]",
"width": "[trimmed-depth]",
"height": "[trimmed-depth]",
"background_color": "[trimmed-depth]",
"text_colors": "[trimmed-depth]"
},
"apple_music_url": "https://music.apple.com/us/album/blinding-lights/1488408555?i=1488408568",
"kind": "song"
},
{
"apple_id": "1542842761",
"title": "Blinding Lights (Remix)",
"artist_name": "The Weeknd & ROSALÍA",
"album_name": "Blinding Lights (Remix) - Single",
"isrc": "USUG12004507",
"genres": [
"[trimmed-depth]",
"[trimmed-depth]"
],
"composer": "Max Martin, Oscar Holter, Abel Tesfaye, Ahmad Balshe, Jason 'Daheala' Quenneville & ROSALÍA",
"release_date": "2020-12-04",
"duration_ms": 216123,
"duration": "3:36",
"track_number": 1,
"disc_number": 1,
"explicit": false,
"content_rating": null,
"has_lyrics": true,
"is_apple_digital_master": true,
"preview_url": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview211/v4/12/73/ca/1273ca46-233a-5331-189b-25ac1d656533/mzaf_976341070785891411.plus.aac.p.m4a",
"artwork": {
"url": "[trimmed-depth]",
"url_template": "[trimmed-depth]",
"width": "[trimmed-depth]",
"height": "[trimmed-depth]",
"background_color": "[trimmed-depth]",
"text_colors": "[trimmed-depth]"
},
"apple_music_url": "https://music.apple.com/us/album/blinding-lights-remix/1542842760?i=1542842761",
"kind": "song"
},
{
"apple_id": "1513133940",
"title": "Blinding Lights",
"artist_name": "Teddy Swims",
"album_name": "Blinding Lights - Single",
"isrc": "USWB12001485",
"genres": [
"[trimmed-depth]",
"[trimmed-depth]"
],
"composer": "Abel Tesfaye, Ahmad Balshe, Jason Matthew Quenneville, Martin Karl Sandberg & Oscar Holter",
"release_date": "2020-05-15",
"duration_ms": 214875,
"duration": "3:35",
"track_number": 1,
"disc_number": 1,
"explicit": false,
"content_rating": null,
"has_lyrics": true,
"is_apple_digital_master": false,
"preview_url": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview211/v4/19/15/36/191536a4-ac87-627a-8564-54fd9de112b7/mzaf_11108427522960930180.plus.aac.p.m4a",
"artwork": {
"url": "[trimmed-depth]",
"url_template": "[trimmed-depth]",
"width": "[trimmed-depth]",
"height": "[trimmed-depth]",
"background_color": "[trimmed-depth]",
"text_colors": "[trimmed-depth]"
},
"apple_music_url": "https://music.apple.com/us/album/blinding-lights/1513133938?i=1513133940",
"kind": "song"
}
]
},
"counts": {
"songs": 10
},
"offset": 0,
"next_offset": {
"songs": 10
},
"query": "blinding lights",
"types": [
"songs"
]
}
}What the Shazam API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| charts_list | Every chart Shazam publishes: the world Top 200, the Top 200 of 70 countries, the Top 50 of 175 cities, world and country genre charts, world and country viral charts, country discovery charts and world radio-spins charts by genre. Filter by chart_type or country. | Content platforms call charts_list to get every chart Shazam publishes. | chart_type, country |
| chart | One Shazam chart, in Shazam's order, with each song's Shazam key, Apple Music id, ISRC, album, genres, release date, duration, composer, explicit flag, lyrics flag, preview and artwork. chart_type=top with no country is the world Top 200; with a country the country Top 200; with a city the city Top 50. genre / viral / discovery / radio_spins: see charts_list for what exists. | Research tools call chart to get one Shazam chart, in Shazam's order, with each song's Shazam key, Apple Music id, ISRC, album…. | chart_type, country, city, genre, limit, ... |
| track | One song on Shazam: Shazam key and Apple Music id, title, artists (ids), album (label, UPC, copyright, release date, track count), ISRC, genres and Shazam's primary genre, composer, release date, duration, explicit flag, whether lyrics exist, preview clip, artwork, music videos, and Shazam's own label / released lines. For the Shazam count, audio analysis (BPM) and credits use `track_insights`. | Community analysts call track to get one song on Shazam. | track, shazam_key, apple_id, isrc, country, ... |
| tracks | Up to 50 songs in one call by Apple Music id, or up to 25 by ISRC (one catalogue request + one Shazam-key lookup): the same song fields as `track` without album and video details. | Media monitors call tracks to get up to 50 songs in one call by Apple Music id, or up to 25 by ISRC (one catalogue request + on…. | apple_ids, isrcs, country, language |
| track_insights | What the shazam.com song page shows beyond the catalogue: the all-time Shazam count, Shazam's audio analysis (BPM, energy, danceability, valence, acousticness, melodicness — labelled AI generated by Shazam), the most-Shazamed moment of the song, songwriter / producer credits, similar songs, the artist's top songs, the music video id, and whether lyrics exist (provider, time-synced, section and line counts — not the lyric text). | Content platforms call track_insights to get what the shazam.com song page shows beyond the catalogue. | track, shazam_key, apple_id, isrc |
| artist | One artist: name, genres, editorial notes, artwork, links, and the first rows of every catalogue list Shazam shows — top songs, albums, singles & EPs, live albums, compilations, appears on, latest release, similar artists, top music videos and artist playlists (each with `has_more` and the action that pages it). | Research tools call artist to get one artist. | artist_id, country, language |
| artist_top_songs | An artist's top songs, paged (same song fields as chart rows). | Community analysts call artist_top_songs to get an artist's top songs, paged (same song fields as chart rows).. | artist_id, limit, offset, country, language |
| artist_albums | An artist's releases of one kind (albums, singles & EPs, live, compilations, appears on), paged: label, UPC, copyright, release date, track count, editorial notes. | Media monitors call artist_albums to get an artist's releases of one kind (albums, singles & EPs, live, compilations, appears on), paged. | artist_id, kind, limit, offset, country, ... |
| similar_artists | Artists similar to one artist, paged. | Content platforms call similar_artists to get artists similar to one artist, paged.. | artist_id, limit, offset, country, language |
| artist_music_videos | An artist's top music videos, paged. | Research tools call artist_music_videos to get an artist's top music videos, paged.. | artist_id, limit, offset, country, language |
| artist_insights | What the shazam.com artist page shows beyond the catalogue: the artist's most-Shazamed songs this week and of all time, Shazam Global Chart Top 50 appearances, frequent collaborators, artists they were inspired by, similar artists, the about card (hometown, born / formed, genre), biography and social links. | Community analysts call artist_insights to get what the shazam.com artist page shows beyond the catalogue. | artist_id |
| artist_events | An artist's concerts on Shazam: upcoming and past shows with date, local time and time zone, venue (address, city, country, coordinates), ticket link and ticket provider, plus whether the artist is on tour and shows per country. | Media monitors call artist_events to get an artist's concerts on Shazam. | artist_id, include_past, limit, offset |
| events | Concerts listed on shazam.com's concert finder for a country or a city, filtered like the site: date (all, today, tomorrow, this weekend, or a date range), genres and artist. Each row has the date, local time and time zone, venue with address and coordinates, ticket link and ticket provider. The site lists 50 concerts per filter combination; narrow with date / genre / city for more. | Content platforms call events to get concerts listed on shazam.com's concert finder for a country or a city, filtered like the site. | country, city, date, start_date, end_date, ... |
| event | One concert on Shazam: date and time, venue with address and coordinates, ticket link and provider, artists. | Research tools call event to get one concert on Shazam. | event_id |
| album | One album: label, UPC, copyright, release date, genres, editorial notes, artwork, every track (with Shazam keys), and the album's other versions, related albums, 'featured on' albums and music videos (first rows; page them with album_related). | Community analysts call album to get one album. | album_id, country, language, include_shazam_keys |
| album_related | Albums related to one album (related albums, other versions, featured on) or its music videos, paged. | Media monitors call album_related to get albums related to one album (related albums, other versions, featured on) or its music videos…. | album_id, view, limit, offset, country, ... |
| search | Search Shazam's catalogue (what the shazam.com search box searches): songs, artists, albums, music videos or playlists, paged. | Content platforms call search to search Shazam's catalogue (what the shazam.com search box searches). | query, types, limit, offset, country, ... |
| autocomplete | Search suggestions as you type: suggested search terms and top matching songs, artists and albums. | Research tools call autocomplete to search suggestions as you type. | query, country, language |
| recognize | Identify a song from audio, like the Shazam app: pass a link to an audio or video file, or the file itself as base64. The middle 12 seconds are fingerprinted and matched against Shazam; the answer is the matched song (Shazam key, Apple Music id, title, artist, ISRC, album, label, artwork) and where in the song the clip sits. | Community analysts call recognize to get identify a song from audio, like the Shazam app. | audio_url, audio_base64, segment_seconds |
Call search from your stack
curl -X POST https://api.reefapi.com/shazam/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"blinding lights","types":"songs"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/shazam/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "blinding lights",
"types": "songs"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/shazam/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "blinding lights",
"types": "songs"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.shazam.search with {"query":"blinding lights","types":"songs"}.Who uses this API and why
- Track the world, country and city Shazam charts every day to spot songs before they break.
- Add BPM, energy and danceability to a catalogue for playlist building and DJ tools.
- Monitor all-time Shazam counts of a label's releases.
- Identify songs in user-uploaded clips and link them to Apple Music and ISRCs.
- List upcoming concerts by city, date and genre with venue coordinates and ticket links.
Questions developers ask before integrating
Do I need a Shazam or Apple Music account?
No. Everything is read logged out; you only need a ReefAPI key.
Which charts are available?
The world Top 200, the Top 200 of 70 countries, city charts for 175 cities, 18 world genre charts plus genre charts for some countries, the world and 42 country viral charts, discovery charts for 30 countries and world radio-spins charts by genre. charts_list returns the full list with ids.
Can I get the number of Shazams of a song?
Yes. track_insights returns the all-time Shazam count printed on the song page, for example 32,577,744 for Blinding Lights, together with BPM and audio analysis. artist_insights returns an artist's most-Shazamed songs this week and of all time.
Can it identify a song from audio?
Yes. recognize takes a link to an audio or video file (mp3, m4a, ogg, wav, mp4 and more) or the file as base64, fingerprints 12 seconds from the middle and returns the matched song with its Shazam key, Apple Music id, ISRC, album and label, plus where in the song the clip sits. 7 of 7 test clips were identified correctly.
Are lyrics included?
Not the text. The response says whether a song has lyrics, that Apple Music provides them, whether they are time-synced and how many sections and lines they have.
How do I look up many songs at once?
tracks takes up to 50 Apple Music ids, or up to 25 ISRCs, in one call and returns every song with its Shazam key.
Does it cover concerts?
Yes. artist_events lists an artist's upcoming and past shows (Metallica: 26 upcoming, 189 past), events searches shazam.com's concert finder by country or city, date, genre and artist (50 per search), and event returns one concert with venue address, coordinates, local time and ticket link.
What is the Shazam API?
Shazam API is a ReefAPI endpoint group for shazam charts for the world, 70 countries and 175 cities, shazam counts, bpm and audio analysis, credits, concerts and song recognition from audio. It returns live JSON through POST requests under /shazam/v1.
Is the Shazam API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Shazam calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Shazam login or account?
No login to Shazam is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Shazam data?
The page example is captured from a live charts_list call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Shazam API use?
Shazam actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Shazam from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call shazam actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Shazam API a Shazam scraper?
It is the managed alternative to a DIY Shazam scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same shazam charts for the world, 70 countries and 175 cities, shazam counts, bpm and audio analysis, credits, concerts and song recognition from audio back as clean JSON.