# Apple Music API — songs with ISRC, albums with UPC and label, artists, playlists, charts per country and genre, Daily Top 100 and City charts, search, music videos, radio, prices

> 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).
> ReefAPI engine `apple-music` · 34 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/apple-music/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/apple-music/v1/search — 2 credits
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).

**Parameters:**
- `query` (string, required) — Search words (any language).
- `type` (enum, optional, default "all") — Which result type. [one of: all, songs, albums, artists, playlists, music_videos, stations, curators, record_labels]
- `limit` (integer, optional, default 25) — Rows per type (Apple's cap: 50; default 25, or 10 per type with type=all).
- `offset` (integer, optional, default 0) — Where to start (one type only). Apple stops at 200 results per type; pass `next_offset` for the next page.
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** type=all: query + top_results[] + songs[] + albums[] + artists[] + playlists[] + music_videos[] + stations[] + curators[] + record_labels[] + has_more{<type>: bool}. One type: results[] + count + offset + next_offset + has_more. Rows carry every attribute Apple publishes for the item (song: name, artist_name, album_name, isrc, duration_ms, release_date, genre_names, composer_name, preview_url, artwork, url, explicit, audio_traits, …).

**Example request body:**
```json
{
  "query": "taylor swift",
  "type": "songs"
}
```

### POST https://api.reefapi.com/apple-music/v1/autocomplete — 1 credit
Apple Music search-box suggestions for a partial query: completed search terms plus the top matching songs, albums, artists, playlists, music videos and stations.

**Parameters:**
- `query` (string, required) — What has been typed so far.
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** query + suggestions[] (search terms) + top_results[] (typed items)

**Example request body:**
```json
{
  "query": "taylor swift"
}
```

### POST https://api.reefapi.com/apple-music/v1/song — 1 credit
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.

**Parameters:**
- `song_id` (string, optional) — Apple Music song id (the `i=` number of an album track link, or /song/<slug>/<id>).
- `url` (string, optional) — A music.apple.com link instead of the id (its country is used too).
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** song{id, name, artist_name, album_name, album_artist_name, isrc, composer_name, duration_ms, duration, track_number, disc_number, release_date, genre_names, audio_traits, audio_locale, has_lyrics, has_time_synced_lyrics, is_apple_digital_master, is_mastered_for_itunes, explicit, content_rating, preview_url, previews, artwork, editorial_artwork, url, album_id, …} + album + artists[] + composers[] + genres[] + music_videos[] + radio_station

**Example request body:**
```json
{
  "url": "https://music.apple.com/us/album/1989-taylors-version/1708308989"
}
```

### POST https://api.reefapi.com/apple-music/v1/songs_by_isrc — 1 credit
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.

**Parameters:**
- `isrc` (string, required) — 12-character ISRC, e.g. USUG11901472.
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** isrc + songs[] (full song records) + count

**Example request body:**
```json
{
  "isrc": "USUG11901472"
}
```

### POST https://api.reefapi.com/apple-music/v1/songs — 1 credit
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`.

**Parameters:**
- `song_ids` (array, required) — Comma-separated (or array) song ids, at most 200.
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** songs[] (full song records, request order) + count + not_found[]

**Example request body:**
```json
{
  "song_ids": "1468058171,1844932150"
}
```

### POST https://api.reefapi.com/apple-music/v1/album — 1 credit
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.

**Parameters:**
- `album_id` (string, optional) — Apple Music album id (/album/<slug>/<id>).
- `url` (string, optional) — A music.apple.com link instead of the id (its country is used too).
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** album{id, name, artist_name, upc, record_label, copyright, release_date, track_count, genre_names, is_single, is_compilation, is_complete, is_prerelease, is_mastered_for_itunes, audio_traits, content_rating, explicit, editorial_notes{standard, short}, plain_editorial_notes, editorial_artwork, artwork, url} + tracks[]{position, song record} + track_rows + total_duration_ms + total_duration + artists[] + record_labels[] + genres[]

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

### POST https://api.reefapi.com/apple-music/v1/albums_by_upc — 1 credit
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.

**Parameters:**
- `upc` (string, required) — UPC / EAN, 12-14 digits.
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** upc + albums[] (album records) + count

**Example request body:**
```json
{
  "upc": "00602458615982"
}
```

### POST https://api.reefapi.com/apple-music/v1/album_related — 1 credit
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.

**Parameters:**
- `album_id` (string, optional) — Apple Music album id.
- `url` (string, optional) — A music.apple.com link instead of the id (its country is used too).
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** album{id, name, url} + other_versions + more_by_artist + you_might_also_like + featured_in_playlists + music_videos + audio_extras (each {title, items[], count, has_more, next_offset})

**Example request body:**
```json
{
  "url": "https://music.apple.com/us/album/1989-taylors-version/1708308989"
}
```

### POST https://api.reefapi.com/apple-music/v1/artist — 1 credit
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.

**Parameters:**
- `artist_id` (string, optional) — Apple Music artist id (/artist/<slug>/<id>).
- `url` (string, optional) — A music.apple.com link instead of the id (its country is used too).
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** artist{id, name, artist_bio, origin, born_or_formed, genre_names, artwork, editorial_artwork, editorial_notes, plain_editorial_notes, hero, url} + genres[] + radio_station + shelves{latest_release, top_songs, essential_albums, albums, singles_and_eps, live_albums, compilations, appears_on, top_music_videos, music_videos, artist_playlists, similar_artists, radio_shows, more_to_hear, more_to_see: {title, items[], count, has_more, next_offset}}

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

### POST https://api.reefapi.com/apple-music/v1/artist_songs — 1 credit
An artist's most-played songs on Apple Music, ranked (Apple's own Top Songs order).

**Parameters:**
- `artist_id` (string, optional) — Apple Music artist id.
- `url` (string, optional) — A music.apple.com link instead of the id (its country is used too).
- `limit` (integer, optional, default 20) — Rows per call (Apple's own cap for this list: 100).
- `offset` (integer, optional, default 0) — Where to start. Pass the previous call's `next_offset` to get the next page (Apple's own next offset; it can skip a hidden item).
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** artist_id + songs[]{rank, song record} + count + offset + next_offset + has_more

**Example request body:**
```json
{
  "url": "https://music.apple.com/us/album/1989-taylors-version/1708308989"
}
```

### POST https://api.reefapi.com/apple-music/v1/artist_albums — 1 credit
An artist's albums by kind: the full discography, studio albums, singles & EPs, live, compilations, appears-on or essential albums.

**Parameters:**
- `artist_id` (string, optional) — Apple Music artist id.
- `url` (string, optional) — A music.apple.com link instead of the id (its country is used too).
- `type` (enum, optional, default "all") — Which albums. [one of: all, albums, singles, live, compilations, appears_on, essential]
- `limit` (integer, optional, default 25) — Rows per call (Apple's own cap for this list: 100).
- `offset` (integer, optional, default 0) — Where to start. Pass the previous call's `next_offset` to get the next page (Apple's own next offset; it can skip a hidden item).
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** artist_id + type + albums[] + count + offset + next_offset + has_more

**Example request body:**
```json
{
  "url": "https://music.apple.com/us/album/1989-taylors-version/1708308989"
}
```

### POST https://api.reefapi.com/apple-music/v1/artist_music_videos — 1 credit
An artist's music videos: all (newest first) or top (most watched, Apple's order).

**Parameters:**
- `artist_id` (string, optional) — Apple Music artist id.
- `url` (string, optional) — A music.apple.com link instead of the id (its country is used too).
- `type` (enum, optional, default "all") [one of: all, top]
- `limit` (integer, optional, default 25) — Rows per call (Apple's own cap for this list: 100).
- `offset` (integer, optional, default 0) — Where to start. Pass the previous call's `next_offset` to get the next page (Apple's own next offset; it can skip a hidden item).
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** artist_id + type + music_videos[] + count + offset + next_offset + has_more

**Example request body:**
```json
{
  "url": "https://music.apple.com/us/album/1989-taylors-version/1708308989"
}
```

### POST https://api.reefapi.com/apple-music/v1/artist_playlists — 1 credit
The artist's playlists on Apple Music (Essentials, Video Essentials, Set List, Next Steps, Inspired By, Influences, deep cuts, …).

**Parameters:**
- `artist_id` (string, optional) — Apple Music artist id.
- `url` (string, optional) — A music.apple.com link instead of the id (its country is used too).
- `limit` (integer, optional, default 25) — Rows per call (Apple's own cap for this list: 100).
- `offset` (integer, optional, default 0) — Where to start. Pass the previous call's `next_offset` to get the next page (Apple's own next offset; it can skip a hidden item).
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** artist_id + playlists[] + count + offset + next_offset + has_more

**Example request body:**
```json
{
  "url": "https://music.apple.com/us/album/1989-taylors-version/1708308989"
}
```

### POST https://api.reefapi.com/apple-music/v1/similar_artists — 1 credit
Artists Apple Music lists as similar to one artist.

**Parameters:**
- `artist_id` (string, optional) — Apple Music artist id.
- `url` (string, optional) — A music.apple.com link instead of the id (its country is used too).
- `limit` (integer, optional, default 25) — Rows per call (Apple's own cap for this list: 100).
- `offset` (integer, optional, default 0) — Where to start. Pass the previous call's `next_offset` to get the next page (Apple's own next offset; it can skip a hidden item).
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** artist_id + artists[] + count + offset + next_offset + has_more

**Example request body:**
```json
{
  "url": "https://music.apple.com/us/album/1989-taylors-version/1708308989"
}
```

### POST https://api.reefapi.com/apple-music/v1/playlist — 1 credit
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.

**Parameters:**
- `playlist_id` (string, optional) — Apple Music playlist id (starts with pl.).
- `url` (string, optional) — A music.apple.com link instead of the id (its country is used too).
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** playlist{id, name, curator_name, description, editorial_notes, playlist_type, is_chart, last_modified_date, has_collaboration, audio_traits, artwork, url} + curator + tracks[]{position, song / video record} + track_rows + tracks_has_more + featured_artists + more_by_curator

**Example request body:**
```json
{
  "playlist_id": "pl.f4d106fed2bd41149aaacabb233eb5eb"
}
```

### POST https://api.reefapi.com/apple-music/v1/playlist_tracks — 1 credit
One page of a playlist's tracks, numbered by position (Apple serves up to 100 per call).

**Parameters:**
- `playlist_id` (string, optional) — Playlist id.
- `url` (string, optional) — A music.apple.com link instead of the id (its country is used too).
- `limit` (integer, optional, default 100) — Rows per call (Apple's own cap for this list: 100).
- `offset` (integer, optional, default 0) — Where to start. Pass the previous call's `next_offset` to get the next page (Apple's own next offset; it can skip a hidden item).
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** playlist_id + tracks[]{position, record} + count + offset + next_offset + has_more

**Example request body:**
```json
{
  "url": "https://music.apple.com/us/album/1989-taylors-version/1708308989"
}
```

### POST https://api.reefapi.com/apple-music/v1/music_video — 1 credit
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.

**Parameters:**
- `video_id` (string, optional) — Apple Music music-video id.
- `url` (string, optional) — A music.apple.com link instead of the id (its country is used too).
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** music_video{id, name, artist_name, album_name, isrc, duration_ms, release_date, genre_names, has4_k, has_hdr, video_traits, preview_url, preview_hls_url, artwork, url, …} + artists[] + album + songs[] + genres[] + more_by_artist + more_in_genre

**Example request body:**
```json
{
  "url": "https://music.apple.com/us/album/1989-taylors-version/1708308989"
}
```

### POST https://api.reefapi.com/apple-music/v1/charts — 1 credit
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.

**Parameters:**
- `type` (enum, optional, default "songs") — Which chart. [one of: songs, albums, playlists, music_videos]
- `genre` (string, optional) — Genre id or name from `genres` (e.g. 14 or Pop, 18 or Hip-Hop/Rap). Genres differ per country.
- `limit` (integer, optional, default 50) — Rows per call (Apple's own cap for this list: 200).
- `offset` (integer, optional, default 0) — Where to start. Pass the previous call's `next_offset` to get the next page (Apple's own next offset; it can skip a hidden item).
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** chart{name, id, type, genre} + country + rows[]{rank, record} + count + offset + next_offset + has_more

**Example request body:**
```json
{
  "type": "songs",
  "limit": 50
}
```

### POST https://api.reefapi.com/apple-music/v1/chart_playlists — 1 credit
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.

**Parameters:**
- `kind` (enum, optional, default "daily_top_100") [one of: daily_top_100, city_top_25]
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** kind + charts[]{region | city, country_code (daily_top_100), playlist record} + count

**Example request body:**
```json
{
  "language": "en-US"
}
```

### POST https://api.reefapi.com/apple-music/v1/daily_top_100 — 1 credit
Today's Top 100 songs of one region on Apple Music (Global or a country), ranked, from Apple's Daily Top 100 chart playlist.

**Parameters:**
- `region` (string, optional, default "global") — `global` or a country code (us, gb, de, in, br, tr, …) or name; `chart_playlists` lists every region.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** region + country_code + playlist record + songs[]{rank, song record} + count

**Example request body:**
```json
{
  "region": "global"
}
```

### POST https://api.reefapi.com/apple-music/v1/city_top_25 — 1 credit
Today's Top 25 songs in one city on Apple Music (Apple's City Top 25 chart playlist).

**Parameters:**
- `city` (string, required) — City name (e.g. New York City, London, Mumbai) or the chart playlist id; `chart_playlists` with kind=city_top_25 lists every city.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** city + playlist record + songs[]{rank, song record} + count

**Example request body:**
```json
{
  "city": "Istanbul"
}
```

### POST https://api.reefapi.com/apple-music/v1/browse — 1 credit
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`.

**Parameters:**
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** country + sections[]{id, title, kind, display_style, resource_types, supported_sorts, see_all_id, items[], count, children[], links[]}

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

### POST https://api.reefapi.com/apple-music/v1/radio — 1 credit
Apple Music's Radio page of one country: live stations on air, radio shows, new episodes, interviews, hosts and broadcasters, as shelves.

**Parameters:**
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** country + sections[] (same shape as browse)

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

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

**Parameters:**
- `section` (string, required) — A `see_all_id` (numeric) or one of: new_releases, recent_releases, best_new_songs, trending_songs, coming_soon, updated_playlists, popular, dj_mixes, new_music_videos, daily_top_100, city_charts, live_radio, new_radio_episodes, interviews, only_on_apple_music, now_on_tour.
- `sort` (enum, optional) — Order; only the sorts in the section's `sorts` apply. [one of: featured, release_date, name]
- `limit` (integer, optional, default 50) — Rows per call (Apple's own cap for this list: 100).
- `offset` (integer, optional, default 0) — Where to start. Pass the previous call's `next_offset` to get the next page (Apple's own next offset; it can skip a hidden item).
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** section{id, title, default_sort, sorts, resource_types} + sort + items[] + count + offset + next_offset + has_more

**Example request body:**
```json
{
  "section": "recent_releases"
}
```

### POST https://api.reefapi.com/apple-music/v1/genres — 1 credit
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.

**Parameters:**
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** country + genres[]{id, name, parent_id, parent_name, url} + count

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

### POST https://api.reefapi.com/apple-music/v1/genre — 1 credit
One genre's editorial page in a country: its shelves (featured playlists, new releases, essentials, artist playlists, …) with rows and see-all ids.

**Parameters:**
- `genre` (string, required) — Genre id or name from `genres` (14 or Pop).
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** genre{id, name} + country + sections[] (same shape as browse)

**Example request body:**
```json
{
  "genre": "14"
}
```

### POST https://api.reefapi.com/apple-music/v1/record_label — 1 credit
One record label page: name, description, artwork and the first latest and top releases.

**Parameters:**
- `label_id` (string, optional) — Apple Music record-label id (/label/<slug>/<id>, or `record_labels[].id` of an album).
- `url` (string, optional) — A music.apple.com link instead of the id (its country is used too).
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** label{id, name, description, artwork, editorial_artwork, url} + latest_releases + top_releases (each {title, items[], count, has_more, next_offset})

**Example request body:**
```json
{
  "url": "https://music.apple.com/us/album/1989-taylors-version/1708308989"
}
```

### POST https://api.reefapi.com/apple-music/v1/record_label_releases — 1 credit
A record label's releases: latest (newest first) or top (most popular), paged.

**Parameters:**
- `label_id` (string, optional) — Record-label id.
- `url` (string, optional) — A music.apple.com link instead of the id (its country is used too).
- `type` (enum, optional, default "latest") [one of: latest, top]
- `limit` (integer, optional, default 25) — Rows per call (Apple's own cap for this list: 100).
- `offset` (integer, optional, default 0) — Where to start. Pass the previous call's `next_offset` to get the next page (Apple's own next offset; it can skip a hidden item).
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** label_id + type + albums[] + count + offset + next_offset + has_more

**Example request body:**
```json
{
  "url": "https://music.apple.com/us/album/1989-taylors-version/1708308989"
}
```

### POST https://api.reefapi.com/apple-music/v1/curator — 1 credit
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.

**Parameters:**
- `curator_id` (string, optional) — Curator id (/curator/<slug>/<id>).
- `url` (string, optional) — A music.apple.com link instead of the id (its country is used too).
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** curator{id, type (apple_curator | curator), name, short_name, kind, editorial_notes, artwork, url} + playlists[] + playlists_has_more + sections[]

**Example request body:**
```json
{
  "url": "https://music.apple.com/us/album/1989-taylors-version/1708308989"
}
```

### POST https://api.reefapi.com/apple-music/v1/curator_playlists — 1 credit
Every playlist one curator publishes, paged (Apple's cap: 25 per call for Apple curators, 10 for external curators).

**Parameters:**
- `curator_id` (string, optional) — Curator id.
- `url` (string, optional) — A music.apple.com link instead of the id (its country is used too).
- `limit` (integer, optional, default 25) — Rows per call (Apple's own cap for this list: 25).
- `offset` (integer, optional, default 0) — Where to start. Pass the previous call's `next_offset` to get the next page (Apple's own next offset; it can skip a hidden item).
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** curator_id + curator_type + playlists[] + count + offset + next_offset + has_more

**Example request body:**
```json
{
  "url": "https://music.apple.com/us/album/1989-taylors-version/1708308989"
}
```

### POST https://api.reefapi.com/apple-music/v1/stations_live — 1 credit
Apple Music's live radio stations in one country (Apple Music 1, Hits, Country, Música Uno, Club, Chill, seasonal stations).

**Parameters:**
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** country + stations[]{id, name, is_live, kind, media_kind, station_provider_name, radio_url, requires_subscription, artwork, url, …} + count

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

### POST https://api.reefapi.com/apple-music/v1/station — 1 credit
One radio station: live station, artist / song station, radio show episode or broadcaster.

**Parameters:**
- `station_id` (string, optional) — Station id (starts with ra.).
- `url` (string, optional) — A music.apple.com link instead of the id (its country is used too).
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** station{id, name, is_live, kind, media_kind, episode_number, air_time, station_provider_name, editorial_notes, artwork, url, …}

**Example request body:**
```json
{
  "url": "https://music.apple.com/us/album/1989-taylors-version/1708308989"
}
```

### POST https://api.reefapi.com/apple-music/v1/countries — 1 credit
Every Apple Music storefront (country) with its code, name, default and supported language tags and explicit-content policy.

**Parameters:**
- `language` (string, optional) — Optional display language as a language tag the storefront supports (e.g. de-DE, ja, es-MX; `countries` lists each storefront's tags). Default = the storefront's own.

**Returns:** countries[]{id (country code), name, default_language_tag, supported_language_tags[], explicit_content_policy} + count

**Example request body:**
```json
{
  "language": "en-US"
}
```

### POST https://api.reefapi.com/apple-music/v1/store_lookup — 1 credit
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.

**Parameters:**
- `ids` (array, optional) — Comma-separated Apple ids (song, album, artist or music video), at most 200.
- `upc` (string, optional) — An album UPC instead of ids.
- `entity` (enum, optional) — Optional related items to add. [one of: song, album, musicVideo]
- `country` (string, optional, default "us") — Apple Music storefront: a two-letter country code (us, gb, de, jp, in, br, tr, …; `countries` lists all 167). The catalogue, charts, editorial pages and availability are per country. A music.apple.com link's own country is used when this is not given.

**Returns:** results[]{type (song | album | artist | music_video), track_id, collection_id, artist_id, track_name, collection_name, artist_name, track_price, collection_price, currency, track_explicitness, collection_explicitness, release_date, primary_genre_name, track_count, track_number, disc_number, track_time_millis, preview_url, artwork_url100, copyright, amg_artist_id, track_view_url, …} + count + result_count

**Example request body:**
```json
{
  "ids": "1708308989"
}
```

## 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=apple-music
- Human docs page: https://reefapi.com/docs/apple-music
- Overview page: https://reefapi.com/apple-music-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
