Consola del desarrollador
Gracias por tu visita. Esta página solo está disponible en inglés.

Amazon Music Web API

Web API User V1.0

User

Get Amazon Music data related to users.

Current User

Get Current User

GET
/me
Authorization Scope: [music::profile]
Get detailed information about the current Amazon Music user (including their username and subscription tier).

Example

curl --request GET '<base url>/v1/me' \
--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
user User No Data about the current Amazon Music user

Example

{
  "data": {
    "user": {
      "id": "k35wo4lm34masdsadevrs7a",
      "name": "Test Test",
      "images": [
        {
          "height": 0,
          "width": 0,
          "url": "https://images-na.ssl-images-amazon.com/images/profile.png"
        }
      ],
      "url": "https://music.amazon.com/profiles/k35wo4lm34maumbz2vir6xgs7a"
    }
  }
}

Update Current User

PUT
/me
Authorization Scope: [music::profile:read]
Update profile information for the current user.

Body Parameters

Name Data Type Required Description
name string Yes The name to update the current user with.
visibility string Yes The visibility type of the user. This is an enumerated type. The allowed values are ‘PUBLIC’ and ‘PRIVATE’.
playbackVisibility string Yes The visibility type of the user's playback. This is an enumerated type. The allowed values are ‘PUBLIC’ and ‘PRIVATE’.

Example

curl --request PUT '<base url>/v1/me' \
--header 'x-api-key: <your security profile ID>' \
--header 'Authorization: Bearer <your auth token>' \
--header 'Content-Type: application/json' \
--data \
'{
  "name": "New Name",
  "visibility": "PUBLIC",
  "playbackVisibility": "PUBLIC"
}'

Responses

Amazon Music response object containing:

Name Data Type Required Description
updateUser User No Data about the updated Amazon Music user

Example

{
	"id": "hznmiapzd7e43yl53qp6tvuw44",
	"name": null,
	"images": [
		{
			"height": 0,
			"width": 0,
			"url": "https://images-na.ssl-images-amazon.com/images/S/amazon-avatars-global/default._CR0,0,1024,1024_SX500__UX358_FMpng_QL85_.png",
			"imageType": "PROFILE"
		}
	],
	"tier": "UNLIMITED",
	"visibility": "PUBLIC",
	"playbackVisibility": null,
	"url": "https://music.amazon.com/profiles/hznmiapzd7e43yl53qp6tvuw44?ref=dm_ff_amazonmusic.3p"
}

Get Current User's Library Tracks

GET
/me/library/tracks
Authorization Scope: [music::profile:read]
Get a list of library tracks for the current Amazon Music user. Optional parameters can be used to limit the number of tracks returned.

Learn more about pagination.

Query Parameters

Name Data Type Required Description
trackIds string No A comma-separated list of track IDs. This method will check the user’s Like status against the specified tracks (if provided).
limit number No The maximum number of tracks 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/tracks' \
--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
user User No Data about the current Amazon Music user, including their library tracks

Example

{
  "data": {
    "user": {
      "id": "6ozjgidgbvjdv3j6dd5jm7ipom",
      "libraryTracks": {
        "pageInfo": {
          "hasNextPage": false
        },
        "edgeCount": 2,
        "edges": [
          {
            "uploaded": false,
            "purchased": false,
            "node": {
              "id": "B07B62ZK5S"
            }
          },
          {
            "uploaded": false,
            "purchased": false,
            "node": {
              "id": "B06VWVWDDH"
            }
          }
        ]
      }
    }
  }
}

Get Current User Followers

GET
/me/followers
Authorization Scope: [music::favorites:read]
Get the current Amazon Music user’s list of followers. Optional parameters can be used to limit the number of followers returned.

Learn more about pagination.

Query Parameters

Name Data Type Required Description
limit number No The maximum number of followers 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/followers' \
--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
user User No Data about the current Amazon Music user, including followers

Example

