AppleMusicFeed

Elixir client for the editorial and catalog discovery portions of the Apple Music API.

This package is centered around chart and storefront browsing, plus fetching known Apple Music resources by ID.

Installation

Add to your mix.exs:

defp deps do
  [
    {:apple_music_feed, "~> 0.3.0"}
  ]
end

Configuration

config :apple_music_feed,
  team_id: System.get_env("APPLE_TEAM_ID"),
  key_id: System.get_env("APPLE_MUSIC_FEED_KEY_ID"),
  private_key_path: System.get_env("APPLE_MUSIC_FEED_PRIVATE_KEY_PATH"),
  storefront: "us"

Supported options:

team_id - Apple Developer Team ID
key_id - Maps/Media services key ID with Music access
private_key - inline .p8 contents
private_key_path - path to the .p8 file
base_url - defaults to https://api.music.apple.com
storefront - defaults to us
token_ttl_seconds - defaults to package setting

Quick Start

# Charts by storefront
{:ok, charts} = AppleMusicFeed.get_charts(storefront: "us", types: ["songs", "albums"])

# Genres
{:ok, genres} = AppleMusicFeed.get_genres()

# Editorial mixes / stations
{:ok, mixes} = AppleMusicFeed.get_editorial_mixes(limit: 10)

# Recommendations
{:ok, recs} = AppleMusicFeed.get_recommendations(limit: 10)

Fetching Known IDs

Some Apple Music feed-style operations are fetch-by-ID, not list-all endpoints.

AppleMusicFeed.get_featured_playlists(["pl.5ee8333dbe944d9f9f9c49b8de10d6c5"])
AppleMusicFeed.get_new_releases(["310730204"])
AppleMusicFeed.get_top_songs(["900083885"])
AppleMusicFeed.get_playlist("pl.123456789")
AppleMusicFeed.get_playlist_tracks("pl.123456789", limit: 25)

Live Testing

The shared media integration script covers this package too:

cd apple_music_api
source .env && elixir test_media_apis.exs

Notes

Use get_charts/1 for discovery.
Use the ID-based helpers when you already know the playlist, album, or song IDs.
Tokens are cached in AppleMusicFeed.TokenCache.

License

MIT

Next Page → Changelog