<div align="center">
<img src="https://i.imgur.com/Xj1dUCA.jpeg" alt="Amazon Music API" width="700">
# 🎵 Amazon Music API – Unofficial
A **FastAPI REST API** for Amazon Music offering metadata, playback, search, and lookups for tracks, albums, artists, playlists, and podcasts. Includes streaming URL extraction and Widevine DRM key retrieval.
<p>
<a href="https://github.com/AmineSoukara/amazon-music/graphs/contributors">
<img src="https://img.shields.io/github/contributors/AmineSoukara/amazon-music" alt="Contributors">
</a>
<a href="https://github.com/AmineSoukara/amazon-music/commits/main">
<img src="https://img.shields.io/github/last-commit/AmineSoukara/amazon-music" alt="Last commit">
</a>
<a href="https://github.com/AmineSoukara/amazon-music/network/members">
<img src="https://img.shields.io/github/forks/AmineSoukara/amazon-music" alt="Forks">
</a>
<a href="https://github.com/AmineSoukara/amazon-music/stargazers">
<img src="https://img.shields.io/github/stars/AmineSoukara/amazon-music?color=yellow" alt="Stars">
</a>
<a href="https://github.com/AmineSoukara/amazon-music/issues">
<img src="https://img.shields.io/github/issues/AmineSoukara/amazon-music?color=purple" alt="Open Issues">
</a>
<a href="https://github.com/AmineSoukara/amazon-music/blob/main/LICENSE">
<img src="https://img.shields.io/github/license/AmineSoukara/amazon-music.svg" alt="License">
</a>
</p>
<h4>
<a href="https://amazon-music-api.vercel.app">API Docs</a>
<span> · </span>
<a href="https://github.com/AmineSoukara/amazon-music/issues">Report Bug</a>
<span> · </span>
<a href="https://github.com/AmineSoukara/amazon-music/issues">Request Feature</a>
</h4>
---
> ⚠️ The API is still in development. For issues or suggestions: [contact support](https://bio.link/aminesoukara). Also This API requires a premium Amazon Music account. If you find it useful and have a premium account you'd like to donate, it would be greatly appreciated. Donations help keep the API running and support multi-region access.
---
## 📦 Installation
```bash
pip install amazon-music
```
## 🖥️ CLI Usage
The command-line interface provides easy access to Amazon Music content:
### Basic Commands
```bash
amz [URL_OR_ID] [OPTIONS]
```
<div align="left">
### Examples
```bash
# Download an track
amz https://music.amazon.com/albums/B077FLX9ZQ?trackAsin=B077F6QG2S
# Download an album
amz https://music.amazon.com/albums/B077FLX9ZQ
# Download a playlist with high quality
amz https://music.amazon.com/playlists/B0FBL3CC8M -q High
# Download a track by ID
amz B077F6QG2S -t track
```
### CLI Options
```
positional arguments:
url_or_id Amazon Music URL or ID
options:
-h, --help show this help message and exit
--config Interactive configuration setup
-q, --quality {Max,Master,High,Normal,Medium,Low,Free}
Audio quality preference (default: Normal)
-t, --type {auto,track,album,playlist}
Content type (default: auto-detect)
-o OUTPUT, --output OUTPUT
Output directory (default: ./Music)
--temp-dir TEMP_DIR
Temporary directory (default: ./Music/temp)
--format-folder {1,2,3,4}
Folder naming format (1-4, default: 4)
--format-track {1,2,3,4}
Track naming format (1-4, default: 4)
--workers WORKERS Number of parallel download workers (default: 2)
--zip Create ZIP archive for albums/playlists
--overwrite Overwrite existing files
--token TOKEN Amazon Music API access token
--clear-token Remove stored access token
--show-token Show the stored access token
```
</div>
## 🔐 Auth Token
Star the repository on GitHub, then click "Get Auth Tokens" to access your authentication credentials. [Click Here](https://amazon-music-api.vercel.app/login)
## 🎵 Quality
| Quality | Specification | Bitrate | Format |
|-----------|----------------------------------------|------------------|--------|
| Low | 48kbps | 48 kbps | OPUS |
| Medium | 192kbps | 192 kbps | OPUS |
| Normal | 320kbps | 320 kbps | OPUS |
| High | ≤16-bit / ≤48 kHz | ≤1411 kbps | FLAC |
| Master | 24-bit / ≤96 kHz | ≥2300 kbps | FLAC |
| Max | 24-bit / ≤192 kHz | ≥4600 kbps | FLAC |
### 📁 File & Folder Naming Formats
#### Track File Formats
| ID | Format Name | Example Output |
|----|------------------------|-----------------------------------------|
| 1 | TITLE_ARTIST | {track_explicit}{title} - {artist} |
| 2 | TITLE_ARTIST_QUALITY | {title} - {artist} ({quality}) |
| 3 | ARTIST_TITLE | {artist} - {title} |
| 4 | ARTIST_TITLE_QUALITY | {artist} - {title} ({quality}) |
#### Album Folder Formats
| ID | Format Name | Example Output |
|----|--------------------------|-----------------------------------------|
| 1 | ALBUM_ARTIST | {album_explicit}{album} - {album_artist}|
| 2 | ALBUM_ARTIST_QUALITY | {album} - {album_artist} ({quality}) |
| 3 | ARTIST_ALBUM | {album_artist} - {album} |
| 4 | ARTIST_ALBUM_QUALITY | {album_artist} - {album} ({quality}) |
## 🔗 Quick Links
- **Base URL**: [Click Here](https://amazon-music-api.vercel.app)
---
## 📚 Endpoints Overview
| Method | Endpoint | Description |
| ------ | ----------------------------------- | ---------------------------------------- |
| `GET` | `/login` | Get Access Tokens |
| `GET` | `/account` | Get authenticated account info |
| `GET` | `/search?query={query}&type={type}` | Search Amazon Music |
| `GET` | `/track?id={track_id}` | Get metadata for a track |
| `GET` | `/album?id={album_id}` | Get album details including tracks |
| `GET` | `/artist?id={artist_id}` | Get artist info and discography |
| `GET` | `/playlist?id={playlist_id}` | Get official playlist info |
| `GET` | `/community_playlist?id={playlist_id}` | Get community playlist info |
| `GET` | `/episode?id={episode_id}` | Get a podcast episode |
| `GET` | `/podcast?id={podcast_id}` | Get a podcast show and episodes |
| `GET` | `/lyrics?id={track_id}` | Get lyrics |
| `GET` | `/stream_urls?id={track_id}` | Get streaming URLs in multiple qualities |
| `POST` | `/widevine_key` | Decrypt Widevine DRM using PSSH |
---
## ⚠️ Legal Disclaimer
This project is intended for **educational and research purposes only**. It interacts with **Amazon’s internal APIs**, which may **violate their [Terms of Service](https://www.amazon.com/gp/help/customer/display.html?nodeId=508088)**.
The authors are **not affiliated with Amazon**. This software is provided **“as is” without any warranties**, express or implied. Use of this tool is **at your own risk**, and you are solely responsible for ensuring **compliance with applicable laws and terms** in your country or region.
This project is **non-commercial** and does **not host or distribute any Amazon-owned content**.
---
## 👨💻 Dev & Support
<a href="https://bio.link/aminesoukara"><img src="https://img.shields.io/badge/@AmineSoukara-000000?style=flat&logo=messenger&logoColor=white&logoWidth=100"></a>
<a href="https://t.me/DezAltySupport"><img src="https://img.shields.io/badge/Group-FF0000?style=flat&logo=telegram&logoColor=white&logoWidth=100"></a>
<a href="https://t.me/DezAlty"><img src="https://img.shields.io/badge/Channel-FF0000?style=flat&logo=telegram&logoColor=white&logoWidth=100"></a>
---
> ⭐️ If you find this project useful, please consider starring the repo! It helps support the project and keeps it visible to others.
---
</div>
Raw data
{
"_id": null,
"home_page": "https://github.com/AmineSoukara/Amazon-Music",
"name": "amazon-music",
"maintainer": "Amine Soukara",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "AmineSoukara@gmail.com",
"keywords": "amazon, music, cli, api, downloader, streaming, audio",
"author": "Amine Soukara",
"author_email": "AmineSoukara@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/f9/a3/c11d681c3450deb934aee2d82d1285f250177f5d8544acf19ea4886ac2bb/amazon_music-1.7.4.tar.gz",
"platform": null,
"description": " <div align=\"center\">\n <img src=\"https://i.imgur.com/Xj1dUCA.jpeg\" alt=\"Amazon Music API\" width=\"700\">\n\n# \ud83c\udfb5 Amazon Music API \u2013 Unofficial\n\nA **FastAPI REST API** for Amazon Music offering metadata, playback, search, and lookups for tracks, albums, artists, playlists, and podcasts. Includes streaming URL extraction and Widevine DRM key retrieval.\n<p>\n <a href=\"https://github.com/AmineSoukara/amazon-music/graphs/contributors\">\n <img src=\"https://img.shields.io/github/contributors/AmineSoukara/amazon-music\" alt=\"Contributors\">\n </a>\n <a href=\"https://github.com/AmineSoukara/amazon-music/commits/main\">\n <img src=\"https://img.shields.io/github/last-commit/AmineSoukara/amazon-music\" alt=\"Last commit\">\n </a>\n <a href=\"https://github.com/AmineSoukara/amazon-music/network/members\">\n <img src=\"https://img.shields.io/github/forks/AmineSoukara/amazon-music\" alt=\"Forks\">\n </a>\n <a href=\"https://github.com/AmineSoukara/amazon-music/stargazers\">\n <img src=\"https://img.shields.io/github/stars/AmineSoukara/amazon-music?color=yellow\" alt=\"Stars\">\n </a>\n <a href=\"https://github.com/AmineSoukara/amazon-music/issues\">\n <img src=\"https://img.shields.io/github/issues/AmineSoukara/amazon-music?color=purple\" alt=\"Open Issues\">\n </a>\n <a href=\"https://github.com/AmineSoukara/amazon-music/blob/main/LICENSE\">\n <img src=\"https://img.shields.io/github/license/AmineSoukara/amazon-music.svg\" alt=\"License\">\n </a>\n</p>\n\n<h4>\n <a href=\"https://amazon-music-api.vercel.app\">API Docs</a>\n <span> \u00b7 </span>\n <a href=\"https://github.com/AmineSoukara/amazon-music/issues\">Report Bug</a>\n <span> \u00b7 </span>\n <a href=\"https://github.com/AmineSoukara/amazon-music/issues\">Request Feature</a>\n</h4>\n\n\n---\n> \u26a0\ufe0f The API is still in development. For issues or suggestions: [contact support](https://bio.link/aminesoukara). Also This API requires a premium Amazon Music account. If you find it useful and have a premium account you'd like to donate, it would be greatly appreciated. Donations help keep the API running and support multi-region access.\n\n---\n\n## \ud83d\udce6 Installation\n```bash\npip install amazon-music\n```\n\n## \ud83d\udda5\ufe0f CLI Usage\nThe command-line interface provides easy access to Amazon Music content:\n\n### Basic Commands\n```bash\namz [URL_OR_ID] [OPTIONS]\n```\n\n<div align=\"left\">\n \n### Examples\n```bash\n# Download an track\namz https://music.amazon.com/albums/B077FLX9ZQ?trackAsin=B077F6QG2S\n\n# Download an album\namz https://music.amazon.com/albums/B077FLX9ZQ\n\n# Download a playlist with high quality\namz https://music.amazon.com/playlists/B0FBL3CC8M -q High\n\n# Download a track by ID\namz B077F6QG2S -t track\n```\n\n### CLI Options\n```\npositional arguments:\n url_or_id Amazon Music URL or ID\n\noptions:\n -h, --help show this help message and exit\n --config Interactive configuration setup\n -q, --quality {Max,Master,High,Normal,Medium,Low,Free}\n Audio quality preference (default: Normal)\n -t, --type {auto,track,album,playlist}\n Content type (default: auto-detect)\n -o OUTPUT, --output OUTPUT\n Output directory (default: ./Music)\n --temp-dir TEMP_DIR \n Temporary directory (default: ./Music/temp)\n --format-folder {1,2,3,4}\n Folder naming format (1-4, default: 4)\n --format-track {1,2,3,4}\n Track naming format (1-4, default: 4)\n --workers WORKERS Number of parallel download workers (default: 2)\n --zip Create ZIP archive for albums/playlists\n --overwrite Overwrite existing files\n --token TOKEN Amazon Music API access token\n --clear-token Remove stored access token\n --show-token Show the stored access token\n ```\n</div>\n\n## \ud83d\udd10 Auth Token\nStar the repository on GitHub, then click \"Get Auth Tokens\" to access your authentication credentials. [Click Here](https://amazon-music-api.vercel.app/login)\n\n## \ud83c\udfb5 Quality\n\n| Quality | Specification | Bitrate | Format |\n|-----------|----------------------------------------|------------------|--------|\n| Low | 48kbps | 48 kbps | OPUS |\n| Medium | 192kbps | 192 kbps | OPUS |\n| Normal | 320kbps | 320 kbps | OPUS |\n| High | \u226416-bit / \u226448 kHz | \u22641411 kbps | FLAC |\n| Master | 24-bit / \u226496 kHz | \u22652300 kbps | FLAC |\n| Max | 24-bit / \u2264192 kHz | \u22654600 kbps | FLAC |\n\n### \ud83d\udcc1 File & Folder Naming Formats\n\n#### Track File Formats\n\n| ID | Format Name | Example Output |\n|----|------------------------|-----------------------------------------|\n| 1 | TITLE_ARTIST | {track_explicit}{title} - {artist} |\n| 2 | TITLE_ARTIST_QUALITY | {title} - {artist} ({quality}) |\n| 3 | ARTIST_TITLE | {artist} - {title} |\n| 4 | ARTIST_TITLE_QUALITY | {artist} - {title} ({quality}) |\n\n#### Album Folder Formats\n\n| ID | Format Name | Example Output |\n|----|--------------------------|-----------------------------------------|\n| 1 | ALBUM_ARTIST | {album_explicit}{album} - {album_artist}|\n| 2 | ALBUM_ARTIST_QUALITY | {album} - {album_artist} ({quality}) |\n| 3 | ARTIST_ALBUM | {album_artist} - {album} |\n| 4 | ARTIST_ALBUM_QUALITY | {album_artist} - {album} ({quality}) |\n\n## \ud83d\udd17 Quick Links\n- **Base URL**: [Click Here](https://amazon-music-api.vercel.app)\n\n---\n\n## \ud83d\udcda Endpoints Overview\n\n| Method | Endpoint | Description |\n| ------ | ----------------------------------- | ---------------------------------------- |\n| `GET` | `/login` | Get Access Tokens |\n| `GET` | `/account` | Get authenticated account info |\n| `GET` | `/search?query={query}&type={type}` | Search Amazon Music |\n| `GET` | `/track?id={track_id}` | Get metadata for a track |\n| `GET` | `/album?id={album_id}` | Get album details including tracks |\n| `GET` | `/artist?id={artist_id}` | Get artist info and discography |\n| `GET` | `/playlist?id={playlist_id}` | Get official playlist info |\n| `GET` | `/community_playlist?id={playlist_id}` | Get community playlist info |\n| `GET` | `/episode?id={episode_id}` | Get a podcast episode |\n| `GET` | `/podcast?id={podcast_id}` | Get a podcast show and episodes |\n| `GET` | `/lyrics?id={track_id}` | Get lyrics |\n| `GET` | `/stream_urls?id={track_id}` | Get streaming URLs in multiple qualities |\n| `POST` | `/widevine_key` | Decrypt Widevine DRM using PSSH |\n\n---\n\n## \u26a0\ufe0f Legal Disclaimer\n\nThis project is intended for **educational and research purposes only**. It interacts with **Amazon\u2019s internal APIs**, which may **violate their [Terms of Service](https://www.amazon.com/gp/help/customer/display.html?nodeId=508088)**.\nThe authors are **not affiliated with Amazon**. This software is provided **\u201cas is\u201d without any warranties**, express or implied. Use of this tool is **at your own risk**, and you are solely responsible for ensuring **compliance with applicable laws and terms** in your country or region.\nThis project is **non-commercial** and does **not host or distribute any Amazon-owned content**.\n\n---\n\n## \ud83d\udc68\u200d\ud83d\udcbb Dev & Support\n\n<a href=\"https://bio.link/aminesoukara\"><img src=\"https://img.shields.io/badge/@AmineSoukara-000000?style=flat&logo=messenger&logoColor=white&logoWidth=100\"></a>\n<a href=\"https://t.me/DezAltySupport\"><img src=\"https://img.shields.io/badge/Group-FF0000?style=flat&logo=telegram&logoColor=white&logoWidth=100\"></a>\n<a href=\"https://t.me/DezAlty\"><img src=\"https://img.shields.io/badge/Channel-FF0000?style=flat&logo=telegram&logoColor=white&logoWidth=100\"></a>\n\n---\n\n\n\n> \u2b50\ufe0f If you find this project useful, please consider starring the repo! It helps support the project and keeps it visible to others.\n\n\n---\n</div>\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Python package for interacting with Amazon Music services",
"version": "1.7.4",
"project_urls": {
"Changelog": "https://github.com/AmineSoukara/Amazon-Music/releases",
"Documentation": "https://github.com/AmineSoukara/Amazon-Music#readme",
"Homepage": "https://github.com/AmineSoukara/Amazon-Music",
"Source": "https://github.com/AmineSoukara/Amazon-Music",
"Tracker": "https://github.com/AmineSoukara/Amazon-Music/issues"
},
"split_keywords": [
"amazon",
" music",
" cli",
" api",
" downloader",
" streaming",
" audio"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "d6177dc0308c287509be65281c3d054c7197911db0c6188bee83853a3c21e68f",
"md5": "66f436b51c9ed2adc02496f1807f7bcb",
"sha256": "5edc94f5251979b5f146a95ac14f721b707d7753e0ece9ac312f770eba8f6bfc"
},
"downloads": -1,
"filename": "amazon_music-1.7.4-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "66f436b51c9ed2adc02496f1807f7bcb",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.8",
"size": 27327,
"upload_time": "2025-07-17T02:21:12",
"upload_time_iso_8601": "2025-07-17T02:21:12.555001Z",
"url": "https://files.pythonhosted.org/packages/d6/17/7dc0308c287509be65281c3d054c7197911db0c6188bee83853a3c21e68f/amazon_music-1.7.4-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "f9a3c11d681c3450deb934aee2d82d1285f250177f5d8544acf19ea4886ac2bb",
"md5": "9fc400a7343f4cca90c572d4d097e773",
"sha256": "dfe6f59df5144eb6f947ddf0eda6222b8821786717c867fd92cefa02660580b4"
},
"downloads": -1,
"filename": "amazon_music-1.7.4.tar.gz",
"has_sig": false,
"md5_digest": "9fc400a7343f4cca90c572d4d097e773",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 23375,
"upload_time": "2025-07-17T02:21:13",
"upload_time_iso_8601": "2025-07-17T02:21:13.808060Z",
"url": "https://files.pythonhosted.org/packages/f9/a3/c11d681c3450deb934aee2d82d1285f250177f5d8544acf19ea4886ac2bb/amazon_music-1.7.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-17 02:21:13",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "AmineSoukara",
"github_project": "Amazon-Music",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "amazon-music"
}
JSON
