Amazon Music Web API

Web API Artists V2.0

Important: These Amazon Music APIs are currently in a closed Beta. Please check back soon for updates.

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.

Artists

Get multiple artists
Get artist by ID
Get artist's albums
Get artist's merch
Get artists similar to the given artist
Get artist's top tracks

Get multiple artists

GET

/v2/artists

Authorization Scope: [music::catalog]

Retrieve information for multiple artists identified by their AmazonMusic IDs. Pass a comma-separated list of artist IDs via the `ids` query parameter; maximum 100 IDs per request. IDs that cannot be resolved are omitted from the response. Each returned artist includes its name, follower count, and images.

Query Parameters

Name	Data Type	Required	Description
ids	string[]	Yes	Comma-separated list of artist IDs (max 100)

Response 200

Successful response

Response Schema

(array)

Artist[]

List of requested artists

Example

[
  {
    "id": "B000X6FP38",
    "name": "Karnivool",
    "followerCount": 123456,
    "url": "https://music.amazon.com/artists/B000X6FP38",
    "images": [
      {
        "url": "https://m.media-amazon.com/images/I/artist-B000X6FP38-primary.jpg",
        "width": 1200,
        "height": 1200,
        "imageType": "PRIMARY"
      }
    ]
  },
  {
    "id": "B00G70DLAS",
    "name": "the-strokes",
    "followerCount": 4567890,
    "url": "https://music.amazon.com/artists/B00G70DLAS",
    "images": [
      {
        "url": "https://m.media-amazon.com/images/I/artist-B00G70DLAS-primary.jpg",
        "width": 1200,
        "height": 1200,
        "imageType": "PRIMARY"
      }
    ]
  }
]

Error Responses

Response	Code	Status	Message
400	BAD_REQUEST	400	ids parameter is required and must contain 1-100 comma-separated IDs

400 Example

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "ids parameter is required and must contain 1-100 comma-separated IDs",
    "traceId": "1-abc-def"
  }
}

Get artist by ID

GET

/v2/artists/{id}

Authorization Scope: [music::catalog]

Retrieve the Amazon Music catalog metadata for a single artist by its artist id. Available artist fields include the name, follower count, and images; use the sparse fieldset parameters below to select which to return.

Supports sparse fieldsets via query parameters:

fields[artist] — Comma-separated artist fields (e.g. name,id,images)
fields[image] — Comma-separated image fields (e.g. url)

Path Parameters

Name	Data Type	Required	Description
id	string	Yes	Unique identifier for the resource

Response 200

Successful response

Response Schema

string

Unique artist identifier (default -> GlobalAsin)

globalAsin

string

Global unique identifier for the artist

followerCount

integer

Number of followers for this artist

name

string

Artist name

url

string [format=uri]

URL into AmazonMusic for this artist

images

Image[]

List of artist images

albums

Album[]

Albums by this artist

tracks

Track[]

Tracks by this artist

Example

Full artist response

{
  "id": "B000X6FP38",
  "name": "Karnivool",
  "followerCount": 123456,
  "url": "https://music.amazon.com/artists/B000X6FP38",
  "images": [
    {
      "url": "https://m.media-amazon.com/images/I/artist-B000X6FP38-primary.jpg",
      "width": 1200,
      "height": 1200,
      "imageType": "PRIMARY"
    },
    {
      "url": "https://m.media-amazon.com/images/I/artist-B000X6FP38-profile.jpg",
      "width": 640,
      "height": 640,
      "imageType": "PROFILE"
    }
  ]
}

Sparse Fieldsets Example

Sparse fieldsets — fields[artist]=name,id,images&fields[image]=url

{
  "id": "B000X6FP38",
  "name": "Karnivool",
  "images": [
    {
      "url": "https://m.media-amazon.com/images/I/artist-B000X6FP38-primary.jpg"
    }
  ]
}

Error Responses

Response	Code	Status	Message
400	BAD_REQUEST	400	Invalid field 'nonexistent' for type 'artist'
404	NOT_FOUND	404	Artist not found

400 Example

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Invalid field 'nonexistent' for type 'artist'",
    "traceId": "1-abc-def"
  }
}

404 Example

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Artist not found",
    "traceId": "1-abc-def"
  }
}

Get artist's albums

GET

/v2/artists/{id}/albums

Authorization Scope: [music::catalog]

Retrieve a paginated list of albums for a specific artist, ordered by release date descending. Available album fields include the title, release date, track count, duration, audio qualities, images, contributing artists, label, parental settings, and eligibility flags; use the sparse fieldset parameters below to select which to return.

