Apple Music

Apple Music is Apple's streaming music service. The Apple Music API and MusicKit framework give developers access to the Apple Music catalog, user library, charts, recommendations, search, and playback control. Authentication is via Apple Developer Program JWT tokens; user library access requires a MusicKit Music User Token.

1 APIs 0 Features

MusicStreamingAppleMusicKitCatalogLibrary

APIs

Apple Music API

REST API for Apple Music: catalog (songs, albums, artists, music videos, playlists, stations), search, charts, recommendations, and the authenticated user's library, playlists, ...

Collections

Apple Music API

OPEN

GraphQL

Apple Music GraphQL Schema

This is a conceptual GraphQL schema for the Apple Music API (MusicKit API). The Apple Music API is a REST API provided by Apple through the Apple Developer Program. This schema ...

GRAPHQL

Pricing Plans

Apple Music Plans Pricing

2 plans

PLANS

Rate Limits

Apple Music Rate Limits

2 limits

RATE LIMITS

FinOps

Apple Music Finops

FINOPS

Resources

Sources

opencollection: 1.0.0
info:
  name: Apple Music API
  version: '1.0'
request:
  auth:
    type: bearer
    token: '{{bearerToken}}'
items:
- info:
    name: Catalog
    type: folder
  items:
  - info:
      name: Get a catalog song by id
      type: http
    http:
      method: GET
      url: https://api.music.apple.com/v1/catalog/:storefront/songs/:id
      params:
      - name: storefront
        value: ''
        type: path
        description: Apple Music storefront identifier (e.g. us, gb, jp)
      - name: id
        value: ''
        type: path
    docs: Get a catalog song by id
  - info:
      name: Get catalog songs by ids
      type: http
    http:
      method: GET
      url: https://api.music.apple.com/v1/catalog/:storefront/songs
      params:
      - name: storefront
        value: ''
        type: path
        description: Apple Music storefront identifier (e.g. us, gb, jp)
      - name: ids
        value: ''
        type: query
        description: Comma-separated list of resource ids
    docs: Get catalog songs by ids
  - info:
      name: Get a catalog album by id
      type: http
    http:
      method: GET
      url: https://api.music.apple.com/v1/catalog/:storefront/albums/:id
      params:
      - name: storefront
        value: ''
        type: path
        description: Apple Music storefront identifier (e.g. us, gb, jp)
      - name: id
        value: ''
        type: path
    docs: Get a catalog album by id
  - info:
      name: Get catalog albums by ids
      type: http
    http:
      method: GET
      url: https://api.music.apple.com/v1/catalog/:storefront/albums
      params:
      - name: storefront
        value: ''
        type: path
        description: Apple Music storefront identifier (e.g. us, gb, jp)
      - name: ids
        value: ''
        type: query
        description: Comma-separated list of resource ids
    docs: Get catalog albums by ids
  - info:
      name: Get a catalog artist by id
      type: http
    http:
      method: GET
      url: https://api.music.apple.com/v1/catalog/:storefront/artists/:id
      params:
      - name: storefront
        value: ''
        type: path
        description: Apple Music storefront identifier (e.g. us, gb, jp)
      - name: id
        value: ''
        type: path
    docs: Get a catalog artist by id
  - info:
      name: Get catalog artists by ids
      type: http
    http:
      method: GET
      url: https://api.music.apple.com/v1/catalog/:storefront/artists
      params:
      - name: storefront
        value: ''
        type: path
        description: Apple Music storefront identifier (e.g. us, gb, jp)
      - name: ids
        value: ''
        type: query
        description: Comma-separated list of resource ids
    docs: Get catalog artists by ids
  - info:
      name: Get a catalog playlist by id
      type: http
    http:
      method: GET
      url: https://api.music.apple.com/v1/catalog/:storefront/playlists/:id
      params:
      - name: storefront
        value: ''
        type: path
        description: Apple Music storefront identifier (e.g. us, gb, jp)
      - name: id
        value: ''
        type: path
    docs: Get a catalog playlist by id
  - info:
      name: Get catalog playlists by ids
      type: http
    http:
      method: GET
      url: https://api.music.apple.com/v1/catalog/:storefront/playlists
      params:
      - name: storefront
        value: ''
        type: path
        description: Apple Music storefront identifier (e.g. us, gb, jp)
      - name: ids
        value: ''
        type: query
        description: Comma-separated list of resource ids
    docs: Get catalog playlists by ids
  - info:
      name: Get a catalog music video by id
      type: http
    http:
      method: GET
      url: https://api.music.apple.com/v1/catalog/:storefront/music-videos/:id
      params:
      - name: storefront
        value: ''
        type: path
        description: Apple Music storefront identifier (e.g. us, gb, jp)
      - name: id
        value: ''
        type: path
    docs: Get a catalog music video by id
  - info:
      name: Get a catalog station by id
      type: http
    http:
      method: GET
      url: https://api.music.apple.com/v1/catalog/:storefront/stations/:id
      params:
      - name: storefront
        value: ''
        type: path
        description: Apple Music storefront identifier (e.g. us, gb, jp)
      - name: id
        value: ''
        type: path
    docs: Get a catalog station by id
