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.
The API is a RESTful service, an architecture which will be familiar to many developers, making integration as easy and painless as possible. API resources are provided by Amazon as a series of endpoints. These endpoints can be queried via HTTPS requests using standard HTTP methods. Results use standard JavaScript Object Notation (JSON) as a data-interchange format. Results are returned in the form a response object. These results can be parsed to retrieve the desired information. For instance, querying for information about “Daft Punk” might return the artist’s name, a URL for the Amazon Music catalog, and a URL for an image of the artist, all contained within the data field of the response object. For details about the JSON results, see the response example for each individual endpoint.
Base URL
Use this URL wherever you encounter <base url>
.
An example request for a list of albums might appear as follows:
<base url>/v1/albums/?ids=B0064UPU4G,B091BHTFTZ,B0869N1S7F
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: x-api-key
and 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.