Paginated with forward-only cursor navigation. Default page size is 20 items; maximum is 100. Use the nextToken from the response to fetch the next page via the after query parameter.

Supports sparse fieldsets via query parameters:

fields[album] — Comma-separated album fields (e.g. title,id,images,artists)
fields[artist] — Comma-separated artist fields (e.g. name)
fields[image] — Comma-separated image fields (e.g. url)

Path Parameters

Name	Data Type	Required	Description
id	string	Yes	Unique identifier for the resource

Query Parameters

Name	Data Type	Required	Description
first	integer	No	Number of items to return
after	string	No	Cursor to start after

Response 200

Successful response

Response Schema

items

Album[]

Page of results.

nextToken

string

Cursor for the next page. Absent on the last page.

Example

Albums by the artist with full Album fields populated

{
  "items": [
    {
      "id": "B07YVNQFHB",
      "title": "Asymmetry",
      "audioQualities": [
        "HD"
      ],
      "images": [
        {
          "height": 1400,
          "width": 1400,
          "url": "https://m.media-amazon.com/images/I/81vN5Iqg6XL.jpg",
          "imageType": "PRIMARY"
        }
      ],
      "artists": [
        {
          "id": "B000X6FP38",
          "name": "Karnivool"
        }
      ],
      "duration": 4821,
      "releaseDate": "2013-07-19T00:00:00.000Z",
      "trackCount": 10,
      "label": "Cymatic Records",
      "url": "https://music.amazon.com/albums/B07YVNQFHB",
      "parentalSettings": {
        "hasExplicitLanguage": false
      }
    },
    {
      "id": "B073J5NW51",
      "title": "Sound Awake",
      "audioQualities": [
        "HD"
      ],
      "images": [
        {
          "height": 1400,
          "width": 1400,
          "url": "https://m.media-amazon.com/images/I/81uP7WboW6L.jpg",
          "imageType": "PRIMARY"
        }
      ],
      "artists": [
        {
          "id": "B000X6FP38",
          "name": "Karnivool"
        }
      ],
      "duration": 4329,
      "releaseDate": "2009-06-05T00:00:00.000Z",
      "trackCount": 11,
      "label": "Columbia",
      "url": "https://music.amazon.com.mx/albums/B073J5NW51?ref=dm_ff_amazonmusic_3p",
      "parentalSettings": {
        "hasExplicitLanguage": false
      }
    }
  ],
  "nextToken": "B0EXAMP260"
}

Sparse Fieldsets Example

Sparse fieldsets — fields[album]=title,id,releaseDate,artists&fields[artist]=name

{
  "items": [
    {
      "id": "B07YVNQFHB",
      "title": "Asymmetry",
      "releaseDate": "2013-07-19T00:00:00.000Z",
      "artists": [
        {
          "id": "B000X6FP38",
          "name": "Karnivool"
        }
      ]
    },
    {
      "id": "B073J5NW51",
      "title": "Sound Awake",
      "releaseDate": "2009-06-05T00:00:00.000Z",
      "artists": [
        {
          "id": "B000X6FP38",
          "name": "Karnivool"
        }
      ]
    }
  ],
  "nextToken": "B0EXAMP260"
}

Error Responses

Response	Code	Status	Message
400	BAD_REQUEST	400	first parameter must be between 1 and 100
404	NOT_FOUND	404	Artist not found

400 Example

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "first parameter must be between 1 and 100",
    "traceId": "1-abc-def"
  }
}

404 Example

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Artist not found",
    "traceId": "1-abc-def"
  }
}

Get artist's merch

GET

/v2/artists/{id}/merch

Authorization Scope: [music::catalog]

Retrieve a paginated list of Amazon retail merch for a specific artist. Supports filtering by product tag (`filters`) and sorting by editorial order or release date (`sortBy`/`sortOrder`). Each merch item includes its title, product type, retail URL, price, image, and release date, and supports sparse fieldsets to return only the fields you need.

Paginated with forward-only cursor navigation. Default page size is 20 items; maximum is 100. Use the nextToken from the response to fetch the next page via the after query parameter.

Path Parameters

Name	Data Type	Required	Description
id	string	Yes	Unique identifier for the resource

Query Parameters

Name	Data Type	Required	Description
filters	string[]	No	Merch filter tags applied before sorting. Rendered over the wire as a comma-separated list (e.g. `?filters=apparel,vinyl`).
sortBy	MerchSortBy	No	Field to sort by
sortOrder	MerchSortOrder	No	Sort direction
first	integer	No	Number of items to return
after	string	No	Cursor to start after

