Apple Music

Get Apple Music artist

Get an Apple Music artist by id or artist URL.

GET/v1/apple-music/artist
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
artistIdstringquery

Optional Apple Music artist id for the request.

min 1 chars · max 128 chars

urlstringquery

Optional Apple Music artist URL for the request.

min 1 chars · max 4096 chars

Response fields
34

Endpoint-specific response payload.

datalookupStatus
string

Whether the artist was found.

one of: found, not_found

Artist details when available.

dataartistplatform
string

Platform for this artist.

one of: apple_music

dataartistartistId
string

Stable Apple Music artist identifier.

min 1 chars

dataartistdisplayName
string

Public display name for the artist.

min 1 chars

dataartistprofileUrl
string

Canonical public Apple Music artist profile URL.

min 1 chars

dataartistartworkUrl
stringnullable

Best available square artwork image URL when available.

dataartisteditorialNotes
stringnullable

Editorial notes for the artist when available.

Top songs for the artist.

datatopSongs[]songId
string

Stable Apple Music song identifier.

min 1 chars

datatopSongs[]title
string

Song title.

min 1 chars

datatopSongs[]artistName
stringnullable

Primary artist display name when available.

datatopSongs[]songUrl
string

Canonical public Apple Music song URL.

min 1 chars

datatopSongs[]durationMs
integernullable

Song duration in milliseconds when available.

≥ 0

Albums for the artist.

dataalbums[]albumId
string

Stable Apple Music album identifier.

min 1 chars

dataalbums[]title
string

Album title.

min 1 chars

dataalbums[]subtitle
stringnullable

Album subtitle, typically the artist name, when available.

dataalbums[]trackCount
integernullable

Number of tracks on the album when available.

≥ 0

dataalbums[]albumUrl
string

Canonical public Apple Music album URL.

min 1 chars

Music videos for the artist.

datamusicVideos[]videoId
string

Stable Apple Music music video identifier.

min 1 chars

datamusicVideos[]title
string

Music video title.

min 1 chars

datamusicVideos[]videoUrl
string

Canonical public Apple Music music video URL.

min 1 chars

Playlists for the artist.

dataplaylists[]playlistId
string

Stable Apple Music playlist identifier.

min 1 chars

dataplaylists[]title
string

Playlist title.

min 1 chars

dataplaylists[]playlistUrl
string

Canonical public Apple Music playlist URL.

min 1 chars

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metacached
booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

Code example

curl "https://api.socialfetch.dev/v1/apple-music/artist?artistId=159260351" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Artist lookup result.