# Shazam API — charts (world, 70 countries, 175 cities, genres, viral, discovery), song details with Shazam count and audio analysis (BPM), credits, artists, albums, search, concerts and song recognition from audio

> 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.
> ReefAPI engine `shazam` · 19 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/shazam/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/shazam/v1/charts_list — 0 credits
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.

**Parameters:**
- `chart_type` (enum, optional) — Only this chart family. [one of: top, genre, viral, discovery, radio_spins]
- `country` (string, optional) — Only charts of this country (code, name or url name), or `world`.

**Returns:** charts[]{chart_type, scope (world|country|city), country_code, country, city, city_id, genre, genre_id, chart_id, declared_size, shazam_url} + count + counts_by_type

**Example request body:**
```json
{
  "country": "US"
}
```

### POST https://api.reefapi.com/shazam/v1/chart — 3 credits
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.

**Parameters:**
- `chart_type` (enum, optional, default "top") — Chart family. [one of: top, genre, viral, discovery, radio_spins]
- `country` (string, optional, default "world") — `world` (default) or a country: code (US), name (United States) or Shazam url name (united-states).
- `city` (string, optional) — City name or url name for a city Top 50 (chart_type=top).
- `genre` (string, optional) — Genre for genre / radio_spins charts: url name (hip-hop-rap) or name (Hip-Hop/Rap).
- `limit` (integer, optional, default 200) — Rows to return (1-200).
- `offset` (integer, optional, default 0) — Rank offset (0 = from #1).
- `storefront` (string, optional) — Apple Music storefront the song names and links are read in. Default: the chart's own country (us for world charts).
- `include_shazam_keys` (boolean, optional, default true) — Add each song's Shazam key (one extra lookup per 50 rows).

**Returns:** chart{chart_type, scope, country_code, country, city, genre, chart_id, name, updated_at, declared_size, shazam_url, apple_music_url} + results[]{rank, shazam_key, apple_id, title, artist_name, album_name, isrc, genres[], release_date, duration_ms, duration, composer, explicit, has_lyrics, preview_url, artwork, apple_music_url, shazam_url} + count + total + offset + next_offset + has_more

**Example request body:**
```json
{
  "chart_type": "top",
  "country": "world",
  "limit": 50
}
```

### POST https://api.reefapi.com/shazam/v1/track — 2 credits
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`.

**Parameters:**
- `track` (string, optional) — The song: a Shazam track key (e.g. 503576063), `apple:<Apple Music song id>` (e.g. apple:1499378607), an ISRC (e.g. USUG11904206), or a shazam.com / music.apple.com song link. A bare number is read as a Shazam key.
- `shazam_key` (string, optional) — Shazam track key (the number in shazam.com/track/<key>).
- `apple_id` (string, optional) — Apple Music song id (the number in shazam.com/song/<id>/…).
- `isrc` (string, optional) — ISRC of the recording.
- `country` (string, optional, default "us") — Apple Music storefront (2 letters) the names, availability and links are read in, e.g. us, gb, de, jp, br.
- `language` (string, optional) — Language for names and editorial text where the storefront has it (en, pt-BR, ja-JP…). Default: the storefront's own language.

**Returns:** track{shazam_key, apple_id, title, artist_name, album_name, isrc, genres[], primary_genre, composer, release_date, duration_ms, duration, track_number, disc_number, explicit, has_lyrics, lyrics_provider, preview_url, artwork, apple_music_url, shazam_url, label, released, album{album_id, name, record_label, upc, copyright, release_date, track_count, is_single, is_compilation, editorial_notes}, artists[]{artist_id, name, genres, shazam_url}, music_videos[]{video_id, title, duration_ms, has_4k, has_hdr, apple_music_url}, shazam_artists[], other_apple_ids[]}

**Example request body:**
```json
{
  "track": "503576063"
}
```

### POST https://api.reefapi.com/shazam/v1/tracks — 2 credits
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.

**Parameters:**
- `apple_ids` (array, optional) — Apple Music song ids, comma separated (max 50).
- `isrcs` (array, optional) — ISRCs, comma separated (max 25); every catalogue song carrying the ISRC is returned.
- `country` (string, optional, default "us") — Apple Music storefront (2 letters) the names, availability and links are read in, e.g. us, gb, de, jp, br.
- `language` (string, optional) — Language for names and editorial text where the storefront has it (en, pt-BR, ja-JP…). Default: the storefront's own language.

**Returns:** results[]{shazam_key, apple_id, title, artist_name, album_name, isrc, genres, release_date, duration_ms, explicit, has_lyrics, preview_url, artwork, apple_music_url, shazam_url} + count + not_found[]

**Example request body:**
```json
{
  "apple_ids": "1499378607,6796864754"
}
```

### POST https://api.reefapi.com/shazam/v1/track_insights — 3 credits
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).

**Parameters:**
- `track` (string, optional) — The song: a Shazam track key (e.g. 503576063), `apple:<Apple Music song id>` (e.g. apple:1499378607), an ISRC (e.g. USUG11904206), or a shazam.com / music.apple.com song link. A bare number is read as a Shazam key.
- `shazam_key` (string, optional) — Shazam track key (the number in shazam.com/track/<key>).
- `apple_id` (string, optional) — Apple Music song id (the number in shazam.com/song/<id>/…).
- `isrc` (string, optional) — ISRC of the recording.

**Returns:** insights{apple_id, shazam_key, title, artist_name, label, isrc, primary_genre, shazam_count, shazam_count_display, audio_analysis{bpm, energy, danceability, valence, acousticness, melodicness}, audio_analysis_note, popular_moments[]{label, time, seconds, position_percent}, release_statement, credits[]{name, apple_artist_id, group, roles[]}, similar_songs[]{apple_id, title, artist_name, shazam_url}, artist_top_songs[], lyrics{has_lyrics, provider, lyrics_type, time_synced, section_count, line_count, section_titles[]}, music_video_id, preview_url, cover_art, apple_album_id, apple_artist_id, shazam_url}

**Example request body:**
```json
{
  "track": "503576063"
}
```

### POST https://api.reefapi.com/shazam/v1/artist — 2 credits
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).

**Parameters:**
- `artist_id` (string, required) — Apple Music artist id (the number in shazam.com/artist/<name>/<id>).
- `country` (string, optional, default "us") — Apple Music storefront (2 letters) the names, availability and links are read in, e.g. us, gb, de, jp, br.
- `language` (string, optional) — Language for names and editorial text where the storefront has it (en, pt-BR, ja-JP…). Default: the storefront's own language.

**Returns:** artist{artist_id, name, genres, editorial_notes, artwork, apple_music_url, shazam_url} + top_songs[] + albums[] + singles[] + live_albums[] + compilations[] + appears_on[] + latest_release[] + similar_artists[] + top_music_videos[] + playlists[] + more{<list>: bool}

**Example request body:**
```json
{
  "artist_id": "479756766"
}
```

### POST https://api.reefapi.com/shazam/v1/artist_top_songs — 1 credit
An artist's top songs, paged (same song fields as chart rows).

**Parameters:**
- `artist_id` (string, required) — Apple Music artist id (the number in shazam.com/artist/<name>/<id>).
- `limit` (integer, optional, default 25) — Rows per page (1-50).
- `offset` (integer, optional, default 0) — Rows to skip (pagination; use `next_offset` from the previous page).
- `country` (string, optional, default "us") — Apple Music storefront (2 letters) the names, availability and links are read in, e.g. us, gb, de, jp, br.
- `language` (string, optional) — Language for names and editorial text where the storefront has it (en, pt-BR, ja-JP…). Default: the storefront's own language.

**Returns:** results[]{rank, apple_id, title, artist_name, album_name, isrc, genres, release_date, duration_ms, explicit, has_lyrics, preview_url, artwork, apple_music_url} + count + offset + next_offset + has_more

**Example request body:**
```json
{
  "artist_id": "479756766"
}
```

### POST https://api.reefapi.com/shazam/v1/artist_albums — 1 credit
An artist's releases of one kind (albums, singles & EPs, live, compilations, appears on), paged: label, UPC, copyright, release date, track count, editorial notes.

**Parameters:**
- `artist_id` (string, required) — Apple Music artist id (the number in shazam.com/artist/<name>/<id>).
- `kind` (enum, optional, default "albums") — Release kind. [one of: albums, singles, live, compilations, appears_on]
- `limit` (integer, optional, default 25) — Rows per page (1-50).
- `offset` (integer, optional, default 0) — Rows to skip (pagination; use `next_offset` from the previous page).
- `country` (string, optional, default "us") — Apple Music storefront (2 letters) the names, availability and links are read in, e.g. us, gb, de, jp, br.
- `language` (string, optional) — Language for names and editorial text where the storefront has it (en, pt-BR, ja-JP…). Default: the storefront's own language.

**Returns:** results[]{album_id, name, artist_name, record_label, upc, copyright, release_date, track_count, genres, is_single, is_compilation, explicit, editorial_notes, artwork, apple_music_url} + count + offset + next_offset + has_more + kind

**Example request body:**
```json
{
  "artist_id": "479756766"
}
```

### POST https://api.reefapi.com/shazam/v1/similar_artists — 1 credit
Artists similar to one artist, paged.

**Parameters:**
- `artist_id` (string, required) — Apple Music artist id (the number in shazam.com/artist/<name>/<id>).
- `limit` (integer, optional, default 25) — Rows per page (1-50).
- `offset` (integer, optional, default 0) — Rows to skip (pagination; use `next_offset` from the previous page).
- `country` (string, optional, default "us") — Apple Music storefront (2 letters) the names, availability and links are read in, e.g. us, gb, de, jp, br.
- `language` (string, optional) — Language for names and editorial text where the storefront has it (en, pt-BR, ja-JP…). Default: the storefront's own language.

**Returns:** results[]{artist_id, name, genres, editorial_notes, artwork, apple_music_url, shazam_url} + count + offset + next_offset + has_more

**Example request body:**
```json
{
  "artist_id": "479756766"
}
```

### POST https://api.reefapi.com/shazam/v1/artist_music_videos — 1 credit
An artist's top music videos, paged.

**Parameters:**
- `artist_id` (string, required) — Apple Music artist id (the number in shazam.com/artist/<name>/<id>).
- `limit` (integer, optional, default 25) — Rows per page (1-50).
- `offset` (integer, optional, default 0) — Rows to skip (pagination; use `next_offset` from the previous page).
- `country` (string, optional, default "us") — Apple Music storefront (2 letters) the names, availability and links are read in, e.g. us, gb, de, jp, br.
- `language` (string, optional) — Language for names and editorial text where the storefront has it (en, pt-BR, ja-JP…). Default: the storefront's own language.

**Returns:** results[]{video_id, title, artist_name, isrc, genres, release_date, duration_ms, has_4k, has_hdr, explicit, preview_url, artwork, apple_music_url} + count + offset + next_offset + has_more

**Example request body:**
```json
{
  "artist_id": "479756766"
}
```

### POST https://api.reefapi.com/shazam/v1/artist_insights — 3 credits
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.

**Parameters:**
- `artist_id` (string, required) — Apple Music artist id (the number in shazam.com/artist/<name>/<id>).

**Returns:** artist{apple_artist_id, name, about[]{label, value}, links[], shazam_top_tracks_this_week[], shazam_top_tracks_all_time[]{apple_id, title, artist_name, card_text, shazam_url}, chart_appearances_text[], similar_artists[], frequent_collaborators[], inspired_by[], bio, shazam_url}

**Example request body:**
```json
{
  "artist_id": "479756766"
}
```

### POST https://api.reefapi.com/shazam/v1/artist_events — 3 credits
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.

**Parameters:**
- `artist_id` (string, required) — Apple Music artist id (the number in shazam.com/artist/<name>/<id>).
- `include_past` (boolean, optional, default true) — Also list past shows (upcoming first, then past, newest first).
- `limit` (integer, optional, default 50) — Events per page (1-500).
- `offset` (integer, optional, default 0) — Rows to skip (pagination; use `next_offset` from the previous page).

**Returns:** on_tour + tour_status + total_events + upcoming_count + past_count + events[]{event_id, name, start_time, end_time, timezone, local_date, local_start, is_future, tickets_url, ticket_provider, shazam_url, venue{name, address[], city, region, postcode, country, country_code, latitude, longitude}, artists[]} + countries[] + count + offset + has_more

**Example request body:**
```json
{
  "artist_id": "479756766"
}
```

### POST https://api.reefapi.com/shazam/v1/events — 3 credits
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.

**Parameters:**
- `country` (string, optional, default "united-states") — Country: code (DE), name (Germany) or url name (germany). Ignored when city is given.
- `city` (string, optional) — City name; the site lists the area around it (e.g. New York, Berlin, London).
- `date` (enum, optional, default "all") — Date filter. [one of: all, today, tomorrow, this_weekend, custom]
- `start_date` (string, optional) — YYYY-MM-DD, with date=custom.
- `end_date` (string, optional) — YYYY-MM-DD, with date=custom.
- `genres` (array, optional) — Genre names or Apple genre ids, comma separated (pop, rock, hip-hop-rap, r&b-soul, alternative, electronic, country, latin, jazz, metal, k-pop...). `genres_available` lists what the location has.
- `artist_id` (string, optional) — Only this artist's concerts (Apple Music artist id).

**Returns:** filters{location, country_code, bounding_box, date, date_from, date_to, artist, genres} + genres_available[]{genre_id, name, events} + events[]{event_id, name, start_time, end_time, timezone, local_date, local_start, tickets_url, ticket_provider, venue{...}, artists[], shazam_url} + count + site_list_limit

**Example request body:**
```json
{
  "country": "germany"
}
```

### POST https://api.reefapi.com/shazam/v1/event — 3 credits
One concert on Shazam: date and time, venue with address and coordinates, ticket link and provider, artists.

**Parameters:**
- `event_id` (string, required) — Shazam event id (uuid) from artist_events or shazam.com/event/<id>.

**Returns:** event{event_id, name, start_time, end_time, timezone, local_date, local_start, duration_hours, announced_at, is_future, tickets_url, ticket_provider, venue{…}, artists[], shazam_url}

**Example request body:**
```json
{
  "event_id": "ed82d858-2e3d-446d-b3fe-1809e967beaa"
}
```

### POST https://api.reefapi.com/shazam/v1/album — 2 credits
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).

**Parameters:**
- `album_id` (string, required) — Apple Music album id (shazam.com/album/<id>/…).
- `country` (string, optional, default "us") — Apple Music storefront (2 letters) the names, availability and links are read in, e.g. us, gb, de, jp, br.
- `language` (string, optional) — Language for names and editorial text where the storefront has it (en, pt-BR, ja-JP…). Default: the storefront's own language.
- `include_shazam_keys` (boolean, optional, default true) — Add each track's Shazam key (one extra lookup per 50 tracks).

**Returns:** album{album_id, name, artist_name, record_label, upc, copyright, release_date, track_count, genres, is_single, is_compilation, editorial_notes, artwork, apple_music_url, shazam_url, artists[], tracks[]{shazam_key, apple_id, title, track_number, disc_number, isrc, duration_ms, …}} + other_versions[] + related_albums[] + appears_on[] + music_videos[]

**Example request body:**
```json
{
  "album_id": "1499378108"
}
```

### POST https://api.reefapi.com/shazam/v1/album_related — 1 credit
Albums related to one album (related albums, other versions, featured on) or its music videos, paged.

**Parameters:**
- `album_id` (string, required) — Apple Music album id (shazam.com/album/<id>/…).
- `view` (enum, optional, default "related_albums") — Which list. [one of: related_albums, other_versions, appears_on, music_videos]
- `limit` (integer, optional, default 25) — Rows per page (1-50).
- `offset` (integer, optional, default 0) — Rows to skip (pagination; use `next_offset` from the previous page).
- `country` (string, optional, default "us") — Apple Music storefront (2 letters) the names, availability and links are read in, e.g. us, gb, de, jp, br.
- `language` (string, optional) — Language for names and editorial text where the storefront has it (en, pt-BR, ja-JP…). Default: the storefront's own language.

**Returns:** results[] (albums or music videos) + count + offset + next_offset + has_more + view

**Example request body:**
```json
{
  "album_id": "1499378108"
}
```

### POST https://api.reefapi.com/shazam/v1/search — 1 credit
Search Shazam's catalogue (what the shazam.com search box searches): songs, artists, albums, music videos or playlists, paged.

**Parameters:**
- `query` (string, required) — Search words.
- `types` (array, optional, default "songs,artists") — Comma separated: songs, artists, albums, music_videos, playlists (singular accepted).
- `limit` (integer, optional, default 10) — Rows per type (1-25, the source's own maximum).
- `offset` (integer, optional, default 0) — Rows to skip (pagination; use `next_offset` from the previous page).
- `country` (string, optional, default "us") — Apple Music storefront (2 letters) the names, availability and links are read in, e.g. us, gb, de, jp, br.
- `language` (string, optional) — Language for names and editorial text where the storefront has it (en, pt-BR, ja-JP…). Default: the storefront's own language.

**Returns:** results{songs[], artists[], albums[], music_videos[], playlists[]} (each row has `kind`) + counts + offset + next_offset{<type>: int|null} + query

**Example request body:**
```json
{
  "query": "blinding lights",
  "types": "songs"
}
```

### POST https://api.reefapi.com/shazam/v1/autocomplete — 1 credit
Search suggestions as you type: suggested search terms and top matching songs, artists and albums.

**Parameters:**
- `query` (string, required) — The text typed so far.
- `country` (string, optional, default "us") — Apple Music storefront (2 letters) the names, availability and links are read in, e.g. us, gb, de, jp, br.
- `language` (string, optional) — Language for names and editorial text where the storefront has it (en, pt-BR, ja-JP…). Default: the storefront's own language.

**Returns:** terms[]{term, display} + top_results[] (rows with `kind`) + query

**Example request body:**
```json
{
  "query": "blinding lights"
}
```

### POST https://api.reefapi.com/shazam/v1/recognize — 3 credits
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.

**Parameters:**
- `audio_url` (string, optional) — Public link to an audio or video file (mp3, m4a, aac, ogg, opus, flac, wav, mp4, webm…), at most 8 MB.
- `audio_base64` (string, optional) — The audio file itself, base64 encoded (at most ~3 MB of audio).
- `segment_seconds` (integer, optional, default 12) — Seconds of audio fingerprinted, taken from the middle (3-12).

**Returns:** matched + track{shazam_key, apple_id, title, artist_name, isrc, album_name, label, released, primary_genre, cover_art, preview_url, shazam_url} + matches[]{shazam_key, offset_seconds, time_skew, frequency_skew} + audio{bytes, seconds_fingerprinted, peaks}

**Example request body:**
```json
{
  "audio_url": "https://example.com/clip.mp3"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=shazam
- Human docs page: https://reefapi.com/docs/shazam
- Overview page: https://reefapi.com/shazam-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