Response 200

Successful response

Response Schema

items

Merch[]

Page of results.

nextToken

string

Cursor for the next page. Absent on the last page.

Example

Merch items for the artist with every Merch field populated

{
  "items": [
    {
      "id": "B0DX5FZK8V",
      "name": "Karnivool Sound Awake — Vinyl (2LP)",
      "url": "https://music.amazon.com/dp/B0DX5FZK8V",
      "description": "Double gatefold 180g vinyl pressing of Sound Awake.",
      "price": "$34.99",
      "format": "PHYSICAL",
      "assetType": "vinyl",
      "relatedAssetTypes": [
        "apparel"
      ],
      "availability": "IN_STOCK",
      "images": [
        {
          "url": "https://m.media-amazon.com/images/I/81uP7WboW6L.jpg",
          "width": 1400,
          "height": 1400,
          "imageType": "PRIMARY"
        }
      ],
      "availableMarkets": [
        {
          "id": "US",
          "name": "United States"
        }
      ],
      "eligibility": {
        "isPurchaseable": true
      }
    },
    {
      "id": "B07YVNQFHB",
      "name": "Karnivool Asymmetry — T-Shirt",
      "url": "https://music.amazon.com/dp/B07YVNQFHB",
      "price": "$24.99",
      "format": "PHYSICAL",
      "assetType": "apparel",
      "availability": "IN_STOCK_SCARCE",
      "images": [
        {
          "url": "https://m.media-amazon.com/images/I/81vN5Iqg6XL.jpg",
          "width": 1000,
          "height": 1000,
          "imageType": "PRIMARY"
        }
      ]
    }
  ],
  "nextToken": "B0EXAMP280"
}

Sparse Fieldsets Example

Reduced merch page (name, id, price only)

{
  "items": [
    {
      "id": "B0DX5FZK8V",
      "name": "Karnivool Sound Awake — Vinyl (2LP)",
      "price": "$34.99"
    },
    {
      "id": "B07YVNQFHB",
      "name": "Karnivool Asymmetry — T-Shirt",
      "price": "$24.99"
    }
  ],
  "nextToken": "B0EXAMP280"
}

Error Responses

Response	Code	Status	Message
400	BAD_REQUEST	400	first parameter must be between 1 and 100
404	NOT_FOUND	404	Artist not found

400 Example

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "first parameter must be between 1 and 100",
    "traceId": "1-abc-def"
  }
}

404 Example

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Artist not found",
    "traceId": "1-abc-def"
  }
}

Get artists similar to the given artist

GET

/v2/artists/{id}/related

Authorization Scope: [music::catalog]

Retrieve a paginated list of artists similar to the given artist. Similarity is computed from catalog co-occurrence and the caller's listening history. Available artist fields include the name, follower count, and images; use the sparse fieldset parameters below to select which to return.

Paginated with forward-only cursor navigation. Default page size is 20 items; maximum is 100. Use the nextToken from the response to fetch the next page via the after query parameter.

Supports sparse fieldsets via query parameters:

fields[artist] — Comma-separated artist fields (e.g. name,id,images)
fields[image] — Comma-separated image fields (e.g. url)

Path Parameters

Name	Data Type	Required	Description
id	string	Yes	Unique identifier for the resource

Query Parameters

Name	Data Type	Required	Description
first	integer	No	Number of items to return
after	string	No	Cursor to start after

Response 200

Successful response

Response Schema

items

Artist[]

Page of results.

nextToken

string

Cursor for the next page. Absent on the last page.

Example

Related artists with full Artist fields populated

{
  "items": [
    {
      "id": "B00G70DLAS",
      "name": "the-strokes",
      "followerCount": 4567890,
      "url": "https://music.amazon.com/artists/B00G70DLAS",
      "images": [
        {
          "url": "https://m.media-amazon.com/images/I/artist-B00G70DLAS-primary.jpg",
          "width": 1200,
          "height": 1200,
          "imageType": "PRIMARY"
        }
      ]
    },
    {
      "id": "B000X6FP38",
      "name": "Karnivool",
      "followerCount": 123456,
      "url": "https://music.amazon.com/artists/B000X6FP38",
      "images": [
        {
          "url": "https://m.media-amazon.com/images/I/artist-B000X6FP38-primary.jpg",
          "width": 1200,
          "height": 1200,
          "imageType": "PRIMARY"
        }
      ]
    }
  ],
  "nextToken": "B0EXAMP270"
}

Sparse Fieldsets Example

Sparse fieldsets — fields[artist]=name,id,images&fields[image]=url

