<!--
{
  "documentType" : "article",
  "framework" : "AppleMusicAPI",
  "identifier" : "/documentation/AppleMusicAPI/ratings-api",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Ratings"
}
-->

# Ratings

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

## Topics

### Requesting Catalog Ratings

[`Get a Personal Album Rating`](/documentation/AppleMusicAPI/Get-a-Personal-Content-Rating-1q2mb)

Fetch a user’s rating for an album by using the user’s identifier.

[`Get a Personal Music Video Rating`](/documentation/AppleMusicAPI/Get-a-Personal-Content-Rating-8doe0)

Fetch a user’s rating for a music video by using the video’s identifier.

[`Get a Personal Playlist Rating`](/documentation/AppleMusicAPI/Get-a-Personal-Content-Rating-6wib7)

Fetch a user’s rating for a playlist by using the playlist’s identifier.

[`Get a Personal Song Rating`](/documentation/AppleMusicAPI/Get-a-Personal-Content-Rating-4k9c0)

Fetch a user’s rating for a song by using the song’s identifier.

[`Get a Personal Station Rating`](/documentation/AppleMusicAPI/Get-a-Personal-Content-Rating-try2)

Fetch a user’s rating for a station by using the station’s identifier.

[`Get Multiple Personal Album Ratings`](/documentation/AppleMusicAPI/Get-Multiple-Personal-Content-Ratings-8tjvr)

Fetch the user’s ratings for one or more albums by using the albums’ identifiers.

[`Get Multiple Personal Music Video Ratings`](/documentation/AppleMusicAPI/Get-Multiple-Personal-Content-Ratings-74o7x)

Fetch the user’s ratings for one or more music videos by using the music videos’ identifiers.

[`Get Multiple Personal Playlist Ratings`](/documentation/AppleMusicAPI/Get-Multiple-Personal-Content-Ratings-7i7bv)

Fetch the user’s ratings for one or more playlists by using the playlists’ identifiers.

[`Get Multiple Personal Song Ratings`](/documentation/AppleMusicAPI/Get-Multiple-Personal-Content-Ratings-6wab5)

Fetch the user’s ratings for one or more songs by using the songs’ identifiers.

[`Get Multiple Personal Station Ratings`](/documentation/AppleMusicAPI/Get-Multiple-Personal-Content-Ratings-7ycdc)

Fetch the user’s ratings for one or more stations by using the stations’ identifiers.

### Adding Catalog Ratings

[`Add a Personal Album Rating`](/documentation/AppleMusicAPI/Add-a-Personal-Content-Rating-4zesn)

Add a user’s album rating by using the album’s identifier.

[`Add a Personal Music Video Rating`](/documentation/AppleMusicAPI/Add-a-Personal-Content-Rating-8hke5)

Add a user’s music video rating by using the music video’s identifier.

[`Add a Personal Playlist Rating`](/documentation/AppleMusicAPI/Add-a-Personal-Content-Rating-76n4r)

Add a user’s playlist rating by using the playlist’s identifier.

[`Add a Personal Song Rating`](/documentation/AppleMusicAPI/Add-a-Personal-Content-Rating-33dop)

Add a user’s song rating by using the song’s identifier.

[`Add a Personal Station Rating`](/documentation/AppleMusicAPI/Add-a-Personal-Content-Rating-8zlgo)

Add a user’s station rating by using the station’s identifier.

### Deleting Catalog Ratings

[`Delete a Personal Album Rating`](/documentation/AppleMusicAPI/Delete-a-Personal-Content-Rating-863sx)

Remove a user’s album rating by using the album’s identifier.

[`Delete a Personal Music Video Rating`](/documentation/AppleMusicAPI/Delete-a-Personal-Content-Rating-9xd3d)

Remove a user’s music video rating by using the music video’s identifier.

[`Delete a Personal Playlist Rating`](/documentation/AppleMusicAPI/Delete-a-Personal-Content-Rating-mv3a)

Remove a user’s playlist rating by using the playlist’s identifier.

[`Delete a Personal Song Rating`](/documentation/AppleMusicAPI/Delete-a-Personal-Content-Rating-3a3a2)

