Apple Music Artist API
Resolve a public Apple Music artist by id or share URL and get catalog identity plus related songs, albums, videos, and playlists in the shared Social Fetch envelope.
GET /v1/apple-music/artist1 credit per successful request.
About this endpoint
`GET /v1/apple-music/artist` accepts either `artistId` or a public `url` (`https://music.apple.com/{cc}/artist/…`). One of those params is required. On a found lookup you get `data.artist` with identity fields (artistId, displayName, profileUrl), optional artworkUrl / editorialNotes, plus always-present arrays `topSongs`, `albums`, `musicVideos`, and `playlists`. Branch on `data.lookupStatus` before you write rows — HTTP 200 alone does not mean the artist resolved.
Bill from `meta.creditsCharged`. This route is single-artist detail. Playback, user libraries, and MusicKit stay on Apple's official Apple Music API.
Apple Music Artist API FAQ
How do I get Apple Music artist metadata via API?
Call GET /v1/apple-music/artist with your Social Fetch API key (x-api-key) and either an artistId or a public music.apple.com/…/artist/… url query param. Read data.lookupStatus, then data.artist. See the API docs for parameters.
How much does the Apple Music Artist API cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth.
What does the Apple Music artist response include?
When found: data.artist with artistId, displayName, and profileUrl. Optional artworkUrl and editorialNotes. Always-present related arrays: topSongs, albums, musicVideos, playlists (empty when not_found). Always branch on data.lookupStatus first.
Can I pass an Apple Music artist URL instead of an id?
Yes. Pass url as a public https://music.apple.com/{cc}/artist/{slug}/{id} link, or pass artistId directly. One of artistId or url is required per request. Album or song URLs belong on the album and track routes.
Does a completed lookup always mean the artist was found?
No. HTTP 200 means the request finished. Check data.lookupStatus: found means you got artist details; not_found means the id or URL did not resolve. Persist meta.requestId when you need to debug a miss.
Does this replace the Apple Music API / MusicKit?
No. Social Fetch returns public catalog metadata for enrichment pipelines. Use Apple's official Apple Music API when you need playback control, user libraries, or developer-token MusicKit access.