apple-music-api

apple music downloader — music.apple.com

endpoints

system

GET /health health check (no auth)

GET /api/config sanitized config

GET /api/stats queue stats by status/quality

jobs

POST /api/jobs create download job

{
  "url": "https://music.apple.com/...",
  "quality": "alac",
  "config": { "zip_after_download": true }
}

GET /api/jobs list jobs (?status=running, ?quality=aac-lc)

GET /api/jobs/{id} job status, progress, result

PATCH /api/jobs/{id} update pending job

DELETE /api/jobs/{id} cancel job

POST /api/jobs/{id}/retry re-queue failed/completed job

GET /api/jobs/{id}/logs job logs (add Accept: text/event-stream for SSE)

GET /api/jobs/{id}/tracks completed job files

POST /api/jobs/{id}/upload upload to gofile/pixeldrain

quality

alac — ALAC hi-res lossless (requires wrapper on :10020)

aac — AAC 256kbps

aac-lc — AAC-LC lossy

atmos — Dolby Atmos

auth

all endpoints except /health require:

Authorization: Bearer <api-key>

naming placeholders

album_folder_format

song_file_format

artist_folder_format

playlist_folder_format

per-job config

{
  "quality": "alac",
  "album_folder_format": "{AlbumName}",
  "song_file_format": "{SongNumer}. {SongName}",
  "embed_cover": true,
  "cover_size": "5000x5000",
  "embed_lrc": true,
  "lrc_type": "lyrics",
  "zip_after_download": true,
  "delete_after_zip": false,
  "upload_on_complete": true,
  "upload_service": "gofile",
  "convert_after_download": true,
  "convert_format": "flac",
  "tag_sort_order": true,
  "tag_itunes_id": true
}

config

loading...

apple-music-api — wrapper