Amazon Music Web API

Web API Library V1.0

Important: These Amazon Music APIs are currently in a closed Beta. To join the waitlist, select 'Music Developers' in the contact us form here.

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.

Learn more about pagination.

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"
    }
  }
}