Apple Music API & Scraper
This API reads the public Apple Music catalogue as JSON, logged out, in any of Apple's 172 storefronts (countries).
🤖 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.
`song` returns a song with its ISRC, composers, duration, track and disc number, release date, genres, audio traits (lossless, Dolby Atmos, spatial), whether lyrics exist, the 30-second preview link, its album, artists and radio station. `album` returns the album's UPC, record label, copyright line, release date, Apple's editorial review and the full tracklist with every track's ISRC and duration. `songs_by_isrc` and `albums_by_upc` find every catalogue item carrying a code. `artist` returns the whole artist page in one call: biography, origin, born or formed, genre, latest release and 14 shelves (top songs, essential albums, albums, singles and EPs, live albums, compilations, appears on, top videos, music videos, playlists, similar artists, radio shows and more), the main ones pageable with their own action. `charts` returns Apple's most-played Top Songs, Top Albums, Top Playlists or Top Music Videos of a country, overall or for one genre, up to 200 rows. `daily_top_100` and `city_top_25` return today's chart playlists for 116 regions and 106 cities. `search`, `autocomplete`, `playlist` with every track, `music_video`, the Browse and Radio pages, genres, record labels, curators, radio stations and `store_lookup` with iTunes Store prices complete it.
What an Apple Music field actually contains
Fields that read differently from how they look. Every row was measured against live Apple Music on 2026-11-16.
| Field | What it holds |
|---|---|
| isrc | The recording's ISRC. Present on every song checked: 275 of 275 chart and search rows in the US, Turkey, Japan, Brazil and India. One ISRC can belong to several catalogue songs (single, album, deluxe); songs_by_isrc returns all of them, including uploads by other artists that Apple lists under the same code. |
| upc | The album's barcode as Apple prints it, with leading zeros (1989 (Taylor's Version): 00602458615982). Present on 150 of 150 albums checked. Some distributors reuse codes: 0000000000017 matches 4 unrelated singles, 4006381333931 matches 3. |
| record_label / copyright | record_label is the label name Apple shows under the album; copyright is the ℗ line (℗ 2023 Taylor Swift). Both filled on 150 of 150 albums. record_labels[] (a label with its own Apple Music page) was filled on 1 of 30 chart albums. |
| release_date | The album or song release date. It matched the date on the album's music.apple.com page for 10 of 10 albums checked; pre-release albums carry a future date. |
| duration_ms / duration | Track length in milliseconds and as m:ss. It matched the album page's track length (whole seconds) for 83 of 83 tracks on 10 albums. |
| rank (charts) | Position in Apple's most-played chart. The US Top Songs order was identical to Apple's own public RSS chart for 50 of 50 positions on 2026-11-16. |
| has_lyrics | True when Apple has lyrics for the song. The lyrics text itself needs an Apple Music subscription and is not returned. |
| content_rating / explicit | content_rating is "explicit" or "clean" when Apple marks the item; absent means unrated. US Top Songs on 2026-11-16: 30 of 50 explicit. explicit is true only for "explicit". |
| track_price / collection_price | From store_lookup: the iTunes Store price in the country's currency (US: song 1.29 or 0.69 USD, 1989 (Taylor's Version) 13.99 USD). Apple Music itself publishes no prices and no play counts. |
Apple publishes no play or stream counts anywhere on its public surface; chart rank is the popularity signal.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/apple-music/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "taylor swift",
"type": "songs"
}
}{
"ok": true,
"meta": {
"api": "apple-music",
"endpoint": "search",
"mode": "live",
"latency_ms": 564.4,
"record_count": 25,
"bytes": 31735,
"cache_hit": false,
"type": "songs",
"billed_units": 1,
"upstream_requests": 1,
"charged_credits": 2,
"version": "0.1.0",
"request_id": "784648c40ab8447f",
"queue_ms": 2.5,
"fetched_at": "2026-11-16T21:05:21.603Z"
},
"data": {
"query": "taylor swift",
"type": "songs",
"country": "us",
"results": [
{
"id": "6814997425",
"type": "song",
"album_artist_name": "Taylor Swift",
"album_name": "The Life of a Showgirl: The Encore",
"artist_name": "Taylor Swift",
"artwork": {
"bg_color": "2b080c",
"has_p3": false,
"height": 3000,
"text_color1": "e2a971",
"text_color2": "e5693c",
"text_color3": "bd895d",
"text_color4": "c05532",
"width": 3000,
"url": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a0/dd/fd/a0ddfd72-ee9e-f046-6466-a5dbefc696fa/26UM1IM21436.rgb.jpg/3000x3000bb.jpg",
"url_template": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a0/dd/fd/a0ddfd72-ee9e-f046-6466-a5dbefc696fa/26UM1IM21436.rgb.jpg/{w}x{h}bb.jpg"
},
"audio_locale": "en-US",
"audio_traits": [
"atmos",
"lossless",
"lossy-stereo"
],
"composer_name": "Taylor Swift, Max Martin & Shellback",
"disc_number": 2,
"duration_ms": 225868,
"genre_names": [
"Pop",
"Music"
],
"has_lyrics": true,
"has_time_synced_lyrics": true,
"is_apple_digital_master": true,
"is_mastered_for_itunes": true,
"is_vocal_attenuation_allowed": true,
"isrc": "USUG12602391",
"name": "Patient Zero",
"play_params": {
"id": "6814997425",
"kind": "song"
},
"previews": [
{
"url": "[trimmed-depth]"
}
],
"release_date": "2026-09-24",
"track_number": 1,
"url": "https://music.apple.com/us/album/patient-zero/6814997249?i=6814997425",
"duration": "3:46",
"preview_url": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview221/v4/db/e7/50/dbe750f6-2ca3-d653-06cc-d610343c8ccf/mzaf_5049966821173000314.plus.aac.ep.m4a",
"explicit": false,
"album_id": "6814997249"
},
{
"id": "1833328840",
"type": "song",
"album_artist_name": "Taylor Swift",
"album_name": "The Life of a Showgirl",
"artist_name": "Taylor Swift",
"artwork": {
"bg_color": "4c592e",
"has_p3": false,
"height": 3000,
"text_color1": "c7ebd0",
"text_color2": "acdcc4",
"text_color3": "aeceb0",
"text_color4": "98c2a6",
"width": 3000,
"url": "https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/2d/46/e0/2d46e0bc-8ab9-85dd-4b56-ee6951351034/25UM1IM19577.rgb.jpg/3000x3000bb.jpg",
"url_template": "https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/2d/46/e0/2d46e0bc-8ab9-85dd-4b56-ee6951351034/25UM1IM19577.rgb.jpg/{w}x{h}bb.jpg"
},
"audio_locale": "en-US",
"audio_traits": [
"atmos",
"lossless",
"lossy-stereo"
],
"composer_name": "Taylor Swift, Max Martin & Shellback",
"disc_number": 1,
"duration_ms": 226074,
"genre_names": [
"Pop",
"Music"
],
"has_lyrics": true,
"has_time_synced_lyrics": true,
"is_apple_digital_master": true,
"is_mastered_for_itunes": true,
"is_vocal_attenuation_allowed": true,
"isrc": "USUG12506436",
"name": "The Fate of Ophelia",
"play_params": {
"id": "1833328840",
"kind": "song"
},
"previews": [
{
"url": "[trimmed-depth]"
}
],
"release_date": "2025-10-03",
"track_number": 1,
"url": "https://music.apple.com/us/album/the-fate-of-ophelia/1833328839?i=1833328840",
"duration": "3:46",
"preview_url": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview211/v4/d0/bd/be/d0bdbe9b-5c7c-7335-bc61-54418cd3824c/mzaf_6827149424654259056.plus.aac.ep.m4a",
"explicit": false,
"album_id": "1833328839"
},
{
"id": "6775527443",
"type": "song",
"album_artist_name": "Taylor Swift",
"album_name": "I Knew It, I Knew You (From \"Toy Story 5\") - Single",
"artist_name": "Taylor Swift",
"artwork": {
"bg_color": "9b211c",
"has_p3": false,
"height": 3000,
"text_color1": "fde8be",
"text_color2": "f1b665",
"text_color3": "e9c09d",
"text_color4": "df9956",
"width": 3000,
"url": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/34/35/6c/34356cb4-bd0b-3bac-b118-1a6d7264dc64/26UMGIM69942.rgb.jpg/3000x3000bb.jpg",
"url_template": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/34/35/6c/34356cb4-bd0b-3bac-b118-1a6d7264dc64/26UMGIM69942.rgb.jpg/{w}x{h}bb.jpg"
},
"audio_locale": "en-US",
"audio_traits": [
"atmos",
"lossless",
"lossy-stereo"
],
"composer_name": "Taylor Swift & Jack Antonoff",
"disc_number": 1,
"duration_ms": 178186,
"genre_names": [
"Country",
"Music"
],
"has_lyrics": true,
"has_time_synced_lyrics": true,
"is_apple_digital_master": true,
"is_mastered_for_itunes": true,
"is_vocal_attenuation_allowed": true,
"isrc": "USWD12641055",
"name": "I Knew It, I Knew You (From \"Toy Story 5\")",
"play_params": {
"id": "6775527443",
"kind": "song"
},
"previews": [
{
"url": "[trimmed-depth]"
}
],
"release_date": "2026-06-05",
"track_number": 1,
"url": "https://music.apple.com/us/album/i-knew-it-i-knew-you-from-toy-story-5/6775527442?i=6775527443",
"duration": "2:58",
"preview_url": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview221/v4/73/76/42/737642e6-c478-bed7-f11f-efee96072450/mzaf_12192094637498612451.plus.aac.ep.m4a",
"explicit": false,
"album_id": "6775527442"
}
],
"count": 25,
"offset": 0,
"limit": 25,
"next_offset": 25,
"has_more": true
}
}What the Apple Music API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search the Apple Music catalogue of one country. `type=all` returns Apple's own mixed result page: top results plus songs, albums, artists, playlists, music videos, stations curators and record labels — Apple trims the weaker artist / playlist / video matches there (bad bunny: 1 artist with type=all, 10 with type=artists). One type returns that type in full with paging. Apple serves at most 200 results per type per query and at most 50 per call (both measured). | Content platforms call search to search the Apple Music catalogue of one country. | query, type, limit, offset, country, ... |
| autocomplete | Apple Music search-box suggestions for a partial query: completed search terms plus the top matching songs, albums, artists, playlists, music videos and stations. | Research tools call autocomplete to get apple Music search-box suggestions for a partial query. | query, country, language |
| song | One song: name, artists, album, ISRC, composer(s), duration, track and disc number, release date, genres, audio traits (lossless, Dolby Atmos, spatial), Apple Digital Master, lyrics available (yes/no; the lyrics text needs a subscriber login), 30-second preview, artwork, its album, artists, composers, genres, music videos and the song's radio station. | Community analysts call song to get one song. | song_id, url, country, language |
| songs_by_isrc | Every Apple Music song carrying one ISRC in a country (single, album, deluxe and compilation versions; also mis-tagged uploads Apple lists under the same code). Apple's order, nothing picked. | Media monitors call songs_by_isrc to get every Apple Music song carrying one ISRC in a country (single, album, deluxe and compilation…. | isrc, country, language |
| songs | Up to 200 songs by id in ONE request (Apple answers them together). Ids Apple does not know in that country are listed in `not_found`. | Content platforms call songs to get up to 200 songs by id in ONE request (Apple answers them together). | song_ids, country, language |
| album | One album: name, artist, UPC, record label, copyright line (℗), release date, track count, genres, single / compilation / complete flags, audio traits, editorial notes (Apple's review text), artwork and the FULL tracklist (every song and video with ISRC, composer, duration, track/disc number, preview), total duration, artists and record label pages. | Research tools call album to get one album. | album_id, url, country, language |
| albums_by_upc | Every Apple Music album carrying one UPC / EAN barcode in a country (explicit and clean editions can share it). Matched on the code without leading zeros. | Community analysts call albums_by_upc to get every Apple Music album carrying one UPC / EAN barcode in a country (explicit and clean editi…. | upc, country, language |
| album_related | The shelves of an album page: other versions, more by the artist, you might also like, playlists that feature it, its music videos and audio extras. | Media monitors call album_related to get the shelves of an album page. | album_id, url, country, language |
| artist | The whole artist page: name, biography, origin, born / formed, genres, artwork, the artist's radio station and every shelf with its first rows — latest release, top songs, essential albums, albums, singles & EPs, live albums, compilations, appears on, top videos, music videos, artist playlists, similar artists, radio shows, more to hear, more to see. Page any shelf with the matching artist_* action. | Content platforms call artist to get the whole artist page. | artist_id, url, country, language |
| artist_songs | An artist's most-played songs on Apple Music, ranked (Apple's own Top Songs order). | Research tools call artist_songs to get an artist's most-played songs on Apple Music, ranked (Apple's own Top Songs order).. | artist_id, url, limit, offset, country, ... |
| artist_albums | An artist's albums by kind: the full discography, studio albums, singles & EPs, live, compilations, appears-on or essential albums. | Community analysts call artist_albums to get an artist's albums by kind. | artist_id, url, type, limit, offset, ... |
| artist_music_videos | An artist's music videos: all (newest first) or top (most watched, Apple's order). | Media monitors call artist_music_videos to get an artist's music videos. | artist_id, url, type, limit, offset, ... |
| artist_playlists | The artist's playlists on Apple Music (Essentials, Video Essentials, Set List, Next Steps, Inspired By, Influences, deep cuts, …). | Content platforms call artist_playlists to get the artist's playlists on Apple Music (Essentials, Video Essentials, Set List, Next Steps, In…. | artist_id, url, limit, offset, country, ... |
| similar_artists | Artists Apple Music lists as similar to one artist. | Research tools call similar_artists to get artists Apple Music lists as similar to one artist.. | artist_id, url, limit, offset, country, ... |
| playlist | One playlist: name, curator, description, editorial notes, type (editorial / external / chart …), last modified date, chart flag, artwork, its first 100 tracks numbered by position, featured artists and more playlists by the same curator. | Community analysts call playlist to get one playlist. | playlist_id, url, country, language |
| playlist_tracks | One page of a playlist's tracks, numbered by position (Apple serves up to 100 per call). | Media monitors call playlist_tracks to get one page of a playlist's tracks, numbered by position (Apple serves up to 100 per call).. | playlist_id, url, limit, offset, country, ... |
| music_video | One music video: name, artist, ISRC, duration, release date, genres, 4K / HDR flags, preview (HLS + image), artwork, its artists, album and the songs it features, plus the page's more-by-artist and more-in-genre shelves. | Content platforms call music_video to get one music video. | video_id, url, country, language |
| charts | Apple Music's most-played chart of one country: Top Songs, Top Albums, Top Playlists or Top Music Videos, overall or for one genre, ranked, up to 200 rows per call. | Research tools call charts to get apple Music's most-played chart of one country. | type, genre, limit, offset, country, ... |
| chart_playlists | Every Daily Top 100 chart playlist (Global + one per country) or every City Top 25 chart playlist (cities worldwide), with the region / city and playlist id. | Community analysts call chart_playlists to get every Daily Top 100 chart playlist (Global + one per country) or every City Top 25 chart play…. | kind, language |
| daily_top_100 | Today's Top 100 songs of one region on Apple Music (Global or a country), ranked, from Apple's Daily Top 100 chart playlist. | Media monitors call daily_top_100 to get today's Top 100 songs of one region on Apple Music (Global or a country), ranked, from Apple'…. | region, language |
| city_top_25 | Today's Top 25 songs in one city on Apple Music (Apple's City Top 25 chart playlist). | Content platforms call city_top_25 to get today's Top 25 songs in one city on Apple Music (Apple's City Top 25 chart playlist).. | city, language |
| browse | Apple Music's Browse page of one country: every shelf (featured banners, Best New Songs, New This Week, Recent Releases, Updated Playlists, Trending Songs, Daily Top 100, City Charts, live radio, new music videos, Coming Soon, …) with its rows and the `see_all_id` to page it with `browse_section`. | Research tools call browse to get apple Music's Browse page of one country. | country, language |
| radio | Apple Music's Radio page of one country: live stations on air, radio shows, new episodes, interviews, hosts and broadcasters, as shelves. | Community analysts call radio to get apple Music's Radio page of one country. | country, language |
| browse_section | Every row of one editorial "see all" section (a Browse / Radio / genre page shelf), paged and sorted the way the section allows. Give a `see_all_id` from browse / radio / genre, or a Browse shortcut name. | Media monitors call browse_section to get every row of one editorial "see all" section (a Browse / Radio / genre page shelf), paged and…. | section, sort, limit, offset, country, ... |
| genres | The top-level genres of one country's catalogue (they differ per country; e.g. India has Bollywood, Tamil, Telugu). Ids work as `genre` in charts and `genre_id` in genre. | Content platforms call genres to get the top-level genres of one country's catalogue (they differ per country; e.g. | country, language |
| genre | One genre's editorial page in a country: its shelves (featured playlists, new releases, essentials, artist playlists, …) with rows and see-all ids. | Research tools call genre to get one genre's editorial page in a country. | genre, country, language |
| record_label | One record label page: name, description, artwork and the first latest and top releases. | Community analysts call record_label to get one record label page. | label_id, url, country, language |
| record_label_releases | A record label's releases: latest (newest first) or top (most popular), paged. | Media monitors call record_label_releases to get a record label's releases. | label_id, url, type, limit, offset, ... |
| curator | One curator: an Apple Music editorial brand or radio show (Apple Music Hits, Apple Music Pop, …) or an external curator (Pitchfork, labels, magazines): name, kind, description, artwork, first playlists and — for Apple curators — the curator page's shelves. | Content platforms call curator to get one curator. | curator_id, url, country, language |
| curator_playlists | Every playlist one curator publishes, paged (Apple's cap: 25 per call for Apple curators, 10 for external curators). | Research tools call curator_playlists to get every playlist one curator publishes, paged (Apple's cap. | curator_id, url, limit, offset, country, ... |
| stations_live | Apple Music's live radio stations in one country (Apple Music 1, Hits, Country, Música Uno, Club, Chill, seasonal stations). | Community analysts call stations_live to get apple Music's live radio stations in one country (Apple Music 1, Hits, Country, Música Uno, C…. | country, language |
| station | One radio station: live station, artist / song station, radio show episode or broadcaster. | Media monitors call station to get one radio station. | station_id, url, country, language |
| countries | Every Apple Music storefront (country) with its code, name, default and supported language tags and explicit-content policy. | Content platforms call countries to get every Apple Music storefront (country) with its code, name, default and supported language ta…. | language |
| store_lookup | The iTunes Store's own record for Apple ids (songs, albums, artists, music videos) — the only public Apple surface with STORE PRICES: track and album price, currency, explicitness, preview, primary genre, AMG artist id. Up to 200 ids in one request; `entity=song` adds an album's tracks with their prices. | Research tools call store_lookup to get the iTunes Store's own record for Apple ids (songs, albums, artists, music videos). | ids, upc, entity, country |
Call search from your stack
curl -X POST https://api.reefapi.com/apple-music/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"taylor swift","type":"songs"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/apple-music/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "taylor swift",
"type": "songs"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/apple-music/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "taylor swift",
"type": "songs"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.apple-music.search with {"query":"taylor swift","type":"songs"}.Who uses this API and why
- ISRC and UPC matching: Map your catalogue to Apple Music: look songs up by ISRC and albums by UPC in each country, with label, copyright and release date.
- Chart tracking: Store the most-played Top Songs and Albums per country and genre, the Daily Top 100 of 116 regions and 106 City charts every day.
- Release monitoring: Follow New This Week, Recent Releases and Coming Soon, a record label's latest releases or an artist's newest singles.
- Artist research: Biography, origin, discography by type, top songs, similar artists and playlists for any artist, in any country.
- Store pricing: Read iTunes Store song and album prices per country for up to 200 ids in one call.
Questions developers ask before integrating
Does it return ISRC and UPC codes?
Yes. Every song row carries its ISRC (275 of 275 rows checked across 5 countries) and every album its UPC (150 of 150). You can also go the other way: songs_by_isrc and albums_by_upc return every catalogue item with that code.
Which countries are covered?
All 172 Apple Music storefronts. Pass `country` as a two-letter code (us, gb, de, jp, br, in, tr, …); the catalogue, charts and editorial pages are per country. `countries` lists them with their languages, and `language` switches the display language where the storefront supports it.
Can I get play counts or stream numbers?
No. Apple Music does not publish play counts. The chart rank (charts, daily_top_100, city_top_25) and the order of an artist's Top Songs are the popularity signals Apple shows.
Can I get lyrics?
has_lyrics and has_time_synced_lyrics say whether Apple has them. The lyrics text needs a signed-in Apple Music subscriber and is not returned.
How deep do search and lists go?
Search returns up to 50 rows per call and stops at 200 results per type for one query. Charts return up to 200 rows per call. Artist shelves, playlist tracks, label releases and Browse sections return up to 100 per call and page with `offset`; pass `next_offset` from the previous call.
Do I get prices?
Yes, through store_lookup: the iTunes Store's own track and album prices with currency for up to 200 ids per call (US: songs 0.69 or 1.29 USD, 1989 (Taylor's Version) 13.99 USD).
What do the Daily Top 100 and City Top 25 cover?
116 Daily Top 100 charts (Global plus 115 countries) and 106 City Top 25 charts. chart_playlists lists them; daily_top_100 takes global or a country, city_top_25 a city name. Each returns the ranked songs with ISRC and duration.
Does it need an Apple account?
No. Everything comes from Apple Music's public, logged-out catalogue.
What is the Apple Music API?
Apple Music API is a ReefAPI endpoint group for songs with isrc, albums with upc and label, artists, playlists, charts per country and genre, daily top 100 and city charts, search and itunes prices. It returns live JSON through POST requests under /apple-music/v1.
Is the Apple Music API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Apple Music calls use the same shared credit balance as every other ReefAPI engine.
Do I need an Apple Music login or account?
No login to Apple Music 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 Apple Music data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Apple Music API use?
Apple Music actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Apple Music from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call apple-music actions with the same key, credit pool and JSON envelope used by normal REST requests.