- info:
    name: Search
    type: folder
  items:
  - info:
      name: Search the catalog
      type: http
    http:
      method: GET
      url: https://api.music.apple.com/v1/catalog/:storefront/search
      params:
      - name: storefront
        value: ''
        type: path
        description: Apple Music storefront identifier (e.g. us, gb, jp)
      - name: term
        value: ''
        type: query
      - name: types
        value: ''
        type: query
        description: Comma-separated list of resource types (e.g. songs,albums,artists,playlists)
      - name: limit
        value: ''
        type: query
      - name: offset
        value: ''
        type: query
    docs: Search the catalog
  - info:
      name: Get search hints for the catalog
      type: http
    http:
      method: GET
      url: https://api.music.apple.com/v1/catalog/:storefront/search/hints
      params:
      - name: storefront
        value: ''
        type: path
        description: Apple Music storefront identifier (e.g. us, gb, jp)
      - name: term
        value: ''
        type: query
    docs: Get search hints for the catalog
- info:
    name: Charts
    type: folder
  items:
  - info:
      name: Get catalog charts
      type: http
    http:
      method: GET
      url: https://api.music.apple.com/v1/catalog/:storefront/charts
      params:
      - name: storefront
        value: ''
        type: path
        description: Apple Music storefront identifier (e.g. us, gb, jp)
      - name: types
        value: ''
        type: query
      - name: chart
        value: ''
        type: query
      - name: genre
        value: ''
        type: query
      - name: limit
        value: ''
        type: query
    docs: Get catalog charts
- info:
    name: Library
    type: folder
  items:
  - info:
      name: Get the user's library songs
      type: http
    http:
      method: GET
      url: https://api.music.apple.com/v1/me/library/songs
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: Get the user's library songs
  - info:
      name: Get the user's library albums
      type: http
    http:
      method: GET
      url: https://api.music.apple.com/v1/me/library/albums
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: Get the user's library albums
  - info:
      name: Get the user's library artists
      type: http
    http:
      method: GET
      url: https://api.music.apple.com/v1/me/library/artists
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: Get the user's library artists
  - info:
      name: Get the user's library playlists
      type: http
    http:
      method: GET
      url: https://api.music.apple.com/v1/me/library/playlists
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: Get the user's library playlists
  - info:
      name: Create a new library playlist
      type: http
    http:
      method: POST
      url: https://api.music.apple.com/v1/me/library/playlists
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: Create a new library playlist
  - info:
      name: Search the user's library
      type: http
    http:
      method: GET
      url: https://api.music.apple.com/v1/me/library/search
      params:
      - name: term
        value: ''
        type: query
      - name: types
        value: ''
        type: query
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: Search the user's library
  - info:
      name: Get personalized recommendations for the user
      type: http
    http:
      method: GET
      url: https://api.music.apple.com/v1/me/recommendations
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: Get personalized recommendations for the user
  - info:
      name: Get the user's recently played resources
      type: http
    http:
      method: GET
      url: https://api.music.apple.com/v1/me/recent/played
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: Get the user's recently played resources
- info:
    name: Storefronts
    type: folder
  items:
  - info:
      name: Get the user's storefront
      type: http
    http:
      method: GET
      url: https://api.music.apple.com/v1/me/storefront
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: Get the user's storefront
  - info:
      name: List all storefronts
      type: http
    http:
      method: GET
      url: https://api.music.apple.com/v1/storefronts
    docs: List all storefronts
  - info:
      name: Get a storefront
      type: http
    http:
      method: GET
      url: https://api.music.apple.com/v1/storefronts/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Get a storefront
bundled: true