{
  "items": [
    {
      "id": "B00G70DLAS",
      "name": "the-strokes",
      "images": [
        {
          "url": "https://m.media-amazon.com/images/I/artist-B00G70DLAS-primary.jpg"
        }
      ]
    },
    {
      "id": "B000X6FP38",
      "name": "Karnivool",
      "images": [
        {
          "url": "https://m.media-amazon.com/images/I/artist-B000X6FP38-primary.jpg"
        }
      ]
    }
  ],
  "nextToken": "B0EXAMP270"
}

Error Responses

Response	Code	Status	Message
400	BAD_REQUEST	400	first parameter must be between 1 and 100
404	NOT_FOUND	404	Artist not found

400 Example

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "first parameter must be between 1 and 100",
    "traceId": "1-abc-def"
  }
}

404 Example

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Artist not found",
    "traceId": "1-abc-def"
  }
}

Get artist's top tracks

GET

/v2/artists/{id}/tracks

Authorization Scope: [music::catalog]

Retrieve the top tracks for a specific artist, ordered by popularity. Available track fields include the title, duration, ISRC, audio qualities, album, contributing artists, release date, label, parental settings, and eligibility flags; use the sparse fieldset parameters below to select which to return.

Paginated with forward-only cursor navigation. Default page size is 20 items; maximum is 100. Use the nextToken from the response to fetch the next page via the after query parameter.

Supports sparse fieldsets via query parameters:

fields[track] — Comma-separated track fields (e.g. title,id,duration)
fields[album] — Comma-separated album fields (e.g. title,id)
fields[artist] — Comma-separated artist fields (e.g. name)

Path Parameters

Name	Data Type	Required	Description
id	string	Yes	Unique identifier for the resource

Query Parameters

Name	Data Type	Required	Description
first	integer	No	Number of items to return
after	string	No	Cursor to start after

Response 200

Successful response

Response Schema

items

Track[]

Page of results.

nextToken

string

Cursor for the next page. Absent on the last page.

Example

Top tracks for artist with full Track fields populated

{
  "items": [
    {
      "id": "B084KPC3Q7",
      "title": "Selfless",
      "duration": 222,
      "isrc": "USRC11902727",
      "audioQualities": [
        "HD"
      ],
      "mediaType": "audio",
      "releaseDate": "2020-04-10T00:00:00.000Z",
      "label": "Cult",
      "url": "https://music.amazon.com/albums/B084KP4NBH/?trackAsin=B084KPC3Q7",
      "album": {
        "id": "B084KP4NBH",
        "title": "The New Abnormal"
      },
      "artists": [
        {
          "id": "B00G70DLAS",
          "name": "the-strokes"
        }
      ],
      "parentalSettings": {
        "hasExplicitLanguage": false
      }
    },
    {
      "id": "B004S8NBPG",
      "title": "Metabolism",
      "duration": 181,
      "isrc": "USRC10500421",
      "audioQualities": [
        "HD"
      ],
      "mediaType": "audio",
      "releaseDate": "2006-01-03T00:00:00.000Z",
      "label": "Cult",
      "url": "https://music.amazon.com/albums/B084KP4NBH/?trackAsin=B004S8NBPG",
      "album": {
        "id": "B084KP4NBH",
        "title": "The New Abnormal"
      },
      "artists": [
        {
          "id": "B00G70DLAS",
          "name": "the-strokes"
        }
      ],
      "parentalSettings": {
        "hasExplicitLanguage": false
      }
    }
  ],
  "nextToken": "B0EXAMP210"
}

Sparse Fieldsets Example

Sparse fieldsets — fields[track]=title,id,duration,artists&fields[artist]=name

{
  "items": [
    {
      "id": "B084KPC3Q7",
      "title": "Selfless",
      "duration": 222,
      "artists": [
        {
          "id": "B00G70DLAS",
          "name": "the-strokes"
        }
      ]
    },
    {
      "id": "B004S8NBPG",
      "title": "Metabolism",
      "duration": 181,
      "artists": [
        {
          "id": "B00G70DLAS",
          "name": "the-strokes"
        }
      ]
    }
  ],
  "nextToken": "B0EXAMP210"
}

Error Responses

Response	Code	Status	Message
400	BAD_REQUEST	400	first parameter must be between 1 and 100
404	NOT_FOUND	404	Artist not found

400 Example

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "first parameter must be between 1 and 100",
    "traceId": "1-abc-def"
  }
}

404 Example

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Artist not found",
    "traceId": "1-abc-def"
  }
}