Amazon Music Web API

Web API Stations 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.

Stations

Get top stations
Get station by ID

Get top stations

GET

/v2/stations/top

Authorization Scope: [music::catalog]

Retrieve a list of top AmazonMusic stations, ordered by popularity.

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[station] — Comma-separated station fields (e.g. name,id,images)
fields[image] — Comma-separated image fields (e.g. url)

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

Station[]

Page of results.

nextToken

string

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

Example

Top stations with full Station fields populated

{
  "items": [
    {
      "id": "B0STATN100",
      "name": "Relaxing Piano Radio",
      "url": "https://music.amazon.com/stations/B0STATN100",
      "images": [
        {
          "url": "https://m.media-amazon.com/images/I/B0STATN100-2400.png",
          "width": 2400,
          "height": 2400,
          "imageType": "PRIMARY"
        },
        {
          "url": "https://m.media-amazon.com/images/I/B0STATN100-500.png",
          "width": 500,
          "height": 500,
          "imageType": "PRIMARY"
        }
      ]
    },
    {
      "id": "B0STATN101",
      "name": "Sleep Sounds",
      "url": "https://music.amazon.com/stations/B0STATN101",
      "images": [
        {
          "url": "https://m.media-amazon.com/images/I/B0STATN101-2400.png",
          "width": 2400,
          "height": 2400,
          "imageType": "PRIMARY"
        }
      ]
    }
  ],
  "nextToken": "B0STATN250"
}

Sparse Fieldsets Example

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

{
  "items": [
    {
      "id": "B0STATN100",
      "name": "Relaxing Piano Radio"
    },
    {
      "id": "B0STATN101",
      "name": "Sleep Sounds"
    }
  ],
  "nextToken": "B0STATN250"
}

Error Responses

Response	Code	Status	Message
400	BAD_REQUEST	400	first parameter must be between 1 and 100

400 Example

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

Get station by ID

GET

/v2/stations/{id}

Authorization Scope: [music::catalog]

Retrieve detailed information about a specific AmazonMusic station, including cover images and the AmazonMusic URL.

Supports sparse fieldsets via query parameters:

fields[station] — Comma-separated station 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 station identifier. Real station identifiers do not follow the ASIN shape used by other AmazonMusic entities — examples in this spec use a synthetic ASIN-shaped placeholder for documentation consistency.

name

string

Station name

url

string [format=uri]

URL into AmazonMusic for this station

images

Image[]

Cover images for this station

Example

Full station response with cover images

{
  "id": "B0STATN100",
  "name": "Relaxing Piano Radio",
  "url": "https://music.amazon.com/stations/B0STATN100",
  "images": [
    {
      "url": "https://m.media-amazon.com/images/I/B0STATN100-2400.png",
      "width": 2400,
      "height": 2400,
      "imageType": "PRIMARY"
    },
    {
      "url": "https://m.media-amazon.com/images/I/B0STATN100-500.png",
      "width": 500,
      "height": 500,
      "imageType": "PRIMARY"
    }
  ]
}

Sparse Fieldsets Example

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

{
  "id": "B0STATN100",
  "name": "Relaxing Piano Radio",
  "images": [
    {
      "url": "https://m.media-amazon.com/images/I/B0STATN100-2400.png"
    }
  ]
}

Error Responses

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

400 Example

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

404 Example

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