{
  "data": {
    "user": {
      "id": "zqll6htnhyb2welrqsrtrhdvaa",
      "name": "Tony Starked",
      "url": "https://music.amazon.com/profiles/zqll6htnhyb2welrqsrtrhdvaa",
      "followers": {
        "pageInfo": {
          "hasNextPage": true,
          "token": "rO0ABXNyADhjb20uYW1hem9uLm11c2ljLnJlbGF0aW9uc2hpcC5ncmFwaC5wYWdpbmF0aW9uLlBhZ2VUb2tlbjR9daSapeQtAgADSQAFaW5kZXhJAAhwYWdlU2l6ZUwACXRpbWVzdGFtcHQAE0xqYXZhL3RpbWUvSW5zdGFudDt4cAAAAAIAAAACc3IADWphdmEudGltZS5TZXKVXYS6GyJIsgwAAHhwdw0CAAAAAGD54RobqBQAeA=="
        },
        "edgeCount": 2,
        "edges": [
          {
            "node": {
              "id": "uj7wxenmftr26zlg7eo4maa744",
              "name": "Jane M",
              "url": "https://music.amazon.com/profiles/uj7wxenmftr26zlg7eo4maa744"
            }
          },
          {
            "node": {
              "id": "zz2hu7x4v2u2bhzyh5bsb4xvje",
              "name": "Amit",
              "url": "https://music.amazon.com/profiles/zz2hu7x4v2u2bhzyh5bsb4xvje"
            }
          }
        ]
      }
    }
  }
}

Get Current User's Followed Users

GET
/me/followed/users
Authorization Scope: [music::favorites:read]
Get the current user’s list of followed users. Optional parameters can be used to limit the number of followed users to return.

Learn more about pagination.

Query Parameters

Name Data Type Required Description
limit number No The maximum number of users 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/followed/users' \
--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
user User No Data about the current Amazon Music user, including followed users

Example

{
  "data": {
    "user": {
      "id": "zqll6htnhyb2welrqsrtrhdvaa",
      "name": "Tony Starked",
      "url": "https://music.amazon.com/profiles/zqll6htnhyb2welrqsrtrhdvaa",
      "followedUsers": {
        "pageInfo": {
          "hasNextPage": true,
          "token": "rO0ABXNyADhjb20uYW1hem9uLm11c2ljLnJlbGF0aW9uc2hpcC5ncmFwaC5wYWdpbmF0aW9uLlBhZ2VUb2tlbjR9daSapeQtAgADSQAFaW5kZXhJAAhwYWdlU2l6ZUwACXRpbWVzdGFtcHQAE0xqYXZhL3RpbWUvSW5zdGFudDt4cAAAAAUAAAAFc3IADWphdmEudGltZS5TZXKVXYS6GyJIsgwAAHhwdw0CAAAAAGD55G8Qgq9AeA=="
        },
        "edgeCount": 2,
        "edges": [
          {
            "node": {
              "id": "ajdzyygpbolfqstxggxmqn4ouu",
              "name": "Victor Max",
              "url": "https://music.amazon.com/profiles/lgwup3erbjovmjxwf6sb2hm35m"
            }
          },
          {
            "node": {
              "id": "lgwup3erbjovmjxwf6sb2hm35m",
              "name": "El Victor",
              "url": "https://music.amazon.com/profiles/lgwup3erbjovmjxwf6sb2hm35m"
            }
          }
        ]
      }
    }
  }
}

Get Current User's Followed Playlists

GET
/me/followed/playlists
Authorization Scope: [music::favorites:read]
Get the current Amazon Music user’s list of followed playlists. Optional parameters can be used to limit the number of playlists returned.

Learn more about pagination.

Query Parameters

Name Data Type Required Description
playlistIds string No Playlist IDs to limit the results to.
limit number No The maximum number of artists 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/followed/playlists' \
--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
user User No Data about the current Amazon Music user, including followed playlists

Example

