Amazon Music Web API
Web API Library 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.
Library
Retrieve and save tracks for an Amazon Music customer.
- Get Current User's Playlists
- Add Track to Current User's Library
- Delete Track From Current User's Library
Get Current User's Playlists
GET
/me/playlists
Get a list of the playlists owned by the current Amazon Music user. Optional parameters can be used to limit the number of playlists returned.
Query Parameters
Name | Data Type | Required | Description |
---|---|---|---|
limit | number | No | The maximum number of playlists 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/playlists?limit=2' \
--header 'x-api-key: <your security profile ID>' \
--header 'Authorization: Bearer <your auth token>'
Response
Amazon Music response object containing a response collection of the current users playlists.
Name | Data Type | Required | Description |
---|---|---|---|
browseCategories | Response Collection | No | Collection of playlists owned by the current user |
Example
{
"data": {
"user": {
"id": "6ozjgidgbvjdv3j6dd5jm7ipom",
"playlists": {
"pageInfo": {
"hasNextPage": false
},
"edgeCount": 2,
"edges": [
{
"cursor": "0:15e6a15f-4c2f-4b24-a2fd-286b37ad4fa3",
"node": {
"id": "15e6a15f-4c2f-4b24-a2fd-286b37ad4fa3",
"curator": {
"id": "6ozjgidgbvjdv3j6dd5jm7ipom"
},
"duration": 3450,
"images": [
{
"url": "https://images-na.ssl-images-amazon.com/images/Playlists.png",
"imageType": "PRIMARY"
}
],
"eligibility": {
"playback": {
"canPlayOnDemand": true,
"shuffleType": "INLINE"
},
"playbackSubscriptionTiers": [],
"isDownloadable": false,
"isPurchaseable": false,
"isPreviewable": false,
"isPrimeEligible": false
},
"title": "00 Rock",
"trackCount": 12,
"url": "https://music.amazon.ca/my/playlists/b2c6606b",
"visibility": "PRIVATE"
}
},
{
"cursor": "1:28a56e15-99ea-4e0b-989e-2ba8b19c1aae",
"node": {
"id": "28a56e15-99ea-4e0b-989e-2ba8b19c1aae",
"curator": {
"id": "6ozjgidgbvjdv3j6dd5jm7ipom"
},
"duration": 1084,
"images": [
{
"url": "https://m.media-amazon.com/images/I/81P1PrmwR5L.jpg"
}
],
"title": "311 Day",
"trackCount": 6,
"url": "https://music.amazon.ca/my/playlists/1e858b97"
}
}
]
}
}
}
}
Add Track to Current User's Library
PUT
/me/library/tracks/{id}
Save a specified track 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 track to save. |
Example
curl --request PUT '<base url>/v1/me/library/tracks/B08DL2BXQC' \
--header 'x-api-key: <your security profile ID>' \
--header 'Authorization: Bearer <your auth token>'
Response
Amazon Music response object containing:
Name | Data Type | Required | Description |
---|---|---|---|
saveTrack | SaveTrackResponse | No | Data about the saved Amazon Music track |
Example
{
"data": {
"saveTrack": {
"track": {
"id": "B08DL2BXQC",
"title": "Kane Train",
"isrc": "GBCFB2000356",
"url": "https://music.amazon.com/albums/B08DL2H5PV/?trackAsin=B08DL2BXQC"
},
"saveState": "SAVED"
}
}
}
Delete Track From Current User's Library
DELETE
/me/library/tracks/{id}
Remove a specified track 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 track to remove. |
curl --request DELETE '<base url>/v1/me/library/tracks/B097S29G3W' \
--header 'x-api-key: <your security profile ID>' \
--header 'Authorization: Bearer <your auth token>'
Response
Amazon Music response object containing:
Name | Data Type | Required | Description |
---|---|---|---|
removeTrack | SaveTrackResponse | No | Data about the removed Amazon Music track |
Example
{
"data": {
"removeTrack": {
"track": {
"id": "B097S185X9",
"title": "Something To Believe In",
"isrc": "USATO2100125",
"url": "https://music.amazon.com/albums/B097S29G3W/?trackAsin=B097S185X9"
},
"saveState": "REMOVED"
}
}
}