Console sviluppatore
Ti ringraziamo per la visita. Questa pagina è per il momento disponibile solo in inglese.

Amazon Music Web API

Web API Library V1.0

Library

Retrieve and save tracks for an Amazon Music customer.

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