{
  "data": {
    "user": {
      "id": "zqll6htnhyb2welrqsrtrhdvaa",
      "name": "Tony Starked",
      "url": "https://music.amazon.com/profiles/zqll6htnhyb2welrqsrtrhdvaa",
      "followedPlaylists": {
        "pageInfo": {
          "hasNextPage": false
        },
        "edgeCount": 2,
        "edges": [
          {
            "node": {
              "id": "B01LS62KK2",
              "name": "CLASSIC ROCK HITS",
              "url": "https://music.amazon.com/playlists/B01LS62KK2"
            }
          },
          {
            "node": {
              "id": "B01LOXC1UI",
              "name": "HIP-HOP CLASSICS",
              "url": "https://music.amazon.com/playlists/B01LOXC1UI"
            }
          }
        ]
      }
    }
  }
}

Add Followed Artist For Current User

PUT
/me/followed/artists/{id}
Authorization Scope: [music::favorites]
Add an artist to the current user's followed artist list.

Learn more about pagination.

Path Parameters

Name Data Type Required Description
id string Yes The Amazon Music ID of the artist to make the current user follow.

Example

curl --request PUT <base url>/v1/me/followed/artists/B000QKGN8W
--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
followedArtist Response No Data about the Amazon Music artist that has been followed

Example

{
  "data": {
    "followArtist": {
      "artist": {
        "id": "B000QKGN8W",
        "name": "Coldplay",
        "url": "https://music.amazon.com/artists/B000QKGN8W"
      },
      "followState": "FOLLOW"
    }
  }
}

Remove Followed Artist From Current User

DELETE
/me/followed/artists/{id}
Authorization Scope: [music::favorites]
Remove the current user as a follower of the specified artist.

Path Parameters

Name Data Type Required Description
id string Yes The Amazon Music ID of the artist to make the current user un-follow.

Example

curl --request DELETE <base url>/v1/me/followed/artists/B000QKGN8W
--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
unfollowArtist Response No Data about the Amazon Music artist that has been un-followed
Example
{
  "data": {
    "followArtist": {
      "artist": {
        "id": "B000QKGN8W",
        "name": "Coldplay",
        "url": "https://music.amazon.com/artists/B000QKGN8W"
      },
      "followState": "UNFOLLOW"
    }
  }
}

Add Followed User For Current User

PUT
/me/followed/users/{id}
Authorization Scope: [music::favorites]
Add a specified user to the the current user's list of followed users.

Path Parameters

Name Data Type Required Description
id string Yes The Amazon Music ID of the user to make the current user follow.

Example

curl --request PUT <base url>/v1/me/followed/users/zz2hu7x4ert4gferzyh5bsb4xvje
--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
followUser Response No Data about the Amazon Music user that has been followed
Example
{
  "data": {
    "followUser": {
      "user": {
        "id": "zz2hu7x4ert4gferzyh5bsb4xvje",
        "name": "Amit",
        "url": "https://music.amazon.com/profiles/zz2hu7x4v2u2bhzyh5bsb4xvje"
      },
      "followState": "FOLLOW"
    }
  }
}

Remove Followed User From Current User

DELETE
/me/followed/users/{id}
Authorization Scope: [music::favorites]
Remove a specified user from the the current user's list of followed users.

Path Parameters

Name Data Type Required Description
id string Yes The user ID of the user to unfollow.

Example

curl --request DELETE <base url>/v1/me/followed/users/zz2hu7x4v2ureqerb4xvje
--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
unfollowUser Response No Data about the Amazon Music user that has been unfollowed

Example

{
  "data": {
    "unfollowUser": {
      "user": {
        "id": "zz2hu7x4v2ureqerb4xvje",
        "name": "Amit",
        "url": "https://music.amazon.com/profiles/zz2hu7x4v2u2bhzyh5bsb4xvje"
      },
      "followState": "UNFOLLOW"
    }
  }
}

Get Current User's Followed Podcast Shows

GET
/me/followed/podcasts/shows
Authorization Scope: [music::favorites:read]
Get the current user’s list of followed podcast shows. Optional parameters can be used to limit the number of shows returned.

Learn more about pagination.

Query Parameters

Name Data Type Required Description
limit number No The maximum number of podcast shows 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

https://api.music.amazon.dev/v1/albums?ids=abcd1234,XYZABC123

Responses

Amazon Music response object containing:

