Apple Music

Get Apple Music album

Get an Apple Music album by id or album URL.

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

API key (`sfk_...`)

Parameters
2
albumIdstringquery

Optional Apple Music album id for the request.

min 1 chars · max 128 chars

urlstringquery

Optional Apple Music album URL for the request.

min 1 chars · max 4096 chars

Response fields
27

Endpoint-specific response payload.

datalookupStatus
string

Whether the album was found.

one of: found, not_found

Album details when available.

dataalbumplatform
string

Platform for this album.

one of: apple_music

dataalbumalbumId
string

Stable Apple Music album identifier.

min 1 chars

dataalbumtitle
string

Album title.

min 1 chars

dataalbumcoverArtUrl
stringnullable

Best available square cover image URL when available.

dataalbumalbumUrl
string

Canonical public Apple Music album URL.

min 1 chars

Album artists when available.

dataalbumartists[]artistId
stringnullable

Apple Music artist id when available.

dataalbumartists[]displayName
string

Artist display name on this album.

min 1 chars

dataalbumartists[]profileUrl
stringnullable

Canonical public Apple Music artist URL when available.

dataalbumtrackCount
integer

Number of tracks on the album.

≥ 0

dataalbumreleaseInfo
stringnullable

Publisher release text when available (date, duration, copyright).

Album tracks in track order.

dataalbumtracks[]trackId
string

Stable Apple Music song identifier.

min 1 chars

dataalbumtracks[]title
string

Track title.

min 1 chars

dataalbumtracks[]trackNumber
integernullable

Track number on the album when available.

≥ 0

dataalbumtracks[]durationMs
integernullable

Track duration in milliseconds when available.

≥ 0

dataalbumtracks[]discNumber
integernullable

Disc number for this track when available.

≥ 0

dataalbumtracks[]explicit
booleannullable

Whether the track is marked explicit when available.

dataalbumtracks[]albumId
stringnullable

Apple Music album id this track belongs to when available.

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/album?albumId=1468058165" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Album lookup result.