Remove a user’s song rating by using the song’s identifier.

[`Delete a Personal Station Rating`](/documentation/AppleMusicAPI/Delete-a-Personal-Content-Rating-7pbcr)

Remove a user’s station rating by using the station’s identifier.

### Requesting Library Ratings

[`Get a Personal Library Album Rating`](/documentation/AppleMusicAPI/Get-a-Personal-Content-Rating-6c3b8)

Fetch a user’s rating for specific content by using the content’s identifier.

[`Get a Personal Library Music Video Rating`](/documentation/AppleMusicAPI/Get-a-Personal-Content-Rating-4bir7)

Fetch a user’s rating for a library music video by using the music video’s library identifier.

[`Get a Personal Library Playlist Rating`](/documentation/AppleMusicAPI/Get-a-Personal-Content-Rating-htyl)

Fetch a user’s rating for a library playlist by using the playlist’s library identifier.

[`Get a Personal Library Song Rating`](/documentation/AppleMusicAPI/Get-a-Personal-Content-Rating-7olcw)

Fetch a user’s rating for a library song by using the song’s library identifier.

[`Get Multiple Personal Library Album Ratings`](/documentation/AppleMusicAPI/Get-Multiple-Personal-Content-Ratings-5px7a)

Fetch the user’s ratings for one or more pieces of content by using the contents’ identifiers.

[`Get Multiple Personal Library Music Video Ratings`](/documentation/AppleMusicAPI/Get-Multiple-Personal-Content-Ratings-63ybs)

Fetch the user’s ratings for one or more library music videos by using the library music videos’ identifiers.

[`Get Multiple Personal Library Playlist Ratings`](/documentation/AppleMusicAPI/Get-Multiple-Personal-Content-Ratings-25kr7)

Fetch the user’s ratings for one or more library playlists by using the library playlists’ identifiers.

[`Get Multiple Personal Library Songs Ratings`](/documentation/AppleMusicAPI/Get-Multiple-Personal-Content-Ratings-1bod7)

Fetch the user’s ratings for one or more library songs by using the library songs’ identifiers.

### Adding Library Ratings

[`Add a Personal Library Album Rating`](/documentation/AppleMusicAPI/Add-a-Personal-Content-Rating-98xt0)

Add a user’s content rating by using the content’s identifier.

[`Add a Personal Library Music Video Rating`](/documentation/AppleMusicAPI/Add-a-Personal-Content-Rating-58x8v)

Add a user’s library music video rating by using the library music video’s identifier.

[`Add a Personal Library Playlist Rating`](/documentation/AppleMusicAPI/Add-a-Personal-Content-Rating-91fzd)

Add a user’s library playlist rating by using the library playlist’s identifier.

[`Add a Personal Library Song Rating`](/documentation/AppleMusicAPI/Add-a-Personal-Content-Rating-8z1fn)

Add a user’s library song rating by using the library song’s identifier.

### Deleting Library Ratings

[`Delete a Personal Library Album Rating`](/documentation/AppleMusicAPI/Delete-a-Personal-Content-Rating-32o8r)

Remove a user’s content rating by using the content’s identifier.

[`Delete a Personal Library Music Video Rating`](/documentation/AppleMusicAPI/Delete-a-Personal-Content-Rating-1vj60)

Remove a user’s library music video rating by using the library music video’s identifier.

[`Delete a Personal Library Playlist Rating`](/documentation/AppleMusicAPI/Delete-a-Personal-Content-Rating-7vxs6)

Remove a user’s library playlist rating by using the library playlist’s identifier.

[`Delete a Personal Library Song Rating`](/documentation/AppleMusicAPI/Delete-a-Personal-Content-Rating-2k02e)

Remove a user’s library song rating by using the library song’s identifier.

### Handling the Response

[`object Ratings`](/documentation/AppleMusicAPI/Ratings)

An object that represents a rating for a resource.

[`object RatingsResponse`](/documentation/AppleMusicAPI/RatingsResponse)

The response to a request for a rating.

[`object RatingRequest`](/documentation/AppleMusicAPI/RatingRequest)

A request containing the data for a rating.



---

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)