Get Multiple Personal Music Video Ratings

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

URL

GET https://api.music.apple.com/v1/me/ratings/music-videos

Name	Type	Description
`ids` Required	[string]	The unique identifiers for the music videos.
`include` Optional	[string]	Additional relationships to include in the fetch.
`l` Optional	string	The localization to use, specified by a language tag. The possible values are in the `supportedLanguageTags` array belonging to the `Storefront` object specified by `storefront`. Otherwise, the default is `defaultLanguageTag` in `Storefront`.
`extend` Optional	[string]	A list of attribute extensions to apply to resources in the response.

Status	Reason	Type	Description
200	OK Content-Type: application/json	`RatingsResponse`	The request was successful.
401	Unauthorized Content-Type: application/json	`UnauthorizedResponse`	A response indicating an incorrect `Authorization` header.
403	Forbidden Content-Type: application/json	`ForbiddenResponse`	A response indicating invalid or insufficient authentication.
500	Internal Server Error Content-Type: application/json	`ErrorsResponse`	A response indicating an error occurred on the server.

This endpoint requires a music user token. For more information, see User Authentication for MusicKit.

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

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