The Missing Apple Music SDK. Written in Swift.

Build Status Carthage compatible CocoaPods SPM compatible Platform iOS Language Swift 4.0



Add the following to your Cartfile:

github "scottrhoyt/Cider" ~> 0.10


Add the following to your Podfile:

pod 'Cider', '~> 0.10'


Add to your Package.swift file like so:

import PackageDescription

let package = Package(
    name: "<YOUR_PROJECT_NAME>",
    dependencies: [
        .package(url: "", from: "0.10.0")


Developer Token

To use the Apple Music API, you will need to generate a developer token. Instructions for how to do this can be found in the Apple Music API reference.

Once you have an Apple Music Key you can use a 3rd party library/tool to generate your token. I created a Node.js library and CLI tool that you can find here.

Create a Client

let developerToken = "<developer_token>"
let cider = CiderClient(storefront: .unitedStates, developerToken: developerToken)

Search the Catalog "Michael Jackson", types: [.albums, .songs]) { results, error in
  // Process the results or error

Lookup an Artist/Album/Song

let songId = "<song_id>" songId) { result, error in
  // Process the results or error

API Reference

The full API reference can be found here.