> **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/album>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/apple-music/album.mdx>

---

# Apple Music Album API

Resolve a public Apple Music album by id or share URL and get catalog metadata plus an ordered tracklist in the shared Social Fetch envelope.

`GET /v1/apple-music/album` accepts either `albumId` or a public `url` (`https://music.apple.com/{cc}/album/…`). One of those params is required. On a found lookup you get `data.album` with identity fields (albumId, title, albumUrl), optional coverArtUrl / releaseInfo, credited artists, `trackCount`, and `tracks` in track order. Branch on `data.lookupStatus` before you write rows — HTTP 200 alone does not mean the album resolved.

Bill from `meta.creditsCharged`. This route is single-album detail. Playback, user libraries, and MusicKit stay on Apple's official Apple Music API.

## Request

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

## FAQ

### How do I get Apple Music album metadata via API?

Call GET /v1/apple-music/album with your Social Fetch API key (x-api-key) and either an albumId or a public music.apple.com/…/album/… url query param. Read data.lookupStatus, then data.album. See the API docs for parameters.

### How much does the Apple Music Album 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 album response include?

When found: data.album with albumId, title, albumUrl, trackCount, and tracks (ordered). Optional fields include coverArtUrl, releaseInfo, and artists. Always branch on data.lookupStatus first.

### Can I pass an Apple Music album URL instead of an id?

Yes. Pass url as a public https://music.apple.com/{cc}/album/{slug}/{id} link, or pass albumId directly. One of albumId or url is required per request. A song URL with ?i= is not an album lookup.

### Does a completed lookup always mean the album was found?

No. HTTP 200 means the request finished. Check data.lookupStatus: found means you got album 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.