Name Data Type Required Description
user User No Data about the current Amazon Music user and their followed podcast shows

Example

{
  "data": {
    "user": {
      "id": "zqll6htnhyb2welrqsrtrhdvaa",
      "name": "Tony Starked",
      "followedPodcastShows": {
        "pageInfo": {
          "hasNextPage": false
        },
        "edgeCount": 3,
        "edges": [
          {
            "node": {
              "id": "8bfa8155-888b-4553-acd3-8f22d43b4c9e",
              "title": "DISGRACELAND",
              "url": "https://music.amazon.com/podcasts/8bfa8155-888b-4553-acd3-8f22d43b4c9e/DISGRACELAND"
            }
          },
          {
            "node": {
              "id": "7e8c8b9f-ab40-49ad-9efb-fdb0960979a8",
              "title": "One Hundred Percent with Marcus Lemonis",
              "url": "https://music.amazon.com/podcasts/7e8c8b9f-ab40-49ad-9efb-fdb0960979a8/One-Hundred Percent with Marcus Lemonis"
            }
          },
          {
            "node": {
              "id": "d6e3946e-6b3f-48dc-a3ae-fdc7c9d699f0",
              "title": "Crime Junkie",
              "url": "https://music.amazon.com/podcasts/d6e3946e-6b3f-48dc-a3ae-fdc7c9d699f0/Crime-Junkie"
            }
          }
        ]
      }
    }
  }
}

Non-current User

Get User

GET
/users/{id}
Authorization Scope: [music::catalog]
Get public profile information about a specified Amazon Music user. Includes name, tier, and more.

Path Parameters

Name Data Type Required Description
id string Yes The requested user’s Amazon Music ID.

Example

curl --request GET '<base url>/v1/users/k35wo4lm34masdsadevrs7a' \
--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
user User No Data about the specified Amazon Music user

Example

{
  "data": {
    "user": {
      "id": "k35wo4lm34masdsadevrs7a",
      "name": "Test Test",
      "images": [
        {
          "height": 0,
          "width": 0,
          "url": "https://images-na.ssl-images-amazon.com/images/profile.png"
        }
      ],
      "tier": "UNLIMITED",
      "visibility": "PRIVATE",
      "playbackVisibility": "PRIVATE",
      "url": "https://music.amazon.com/profiles/k35wo4lm34maumbz2vir6xgs7a"
    }
  }
}

Get Multiple Users

GET
/users
Authorization Scope: [music::catalog]
Get public profile information for multiple Amazon Music users, identified by comma-separated IDs. This includes name, tier, and more.

Query Parameters

Name Data Type Required Description
ids string Yes A comma-separated list of the Amazon Music IDs for the user. Maximum: 100 IDs.

Example

curl --request GET '<base url>/v1/users?ids=k35wo4lm34masdsadevrs7a,q4rno6sdfhqers7dnoiq' \
--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
user User[] No Data about the specified Amazon Music users

Example

{
  "data": {
    "users": [
      {
        "id": "k35wo4lm34maumbz2vir6xgs7a",
        "name": "Test Test",
        "images": [
          {
            "height": 0,
            "width": 0,
            "url": "https://images-na.ssl-images-amazon.com/images/profile.png"
          }
        ],
        "url": "https://music.amazon.com/profiles/k35wo4lm34maumbz2vir6xgs7a"
      },
      {
        "id": "q4rno6sdfhqers7dnoiq",
        "name": "Test Test",
        "images": [
          {
            "height": 0,
            "width": 0,
            "url": "https://images-na.ssl-images-amazon.com/images/profile.png"
          }
        ],
        "url": "https://music.amazon.com/profiles/q4rno6sdfhqers7dnoiq"
      },
    ]
  }
}

Get User's Followers

GET
/users/{id}/followers
Authorization Scope: [music::catalog]
Get a list of a specified public Amazon Music user’s followers. Optional parameters can be used to limit the number of followers returned.

Learn more about pagination.

Path Parameters

Name Data Type Required Description
id string Yes The ID of the Amazon Music user whose followers should be retrieved.

Query Parameters

