One Logo Pool Ball
MusicKit · IOS API REFERENCE

Artist

struct · iOS 15.0+ · SDK 27.1

struct Artist

A music item that represents an artist.

Members (25)

get · iOS 15.0+

topMusicVideos

TypeScript
get topMusicVideos(): (MusicItemCollection<MusicVideo>) | null
Swift declaration
var topMusicVideos: MusicItemCollection<MusicVideo>? { get }

A collection of the artist’s top music videos.

get · iOS 15.0+

fullAlbums

TypeScript
get fullAlbums(): (MusicItemCollection<Album>) | null
Swift declaration
var fullAlbums: MusicItemCollection<Album>? { get }

A collection of the artist’s full-release albums.

get · iOS 15.0+

genreNames

TypeScript
get genreNames(): (Array<string>) | null
Swift declaration
var genreNames: [String]? { get }

The names of this artist’s associated genres.

get · iOS 15.0+

liveAlbums

TypeScript
get liveAlbums(): (MusicItemCollection<Album>) | null
Swift declaration
var liveAlbums: MusicItemCollection<Album>? { get }

A collection of the artist’s live albums.

get · iOS 15.0+

description

TypeScript
get description(): string
Swift declaration
var description: String { get }

A textual representation of this instance. Calling this property directly is discouraged. Instead, convert an instance of any type to a string by using the `String(describing:)` initializer. This initializer works with any type, and uses the custom `description` property for types that conform to `CustomStringConvertible`: struct Point: CustomStringConvertible { let x: Int, y: Int var description: String { return "(\(x), \(y))" } } let p = Point(x: 21, y: 30) let s = String(describing: p) print(s) // Prints "(21, 30)" The conversion of `p` to a string in the assignment to `s` uses the `Point` type's `description` property.

get · iOS 15.0+

musicVideos

TypeScript
get musicVideos(): (MusicItemCollection<MusicVideo>) | null
Swift declaration
var musicVideos: MusicItemCollection<MusicVideo>? { get }

The artist’s associated music videos.

get · iOS 15.0+

latestRelease

TypeScript
get latestRelease(): (Album) | null
Swift declaration
var latestRelease: Album? { get }

The artist’s most recent album.

get · iOS 15.0+

editorialNotes

TypeScript
get editorialNotes(): (EditorialNotes) | null
Swift declaration
var editorialNotes: EditorialNotes? { get }

The notes about the artist that appear in the Music catalog.

get · iOS 15.0+

featuredAlbums

TypeScript
get featuredAlbums(): (MusicItemCollection<Album>) | null
Swift declaration
var featuredAlbums: MusicItemCollection<Album>? { get }

A collection of featured albums of the artist.

get · iOS 15.0+

similarArtists

TypeScript
get similarArtists(): (MusicItemCollection<Artist>) | null
Swift declaration
var similarArtists: MusicItemCollection<Artist>? { get }

A collection of artists similar to this artist.

get · iOS 15.0+

appearsOnAlbums

TypeScript
get appearsOnAlbums(): (MusicItemCollection<Album>) | null
Swift declaration
var appearsOnAlbums: MusicItemCollection<Album>? { get }

A collection of albums from other artists that this artist appears on.

get · iOS 15.0+

debugDescription

TypeScript
get debugDescription(): string
Swift declaration
var debugDescription: String { get }

A textual representation of this instance, suitable for debugging. Calling this property directly is discouraged. Instead, convert an instance of any type to a string by using the `String(reflecting:)` initializer. This initializer works with any type, and uses the custom `debugDescription` property for types that conform to `CustomDebugStringConvertible`: struct Point: CustomDebugStringConvertible { let x: Int, y: Int var debugDescription: String { return "(\(x), \(y))" } } let p = Point(x: 21, y: 30) let s = String(reflecting: p) print(s) // Prints "(21, 30)" The conversion of `p` to a string in the assignment to `s` uses the `Point` type's `debugDescription` property.

get · iOS 16.0+

libraryAddedDate

TypeScript
get libraryAddedDate(): (globalThis.Date) | null
Swift declaration
var libraryAddedDate: Date? { get }

The date when the user added the artist to the library.

get · iOS 15.0+

compilationAlbums

TypeScript
get compilationAlbums(): (MusicItemCollection<Album>) | null
Swift declaration
var compilationAlbums: MusicItemCollection<Album>? { get }

A collection of compilation albums that include tracks by the artist.

get · iOS 15.0+

featuredPlaylists

TypeScript
get featuredPlaylists(): (MusicItemCollection<Playlist>) | null
Swift declaration
var featuredPlaylists: MusicItemCollection<Playlist>? { get }

A collection of the artist’s associated playlists.

get · iOS 15.0+

id

TypeScript
get id(): MusicItemID
Swift declaration
let id: MusicItemID

The unique identifier for the artist.

get · iOS 15.0+

url

TypeScript
get url(): (string) | null
Swift declaration
var url: URL? { get }

The URL for the artist.

get · iOS 15.0+

name

TypeScript
get name(): string
Swift declaration
var name: String { get }

The name of the artist.

get · iOS 15.0+

albums

TypeScript
get albums(): (MusicItemCollection<Album>) | null
Swift declaration
var albums: MusicItemCollection<Album>? { get }

The artist’s associated albums.

get · iOS 15.0+

genres

TypeScript
get genres(): (MusicItemCollection<Genre>) | null
Swift declaration
var genres: MusicItemCollection<Genre>? { get }

The artist’s associated genres.

get · iOS 15.0+

artwork

TypeScript
get artwork(): (Artwork) | null
Swift declaration
var artwork: Artwork? { get }

The artist artwork.

get · iOS 15.0+

singles

TypeScript
get singles(): (MusicItemCollection<Album>) | null
Swift declaration
var singles: MusicItemCollection<Album>? { get }

A collection of the artist’s associated albums in the _singles_ category.

get · iOS 15.0+

station

TypeScript
get station(): (Station) | null
Swift declaration
var station: Station? { get }

The artist’s associated station.

get · iOS 15.0+

topSongs

TypeScript
get topSongs(): (MusicItemCollection<Song>) | null
Swift declaration
var topSongs: MusicItemCollection<Song>? { get }

A collection of the artist’s top songs.

get · iOS 15.0+

playlists

TypeScript
get playlists(): (MusicItemCollection<Playlist>) | null
Swift declaration
var playlists: MusicItemCollection<Playlist>? { get }

The artist’s associated playlists.

Skipped declarations

No declarations were skipped in this snapshot.

All MusicKit types →