Contents

Songs.Attributes

The attributes for a song resource.

Declaration

object Songs.Attributes

Properties

NameTypeDescription
albumName Requiredstring

The name of the album the song appears on.

artistName Requiredstring

The artist’s name.

artistUrlstring

(Extended) The URL of the artist for the content.

artwork RequiredArtwork

The album artwork.

attributionstring

(Classical music only) The name of the artist or composer to attribute the song with.

audioVariants[string]

(Extended) Indicates the specific audio variant for a song.

composerNamestring

The song’s composer.

contentRatingstring

The Recording Industry Association of America (RIAA) rating of the content. No value means no rating.

discNumberinteger

The disc number of the album the song appears on.

durationInMillis Requiredinteger

The duration of the song in milliseconds.

editorialNotesEditorialNotes

The notes about the song that appear in the Apple Music catalog.

genreNames Required[string]

The genre names the song is associated with.

hasLyrics Requiredboolean

Indicates whether the song has lyrics available in the Apple Music catalog. If true, the song has lyrics available; otherwise, it doesn’t.

inFavoritesboolean

Whether the catalog resource ID is in the person’s favorites.

isAppleDigitalMaster Requiredboolean

Indicates whether the response delivered the song as an Apple Digital Master.

isrcstring

The International Standard Recording Code (ISRC) for the song.

movementCountinteger

(Classical music only) The movement count of the song.

movementNamestring

(Classical music only) The movement name of the song.

movementNumberinteger

(Classical music only) The movement number of the song.

name Requiredstring

The localized name of the song.

playParamsPlayParameters

When present, this attribute indicates that the song is available to play with an Apple Music subscription. The value map may be used to initiate playback. Previews of the song audio may be available with or without an Apple Music subscription.

previews Required[Preview]

The preview assets for the song.

releaseDatestring

The release date of the song, when known, in YYYY-MM-DD or YYYY format. Prerelease songs may have an expected release date in the future.

trackNumberinteger

The number of the song in the album’s track list.

url Requiredstring

The URL for sharing the song in Apple Music.

workNamestring

(Classical music only) The name of the associated work.

See Also

Related Objects