Amazon Music Web API
Web API Overview V1.0
Amazon Music Web API
The Amazon Music Web API is a new, simplified API allowing quick retrieval of meta-data about albums, tracks, artists, playlists, podcasts, and more from the Amazon Music catalog’s millions of songs. It provides a consistent, unified experience across services, fast round trip resolution via caching strategies, and built-in optimization on queries. Partners can use this API to build web-based services that allow users to quickly and easily transfer their playlists between services, provide deep links into the Amazon Music service, and more.
Some user information—such as user-created playlists, personal library, and saved podcast episodes—is also available, if the user grants permission. There is some limited editing functionality for items such as playlists, also with user permission.
Use this URL wherever you encounter
An example request for a list of albums might appear as follows:
Authentication (OAuth 2.0 Protocol)
All Amazon Music Web API endpoints require a valid OAuth 2.0 authentication token for access. Amazon provides a single, unified authentication service called Login With Amazon (LWA) which provides valid OAuth 2.0 tokens for most Amazon services, including the Amazon Music Web API. To use LWA, you will need to create an LWA account and security profile to receive the client ID and device ID you use for authentication. When authenticating with LWA, a scope is required. The LWA scope
profile is an example that can be used for scope when authenticating.
Calls to the Amazon Music Web API must always include two header parameters:
Authorization. The value of
x-api-key should be your client ID, and the value of
Authorization should be the bearer token you recieved from the LWA service.
To learn more about Login with Amazon, click here.
The Security Profile ID(s) used by Music client applications must be enabled by the Amazon Music Service in order for authorization to be successful. Reach out to your Amazon Music point-of-contact for more information.
Click here to learn about pagination in the Web API.
Click here to see the complete reference for the Web API, starting with the Album endpoints.