> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/apple-music/artist>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/apple-music/artist.mdx>

---

# 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/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.

## Request

- **Endpoint:** `GET /v1/apple-music/artist`
- **Credits:** 1 credit per successful request.
- **Input:** by artist id or URL
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/apple-music/artist/get)
- **Platform page:** [/platforms/apple-music](https://www.socialfetch.dev/platforms/apple-music)

## 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.