UnifAPI Docs

Apple Music API

Apple Music catalog search, plus artists, albums and songs by their Apple Music id.

Apple Music catalog search, plus artists, albums and songs by their Apple Music id.

When To Use This API

The Apple Music API is for agent workflows that need public, platform-native data without writing a custom collector for every task. Use it when a prompt needs evidence from live public records, when a Skill needs repeatable enrichment, or when product code needs the same contract an agent discovered through MCP.

This section lists 4 live Apple Music operations from the canonical OpenAPI spec. Each operation page documents the route, method, parameters, response envelope, pagination behavior when available, and the error vocabulary shared across UnifAPI.

  • Search Apple Music for artists, albums, songs, playlists and music videos from one query.
  • Pull an artist's top songs, albums, music videos and editorial notes for music research.
  • Match tracks across Spotify and Apple Music by title, artist and duration for catalog work.

Agent Contract Notes

Agents usually discover these endpoints with the hosted UnifAPI MCP server, inspect the operation schema, then call only the records needed for the current task. Developers can call the same endpoints over HTTP with an API key, which makes the path from exploratory agent run to production integration direct.

Every successful response uses a stable envelope with a request id, data payload, optional pagination cursor, and billing metadata. Errors use the same closed vocabulary across platforms, so retry logic, user-facing explanations, and cost reporting can stay consistent even when a workflow spans multiple public-data sources.

When you are choosing an operation, start from the public identifier the user already has: a profile username, post id, channel id, subreddit name, search term, or URL-derived slug. Prefer the narrowest endpoint that answers the question, then expand only when the agent needs more evidence. This keeps record usage predictable, makes citations easier to explain, and avoids turning a focused research task into an expensive crawl.

Operations

Albums

  • GET /apple-music/albums/{id} — Get an Apple Music album — Returns an Apple Music album by id: title, artist, release date, genres, artwork, editorial notes and tracks.

Artists

  • GET /apple-music/artists/{id} — Get an Apple Music artist — Returns an Apple Music artist by id with top songs, albums, music videos and playlists.
  • GET /apple-music/search — Search the Apple Music catalog — Searches the Apple Music catalog by keyword and returns matching artists, albums, songs, playlists, stations, music videos and radio episodes.

Tracks

  • GET /apple-music/tracks/{id} — Get an Apple Music song — Returns an Apple Music song by id: title, artist, album, duration, release date, genres and preview URL.

On this page