Name Data Type Required Description
limit number No The maximum number of followers 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/users/zqll6htnhy34fqsrtrhdvaa/followers?limit=2' \
--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
user User No Data about the current Amazon Music user including their followers
Example
{
  "data": {
    "user": {
      "id": "zqll6htnhy34fqsrtrhdvaa",
      "name": "Tony Starked",
      "url": "https://music.amazon.com/profiles/zqll6htnhyb2welrqsrtrhdvaa",
      "followers": {
        "pageInfo": {
          "hasNextPage": true,
          "token": "rO0ABXNyADhjb20uYW1hem9uLm11c2ljLnJlbGF0aW9uc2hpcC5ncmFwaC5wYWdpbmF0aW9uLlBhZ2VUb2tlbjR9daSapeQtAgADSQAFaW5kZXhJAAhwYWdlU2l6ZUwACXRpbWVzdGFtcHQAE0xqYXZhL3RpbWUvSW5zdGFudDt4cAAAAAIAAAACc3IADWphdmEudGltZS5TZXKVXYS6GyJIsgwAAHhwdw0CAAAAAGD54RobqBQAeA=="
        },
        "edgeCount": 2,
        "edges": [
          {
            "node": {
              "id": "uj7wxenmftr26zlg7eo4maa744",
              "name": "Jane M",
              "url": "https://music.amazon.com/profiles/uj7wxenmftr26zlg7eo4maa744"
            }
          },
          {
            "node": {
              "id": "zz2hu7x4v2u2bhzyh5bsb4xvje",
              "name": "Amit",
              "url": "https://music.amazon.com/profiles/zz2hu7x4v2u2bhzyh5bsb4xvje"
            }
          }
        ]
      }
    }
  }
}

Get User's Followed Users

GET
/users/{id}/followed/users
Authorization Scope: [music::catalog]
Get a list of a specified public Amazon Music user’s followed users. Optional parameters can be used to limit the number of followed users returned.

Learn more about pagination.

Path Parameters

Name Data Type Required Description
id string Yes The ID of the Amazon Music user whose followed users should be retrieved.

Query Parameters

Name Data Type Required Description
limit number No The maximum number of followed users 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/users/zqll6htnhybrewrqsrtrhdvaa/followed?limit=2' \
--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
user User No Data about the current Amazon Music user including their followed users

Example

{
  "data": {
    "user": {
      "id": "zqll6htnhybrewrqsrtrhdvaa",
      "name": "Tony Starked",
      "url": "https://music.amazon.com/profiles/zqll6htnhyb2welrqsrtrhdvaa",
      "followedUsers": {
        "pageInfo": {
          "hasNextPage": true,
          "token": "rO0ABXNyADhjb20uYW1hem9uLm11c2ljLnJlbGF0aW9uc2hpcC5ncmFwaC5wYWdpbmF0aW9uLlBhZ2VUb2tlbjR9daSapeQtAgADSQAFaW5kZXhJAAhwYWdlU2l6ZUwACXRpbWVzdGFtcHQAE0xqYXZhL3RpbWUvSW5zdGFudDt4cAAAAAUAAAAFc3IADWphdmEudGltZS5TZXKVXYS6GyJIsgwAAHhwdw0CAAAAAGD55G8Qgq9AeA=="
        },
        "edgeCount": 2,
        "edges": [
          {
            "node": {
              "id": "ajdzyygpbolfqstxggxmqn4ouu",
              "name": "Victor Max",
              "url": "https://music.amazon.com/profiles/lgwup3erbjovmjxwf6sb2hm35m"
            }
          },
          {
            "node": {
              "id": "lgwup3erbjovmjxwf6sb2hm35m",
              "name": "El Victor",
              "url": "https://music.amazon.com/profiles/lgwup3erbjovmjxwf6sb2hm35m"
            }
          }
        ]
      }
    }
  }
}

Get User's Followed Artists

GET
/users/{id}/followed/artists
Authorization Scope: [music::catalog]
Get a list of a public Amazon Music user’s followed artists. Optional parameters can be used to limit the number of followed artists returned.

