<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "AppleMusicAPI",
  "identifier" : "/documentation/AppleMusicAPI",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service",
  "symbol" : {
    "kind" : "Web Service",
    "modules" : [
      "Apple Music API"
    ],
    "preciseIdentifier" : "AppleMusicAPI"
  },
  "title" : "Apple Music API"
}
-->

# Apple Music API

Integrate streaming music with catalog and personal content.

## Overview

Use Apple Music API to access information about media in the Apple Music Catalog and a user’s personal iCloud Music Library.

- Apple Music Catalog includes all resources available in Apple Music.
- iCloud Music Library contains only those resources the user adds to their personal library. For example, it contains items from Apple Music, songs purchased from iTunes Store, and imports from discs and other apps. This library can include content that’s not in the Apple Music Catalog.

Use this API to retrieve information about albums, songs, artists, playlists, music videos, Apple Music stations, ratings, charts, recommendations, and the user’s most-recently played content. With proper authorization from the user, you can also create or modify playlists and apply ratings to the user’s content.

> Note:
> Use the <doc://com.apple.documentation/documentation/AppleMusicFeed> to access the Apple Music Catalog in bulk.

## Topics

### Essentials

[Generating Developer Tokens](/documentation/AppleMusicAPI/generating-developer-tokens)

Generate a developer token needed to make requests to Apple Music API.

[User Authentication for MusicKit](/documentation/AppleMusicAPI/user-authentication-for-musickit)

Authenticate requests for user data using the Music User Token.

[Handling Requests and Responses](/documentation/AppleMusicAPI/handling-requests-and-responses)

Write a request and handle responses from the API.

[Handling Resource Representation and Relationships](/documentation/AppleMusicAPI/handling-resource-representation-and-relationships)

Fetch resources with extended attributes and included relationships and relationship views.

[Storefronts and Localization](/documentation/AppleMusicAPI/storefronts-and-localization)

Pick a region-specific geographic location from which to retrieve catalog information, or retrieve information from the user’s personal library.

[Common Objects](/documentation/AppleMusicAPI/common-objects)

Understand the common JSON objects that framework responses contain.

[Managing Content Ratings, Alternate Versions, and Equivalencies](/documentation/AppleMusicAPI/managing-content-ratings-alternate-versions-and-equivalencies)

Handle multiple and alternate versions of content.

[Fetching Resources by Page](/documentation/AppleMusicAPI/fetching-resources-by-page)

Use pagination to fetch the next set of objects.

### Albums, Artists, Songs, and Videos

[Albums](/documentation/AppleMusicAPI/albums-api)

Get an album’s name, artist, list of tracks, artwork, release date, and recording information, and add new albums to the user’s library.

[Artists](/documentation/AppleMusicAPI/artists-api)

Get information about an artist, including the content they created and references to them in playlists and radio stations.

[Songs](/documentation/AppleMusicAPI/songs-api)

Get information about a particular song, including the artist who created it and the album on which it appeared.

[Music Videos](/documentation/AppleMusicAPI/music-videos-api)

Get information about a music video, including the artist who created it and the associated album, and add new videos to the user’s library.

### Playlists and Stations

[Playlists](/documentation/AppleMusicAPI/playlists-api)

Get the contents of playlists, add new playlists to the user’s library, and add tracks to an existing playlist.

[Apple Music Stations](/documentation/AppleMusicAPI/apple-music-stations)

Get information about streaming content offered by Apple Music.

### Search

[Search](/documentation/AppleMusicAPI/search)

Search for albums, songs, artists, and other information in the user’s personal library or the Apple Music Catalog.

### Ratings, Genres, and Charts

[Ratings](/documentation/AppleMusicAPI/ratings-api)

Get and set ratings for albums, songs, playlists, music videos, and stations.

[Music Genres](/documentation/AppleMusicAPI/music-genres)

Get information about the genres of the user’s music or items in the Apple Music Catalog.

[Charts](/documentation/AppleMusicAPI/charts-api)

Get chart information that shows the popularity of albums, songs, and music videos.

### Activities, Curators, and Record Labels

[Activities](/documentation/AppleMusicAPI/activities-api)

Get request and response activities associated with the Apple Music Catalog.

[Curators](/documentation/AppleMusicAPI/curators-api)

Get information about the person who curated a playlist or station.

[Record Labels](/documentation/AppleMusicAPI/record-labels-api)

Get information on record labels in the Apple Music Catalog.

### Adding a resource to favorites

[`Add resource to favorites`](/documentation/AppleMusicAPI/Add-resource-to-favorites)

Add the user’s resource to favorites.

### Getting a user’s replay data

[`Get the user's replay data`](/documentation/AppleMusicAPI/Get-the-user's-replay-data)

Fetch the user’s replay data for the latest eligible year.

### Recommendations and history

[Recommendations](/documentation/AppleMusicAPI/recommendations)

Get music recommendations based on the user’s library and purchase history.

[History](/documentation/AppleMusicAPI/history)

Get historical information about the songs and stations the user played recently.

### Fetching Multiple Resource Types

[`Get Multiple Catalog Resources Using Resource-Typed ID Parameters`](/documentation/AppleMusicAPI/Get-Multiple-Catalog-Resources-by-resource-typed-ids-parameters)

Fetch one or more catalog resources by using their identifiers.

[`Get Multiple Library Resources Using Resource-Typed ID Parameters`](/documentation/AppleMusicAPI/Get-Multiple-Library-Resources-by-resource-typed-ids-parameters)

Fetch one or more library resources by using their identifiers.

## See Also

  <doc://com.apple.documentation/documentation/MediaPlayer>

  <doc://com.apple.documentation/documentation/StoreKit>



---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)