Amazon Music Web API
Web API Albums V1.0
Important:
These Amazon Music documents are in preview status. Be aware that content may change. Please use the
developer forum for any questions or comments.
Albums
Retrieve albums and related meta-data from the Amazon Music catalog.
- Get Album
- Get Multiple Albums
- Get Current User's Library Albums
- Add Album to Current User's Library
- Delete Album From Current User's Library
Get Album
GET
/albums/{id}/
Authorization Scope: [music::catalog]
Get the Amazon Music catalog meta-data for a single album by album ID. The meta-data includes the album name, artist, cover art, track-listing, label and more.
Path Parameters
Name | Data Type | Required | Description |
---|---|---|---|
id | string | No | The Amazon Catalog ID of the album to be retrieved. |
Example
curl --request GET <base url>/v1/albums/B08XK843KK
--header 'x-api-key: <your security profile ID>' \
--header 'Authorization: Bearer <your auth token>'
Responses
Amazon Music response object containing:
Name | Data Type | Required | Description |
---|---|---|---|
album | album | No | An object representing the meta-data for the requested album |
Example
(Some lines omitted for brevity)
{
"data": {
"album": {
"id": "B0064UPU4G",
"globalAsin": "B0064UPU4G",
"title": "Discovery",
"shortTitle": "Discovery",
"duration": 3660,
"url": "https://music.amazon.com/albums/B0064UPU4G",
"releaseDate": "2001-03-07T05:00:00.000Z",
"availableMarkets": [
{
"id": "US",
"name": "United States"
},
...
],
"artists": [
{
"id": "B000S9ULT8",
"name": "Daft Punk",
"url": "https://music.amazon.com/artists/"
}
],
"eligibility": {
"isDownloadable": true,
"isPurchaseable": true,
"isPreviewable": true,
"isPrimeEligible": false
},
"parentalSettings": {
"isKidFriendly": false,
"hasExplicitLanguage": false
},
"tracks": [
{
"id": "B0064UPUDC",
"title": "One More Time",
"url": "https://music.amazon.com/albums/B0064UPU4G"
},
...
],
"trackCount": 14,
"images": [
{
"height": 1800,
"width": 1800,
"url": "https://m.media-amazon.com/images/I/71bsHTr6idL.jpg"
},
...
],
"label": "Daft Life Ltd./ADA France"
}
}
}
Get Multiple Albums
GET
/albums
Authorization Scope: [music::catalog]
Get the Amazon Music catalog meta-data for multiple albums identified by comma-separated catalog IDs. The meta-data includes the album name, artist, cover art, track-listing, label and more.
Query Parameters
Name | Data Type | Required | Description |
---|---|---|---|
ids | string | Yes | A comma-separated list of the IDs of the albums to be retrieved. There is a maximum limit of 100 IDs. |
Example
curl --request GET <base url>/v1/albums?ids=B08XK843KK,B08XJQM7YV
--header 'x-api-key: <your security profile ID>' \
--header 'Authorization: Bearer <your auth token>'
Responses
Amazon Music response object containing:
Name | Data Type | Required | Description |
---|---|---|---|
albums | Album[] | No | An array of Album objects |
Example
(Some lines omitted for brevity)
{
"data": {
"albums": [
{
"id": "B0064UPU4G",
"globalAsin": "B0064UPU4G",
"title": "Discovery",
"duration": 3660,
"url": "https://music.amazon.com/albums/B0064UPU4G",
"releaseDate": "2001-03-07T05:00:00.000Z",
...
},
{
"id": "B00D3PLC1K",
"globalAsin": "B00D3PLC1K",
"title": "Around the world",
"duration": 3660,
"url": "https://music.amazon.com/albums/B0064UPU4G",
"releaseDate": "1997-04-11T05:00:00.000Z",
...
}
]
}
}
Get Current User's Library Albums
GET
/me/library/albums
Authorization Scope: [music::library::read]
Get a list of library albums for the current Amazon Music user. Flags on each album in the user's library indicates whether they were purchased from Amazon Music, or uploaded by the user. Optional pagination parameters can be used to limit the number of albums returned.
Query Parameters
Name | Data Type | Required | Description |
---|---|---|---|
albumIds | string | Yes | A comma-separated list of album IDs. This method will check the user’s Like status against the specified tracks (if provided). |
limit | number | No | The maximum number of albums to return (default: 100). Minimum of 1, maximum of 100. |
cursor | string | No | The cursor/token for the page to continue pagination results from. |
Example
curl --request GET <base url>/v1/me/library/albums?limit=20
--header 'x-api-key: <your security profile ID>' \
--header 'Authorization: Bearer <your auth token>'
Responses
Amazon Music response object containing:
Name | Data Type | Required | Description |
---|---|---|---|
libraryAlbums | Response Collection | No | A collection of objects representing a list of albums and their uploaded or purchased status |
Example
(Some lines omitted for brevity)
{
"data": {
"user": {
"id": "6ozjgidgbvjdv3j6dd5jm7ipom",
"libraryAlbums": {
"pageInfo": {
"hasNextPage": false
},
"edgeCount": 2,
"edges": [
{
"purchased": false,
"uploaded": false,
"node": {
"id": "B07B62ZK5S"
},
"objectId": "15e6a15f-4c2f-4b24-a2fd-286b37ad4fa3"
},
{
"purchased": false,
"uploaded": false,
"node": {
"id": "B06VWVWDDH"
},
"objectId": "15e6a15f-4c2f-4b24-a2fd-286b37ad4fa3"
},
...
]
}
}
}
}
Add Album to Current User's Library
PUT
/me/library/albums/{id}
Authorization Scope: [music::library]
Save a specified album to the current Amazon Music user’s library.
Path Parameters
Name | Data Type | Required | Description |
---|---|---|---|
id | string | Yes | The Amazon Music catalog ID of the album to save. |
Example
curl --request PUT <base url>/v1/me/library/albums/B0101GQZGA
--header 'x-api-key: <your security profile ID>' \
--header 'Authorization: Bearer <your auth token>'
Responses
Amazon Music response object containing:
Name | Data Type | Required | Description |
---|---|---|---|
saveAlbum | Response | No | a saveAlbum object containg the Album information and the saveState of the album |
Example
{
"data": {
"saveAlbum": {
"album": {
"id": "B091MTJT3P",
"title": "All Rebel Rockers",
"url": "https://music.amazon.com/albums/B091MTJT3P"
},
"saveState": "SAVED"
}
}
}
Delete Album From Current User's Library
DELETE
/me/library/albums/{id}
Authorization Scope: [music::library]
Remove a specified album from the current Amazon Music user’s library.
Path Parameters
Name | Data Type | Required | Description |
---|---|---|---|
id | string | Yes | The Amazon Music catalog ID of the album to remove. |
Example
curl --request DELETE <base url>/v1/me/library/albums?B0101GQZGA
--header 'x-api-key: <your security profile ID>' \
--header 'Authorization: Bearer <your auth token>'
Responses
Amazon Music response object containing:
Name | Data Type | Required | Description |
---|---|---|---|
removeAlbum | Response | No |
Example
{
"data": {
"removeAlbum": {
"album": {
"id": "B091MTJT3P",
"title": "All Rebel Rockers",
"url": "https://music.amazon.com/albums/B091MTJT3P"
},
"saveState": "REMOVED"
}
}
}