Learn more about pagination.

Path Parameters

Name Data Type Required Description
id string Yes The ID of the Amazon Music user whose followed artists should be retrieved.

Query Parameters

Name Data Type Required Description
artistIds string No Artist IDs to limit the results to.
limit number No The maximum number of followed users 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/users/zqll6htnhybrewrqsrtrhdvaa/followed/artists?limit=2' \
--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
user User No Data about the current Amazon Music user including their followed artists

Example

{
  "data": {
    "user": {
      "id": "zqll6htnhybrewrqsrtrhdvaa",
      "name": "Tony Starked",
      "url": "https://music.amazon.com/profiles/zqll6htnhyb2welrqsrtrhdvaa",
      "followedArtists": {
        "pageInfo": {
          "hasNextPage": true,
          "token": "rO0ABXNyADhjb20uYW1hem9uLm11c2ljLnJlbGF0aW9uc2hpcC5ncmFwaC5wYWdpbmF0aW9uLlBhZ2VUb2tlbjR9daSapeQtAgADSQAFaW5kZXhJAAhwYWdlU2l6ZUwACXRpbWVzdGFtcHQAE0xqYXZhL3RpbWUvSW5zdGFudDt4cAAAAAIAAAACc3IADWphdmEudGltZS5TZXKVXYS6GyJIsgwAAHhwdw0CAAAAAGD55C0ZRboAeA=="
        },
        "edgeCount": 2,
        "edges": [
          {
            "node": {
              "id": "B000QKGN8W",
              "name": "Coldplay",
              "url": "https://music.amazon.com/artists/B000QKGN8W"
            }
          },
          {
            "node": {
              "id": "B000S2A8NE",
              "name": "XYZ",
              "url": "https://music.amazon.com/artists/B000S2A8NE"
            }
          }
        ]
      }
    }
  }
}

Get User's Followed Podcast Shows

GET
/users/{id}/followed/podcasts/shows
Authorization Scope: [music::catalog]
Get a list of a public Amazon Music user’s followed podcast shows. Optional parameters can be used to limit the number of shows returned.

Learn more about pagination.

Path Parameters

Name Data Type Required Description
id string Yes The ID of the Amazon Music user whose followed podcast shows should be retrieved.

Query Parameters

Name Data Type Required Description
artistIds string No Artist IDs to limit the results to.
limit number No The maximum number of followed podcast shows to return (default: 36). Minimum of 1, maximum of 36.
cursor string No The cursor/token for the page to continue pagination results from.

Example

curl --request GET '<base url>/v1/users/zqll6htnhybrewrqsrtrhdvaa/followed/podcasts/shows?limit=2' \
--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
user User No Data about the specified Amazon Music user and their followed podcast shows

Example

{
  "data": {
    "user": {
      "id": "zqll6htnhybrewrqsrtrhdvaa",
      "name": "Tony Starked",
      "followedPodcastShows": {
        "pageInfo": {
          "hasNextPage": false
        },
        "edgeCount": 3,
        "edges": [
          {
            "node": {
              "id": "8bfa8155-888b-4553-acd3-8f22d43b4c9e",
              "title": "DISGRACELAND",
              "url": "https://music.amazon.com/podcasts/8bfa8155-888b-4553-acd3-8f22d43b4c9e/DISGRACELAND"
            }
          },
          {
            "node": {
              "id": "7e8c8b9f-ab40-49ad-9efb-fdb0960979a8",
              "title": "One Hundred Percent with Marcus Lemonis",
              "url": "https://music.amazon.com/podcasts/7e8c8b9f-ab40-49ad-9efb-fdb0960979a8/One-Hundred Percent with Marcus Lemonis"
            }
          },
          {
            "node": {
              "id": "d6e3946e-6b3f-48dc-a3ae-fdc7c9d699f0",
              "title": "Crime Junkie",
              "url": "https://music.amazon.com/podcasts/d6e3946e-6b3f-48dc-a3ae-fdc7c9d699f0/Crime-Junkie"
            }
          }
        ]
      }
    }
  }
}