<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "AppleMusicAPI",
  "identifier" : "/documentation/AppleMusicAPI/Add-a-Personal-Content-Rating-33dop",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Music API"
    ],
    "preciseIdentifier" : "rest:music_api:put:v1-me-ratings-songs-{}"
  },
  "title" : "Add a Personal Song Rating"
}
-->

# Add a Personal Song Rating

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

## Discussion

This endpoint requires a music user token. For more information, see [User Authentication for MusicKit](/documentation/AppleMusicAPI/user-authentication-for-musickit).

A rating indicates whether a user likes `(1)` or dislikes `(-1)` the song. These are the only two ratings supported.

For a particular song, the personal ratings for that song’s catalog ID and library ID (if the playlist is in the library) stay synced.

### Example

**Request:**

```
https://api.music.apple.com/v1/me/ratings/songs/907242702

{
    "type":"rating",
    "attributes":{
        "value":1
    }
}
```

**Response:**

```json
{
    "data":[
        {
            "id":"907242702",
            "type":"ratings",
            "href":"/v1/me/ratings/songs/907242702",
            "attributes":{
                "value":1
            }
        }
    ]
}
```

## See Also

[`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.


---

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)