We've provided an API key in these docs in order to make it easy for you to get started. Resist the temptation to use it in your app! It's throttled, and you'll be missing out on some additional features and analytics as well.

Note that, throughout this documentation, there are links that have API set as a parameter but, in practice, you should always set it in the apikey header of your request.
This enables you to better take advantage of caching.

Paging

The max
limit
supported is 200. If an invalid
limit
, a negative
limit
or a
limit
higher than 200 is passed, a 400 error will be returned.

International Catalog

Unless otherwise specified, all metadata requests will be routed to the US catalog. If you'd like to use a specific catalog other than US, just pass in the two-letter country code (which is case-sensitive)

Language support

Unless otherwise specified, all requests will return English (US) content. If you'd like to use a specific language, other than English (US), just use
lang
query parameter to pass in the first two segments of language string:

Pretty Print JSON

Filter Streamable Content

Many api calls support the
isStreamableOnly=true
flag. This query string parameter will filter out content that is not streamable.

WARNING
Passing this flag will make the
totalCount
value inaccurate on many endpoints. You will need to paginate until no more data is received to ensure you are at the end of the list. If you do not pass this flag, then all pagination values will be accurate.

Errors

Status codes

The request has been fulfilled and resulted in a new resource being created. The newly created resource can be referenced by the URI(s) returned in the Location HTTP header field of the response.

202

Accepted

The request has been accepted for processing, but the processing has not been completed. The request might or might not eventually be acted upon, as it might be disallowed when processing actually takes place.

204

No Content

The server has fulfilled the request but does not need to return an entity-body

400

Bad Request

The request was invalid or cannot be otherwise served. A response error message may explain reasons in more detail.

401

Unauthorized

Authentication credentials
were missing or incorrect. If you are accessing metadata API endpoints only with apikey, check that it is valid.

403

Forbidden

The request is understood, but it has been refused or access is not allowed. This status code is used when you try to modify or access resources you do not have permission for.

404

Not Found

The URI requested is invalid or the resource requested does not exist.

405

Method Not Allowed

The method specified in the request is not allowed for the resource identified by the request URI. See response headers for allowed methods.

409

Conflict

The request could not be completed due to a conflict with the current state of the resource you were trying to update.

413

Payload Too Large

The attached object was too large. Try again with a smaller object.

429

Too Many Requests

Used when a request cannot be served due to the rate limit having been exhausted (throttling).

All station objects are now consistent. Added image links to station objects returned by GET /genre/{id}/stations.

Tag Object

All tag objects are now consistent. Multiple attributes on the object have been added, changed or deleted. See the Response Object section of the documentation for additional details.

Total Count for Arrays Returned

Meta sections will return "totalCount" when returning arrays of response objects. The value specifies the number of returnable objects that exist in the dataset. When "totalCount" is unknown, its value will be null.

Dropped "includes" support for ALL ENDPOINTS

Query paramter "include" is no longer supported. You will need to make additional calls to get the data that could be included in earlier versions.

Throw a 504 when a request to an upstream service times out

We now return a 504 error code when a request to an upstream service times out. Previously, we returned a 500 (Internal Sever Error) in this case

All returned monikers will be lowercased

To increase our cache efficiency, we now return all lowercase monikers. Monikers are the letter abbreviations prepended to each returned ID. (Ex: alb. art. tra.)

A new param is supported for top APIs: "range"

The following endpoints now support the "range" parameter: artists/top, artists/{id}/albums/top, /v2.2/artists/{id}/tracks/top, albums/top, tracks/top, genres/{id}/artists/top, genres/{id}/albums/top, genres/{id}/tracks/top

Deprecated radios.

Radio (terrestrial station) objects have been deprecated accross all endpoints that use them. For example you will no longer be able to GET /radios/featured and GET /search?type=radio.

Support for giphy images

Now you can use giphy images for member playlists. Use /me/library/playlists/{id}/images endpoints to manipulate them. They will also surface in playlist metadata under 'images' array. This is considered a breaking change as some properties will have null values.

Image URL

Image URLs emitted will now contain image version too, so you can use it without modify it.

Parameter "description" is now supported when copying an existing playlist.

Endpoint: GET /playlists/top

Added new endpoint that returns top playlists.

Endpoint: GET /genres/{id}/playlists/top

Added new endpoint that returns top playlists by genre.

Endpoints: /me/library/playlists/{id}/images

All playlist images returned will now have default dimensions of 230x153. Also, custom width and height parameter are now supported.

Endpoint: PUT /me/library/playlists/{id}/privacy

This endpoint is now deprecated. Setting the privacy on a playlist should be done using the bulk call with PUT /me/library/playlists/{id}.

Endpoint: GET /artists/{id}/tracks/top

Fetching top tracks for multiple artists is no longer supported. Only one moniker may be passed at a time.

Endpoint: GET /artists/{id}/albums/top

Fetching top albums for multiple artists is no longer supported. Only one moniker may be passed at a time.

Top, Album, and Artist Pagination defaults

NAPI will now default limit to 20 and offset to 0 for paginated Top, Album, and Artist endpoints where those query strings are not provided on request.

Endpoint: GET /tracks/isrc/{isrc}

New endpoint added. Get a track by ISRC.

Endpoint /me/account

Changed property "locale" to "lang". Property "subscription.catalog" will now emit catalog name instead of catalog ID.

Endpoints: /search and /search/verbose

Endpoints GET /search and GET /search/verbose has been redesigned. We have changed endpoint logic, input parameters and response schema.

New param supported for top APIs: "range"

The following endpoints now support the "range" parameter: artists/top, artists/{id}/albums/top, /v2.2/artists/{id}/tracks/top, albums/top, tracks/top, genres/{id}/artists/top, genres/{id}/albums/top, genres/{id}/tracks/top

Endpoint: me/favorites

These endpoints have a restructured response and no longer support filtering by type. Please see the endpoint's documentation for the full scope of changes

Endpoint GET /stations

This endpoint now will return an list of stations with optional pagination.

Endpoint: GET /albums/upc/{upc}

New endpoint added. Get an album by UPC.

Endpoint: GET /tracks/{artist_shortcut}/{album_shortcut}/{track_shortcut}

New endpoint added. Get a track by shortcut.

Endpoint: GET /artists/{artistId}/similar

New endpoint added. Get similar artists by artistId.

Endpoint: GET /albums/{artist_shortcut}/{album_shortcut}

New endpoint added. Get a track by shortcut.

Authentication (OAuth 2.0)

Napster supports the
OAuth 2 standard
for making API calls on behalf of a member. In general, you will need an OAuth access token for any endpoint that begins with
/me
.
We currently support the two most common flows:

If the member accepts your request for authentication, we redirect back to your redirect_uri with a temporary code in the code query parameter. If originally passed in, the state parameter is also returned, unchanged.

If the member cancels the authentication in the middle of the OAuth flow, the member is sent back to the redirect_uri with the error, error_reason and error_description parameters describing the error. If originally passed in, the state parameter is also returned, unchanged.

Password Grant

In this flow, you exchange a member's username and password (which your application obtains directly from the member) for an access token and a refresh token. You can then safely store these two tokens in your application, and use them to make authenticated calls.

Access Token Responses

Using these (example) tokens, you can make API requests on the member's behalf — for instance, to obtain the member's listening history, passing the access token value in an Authorization header (of type "Bearer"):

Token Expiration

Access tokens expire regularly, so your application should take steps to refresh them as needed. (Note the
expires_in
value above, which denotes that the associated token expires in 86399 seconds, or just under 24 hours.) To do so, simply call the access_token service, passing your client secret:

WARNING
Depending on the number of tracks in the playlist, this request could take a
considerable amount of time to respond. It is recommended that you use appropriate values for
limit
and
offset
parameters to incrementally get all the data.

WARNING
This endpoint expects a
limit
parameter. See
Paging
for more information.

GET
Top Playlists

Introduced v2.2

Returns a list of top playlists. Supports optional query parameter
range
which can have one of values:
day, week, month, year
and
life.
Default value is
month.

GET
Programmed Station Tracks

Editorial Posts

Posts are rich content created by our editorial staff. Each post focuses on an artist, genre, album, musical movement, concert, or special exclusive content and provides listening content along with descriptive material about the content.

GET
All Posts

Returns an optionally paged list of all featured editorial posts, sorted by date.

GET
Posts by a Category

Editorial (Id-Based) Tags

Provides information about editorial (id-based) tags. These tags are associated with tracks or playlists and serve to associate content with information about Genres (such as Soul/R&B), Themes (such as Summer), or even Activity (such as Travel). Editorial tags are labels in the system that have an associated id which start with 'tag.' such as 'tag.152196532'.

This call also supports the
includeProtected
parameter. Protected tags cannot be assigned to user generated content such as playlists. When not provided,
includeProtected
defaults to
true
, and will return protected and unprotected tags. When passed as
false
, a flattened array of unprotected tags will return. Root and child tags can be protected and will always contain metadata.

Search

Search through
album, artist, track, tag,
and
playlist
content items.
You can use the query parameter
type
with one or more of the above values each separated by a comma.
NOTE: If
type
is not set
album, artist, track
and
playlist
content types will all be returned.

When searching for playlists you can use the query parameter
preference
with value
editorial
to search editorial playlists. Otherwise, member playlists will be returned.

Use
limit
and
perTypeLimit
query parameters to limit overall and per type number of items returned respectively.

When searching for playlists you can use the query parameter
playlist_type
with value
editorial
to search editorial playlists. Otherwise, member playlists will be returned.

Use
per_type_limit
query parameter to limit per type number of items returned.

Versions

GET
All Versions

Authenticated Member APIs

Authenticated Member APIs provide information about Napster members. Any calls to these /me endpoints require OAuth access tokens to access data on behalf of the member. See
Authentication Section
for details on how to obtain an access token.

Account

GET
Member Account Details

Returns information about currently authenticated members account (first and last name, id, email, country, language, phone -if the account has one associated with it-, etc.), subscription (billing partner code, tier and product codes and names, trial information and etc.) and entitlements (information about member's rights, tier and limits).

Within the subscription key, if either the value of the isSuspended element is true, or the value of the state element is "EXPIRED", you should message the member that there is a problem with their account and direct them to http://www.napster.com if possible.

Within the entitlements key, you must check the canStream* entitlements for your specific integration type (Web, Home Audio Device, etc.) For example, if your integration is for a home audio streaming product, you will need to check to ensure that the value of the canStreamOnHomeDevice element is true. If this is false you cannot permit streaming on the device, should message the member that they need to upgrade their account to use on the device, and direct them to http://www.napster.com if possible.

Favorites

This endpoint has a
filter
parameter which can be used to retrieve specific favorite types.

GET
Member Favorites

Accepts optional parameters limit and offset to select a range of results. By default these values are 20 and 0, respectively.

Additionally, you can use the filter parameter to limit the favorites response by the specified filter value. filter defaults to all (use to disable any filtering), but also accepts track, album, artist, genre, station or playlist.

If desired, the catalog parameter is also accepted. See
catalogs
section of this document for further info about catalogs.

Note that you should get a 202 response in case of success. The response should contain more information if your items are added to the queue for favoritization. Items are usually obtainable via get methods few moments after adding them.
If some of the items fail, the complete action will not fail and the response body should indicate which items have failed by having acknowledged field set to false.

DELETE
Remove Favorites

Note that you should get a 202 response in case of success. The response should contain more information if your items are added to the queue for favoritization removal. Items are usually removed a few moments after receiving a successful response.

Library

Library is a collection of content a member has curated by 'adding to library'. A member's library contains tracks, artists, albums, and stations.

Library APIs require OAuth access tokens over HTTPS.

GET
All Artists in Library

Returns a list of all artists in the member's library. Accepts optional parameter
offset
to select a range of results.

WARNING
Depending on the size of the member’s library this request could take a considerable amount of time to respond. It is recommended that you use the
limit
and
offset
parameters to incrementally get all the data.

WARNING
This endpoint expects a
limit
parameter. See
Paging
for more information.

GET
All Artist's Albums in Library

Returns a list of albums in a member’s library by the artist. Accepts optional parameters
limit
and
offset
to select a range of results.

POST
Create a Playlist and Add to Library

Creates a new playlist.
name
attribute is always mandatory.

You can use the attributes
privacy,tracks
and
tags
to perform the operations of setting privacy, adding tracks and adding tags to the newly created playlist respectively. All of these operations are optional and the result of each will be returned inside
meta.results
array.

PUT
Update a Playlist in Library

WARNING
This endpoint has various uses, and can delete items in a playlist when not used correctly. We suggest reading this entire section before making calls to this endpoint.

You can update the attributes
name,description,privacy,tracks
and
tags
on an existing playlist. The tag and track objects that you pass in will
replace
the tags and tracks on the playlist.
All of these operations are optional and the result of each will be returned inside
meta.results
array.

You can update the attributes one at a time, or update multiple attributes of a playlist at once.

tracks

With this call you can reorder, update, and delete tracks in a playlist. Be sure to pass all
tracks
that you want to remain into the playlist into the
tracks
object. Any
tracks
not included in the array will be deleted.

WARNING
Depending on the number of tracks in the playlist, this request could take a
considerable amount of time to respond. It is recommended that you use appropriate values for
limit
and
offset
parameters to incrementally get all the data.

WARNING
This endpoint expects a
limit
parameter. See
Paging
for more information.

POST
Add Tracks to Playlist in Library

Adds tracks to a playlist. Tracks will be appended to end of the list in order received.

PUT
Update Tracks for Playlist in Library

With this call you can reorder, update, and delete tracks in a playlist. Be sure to pass all
tracks
that you want to remain into the playlist into the
tracks
object. Any
tracks
not included in the array will be deleted. Note this endpoint is different from the "bulk" tracks update above in that it has
/tracks
after the playlist ID, takes a request body with a non-nested
tracks
array, and returns 204 instead of 202.

GET
Get the Playlist's Images

By default, images that are returned have the dimensions 230x153.
Use parameters width and height together to customize the dimensions of the image. We recommend using one of the following dimension sets.

230x153

1200x400

1800x600

Other dimensions may be supported, but please ensure that the image url is valid if you decide to choose your own.

Personalized Content

GET
Get New Album Releases Based on Previously Listened to Artists and Genres

Introduced v2.1

Get personalized new album releases based on member's listening history.
The member's most listened to artists and genres will determine the
albums returned from this endpoint.

Along with the list of recommended albums,
the response contains meta section that has an
attribute called matched.
The matched attribute contains a list of objects that map
album IDs and shallow artist or genre objects. The album IDs in the
matched objects are recommendations made based on the most listened to
artists and genres associated with the albums.

GET
Get New Tracks Releases Based on Previously Listened to Artists and Genres

Introduced v2.1

Get personalized new track releases based on member's listening history.
The member's most listened to artists and genres will determine the
tracks returned from this endpoint.

Along with the list of recommended tracks,
the response contains meta section that has an
attribute called matched.
The matched attribute contains a list of objects that map
track IDs and shallow artist or genre objects. The track IDs in the
matched objects are recommendations made based on the most listened to
artists and genres associated with the tracks.

Playback

In order to enable full track playback, you need to
use one of our supported
Napster SDKs.

If your platform is not currently supported, please send us an email with information about your request to
api-inquiries@napster.com
We will evaluate all inquiries, but not all requests will be accepted. Also, due to volume there may be a delay in response time.

Images

To improve performance of the service, most APIs return light metadata, which, for all but albums, does not contain image URLs. For any items requiring an image, the client should use the imageserver service, which provides deterministic URLs for images that the client can programmatically generate for the target content item.

Napster image server supports
jpg
images.

If there are specific image sizes required for your implementation please let your Napster
representative know for confirmation of support or addition to the service.

Tracks and Albums

GET
Get a Track or Album Image

Generate a valid request URL for a track or album image. Tracks use the image for their parent album. For any endpoints where track metadata is returned, the album id is also returned. This id should be used to get the appropriate image for the track.

Playlists

GET
Get a Playlist Image

Generate a valid request URL for a playlist image. There are no associated images available in metadata for member playlists, so a montage of the playlist’s content items is generated.

Accepted
montage
parameter values are "3x2" or "2x2". By default,
the order of the images depends the playlist's track order.
If you specify
order
parameter value to "frequency",
the order of the images will depend on the occurance of the artist
in the playlist instead.

Genres

GET
Get a Genre Image

Generate a valid genre image. There are no associated images available in metadata for genres, so a montage of the genre’s artists is generated. It is not required to display genre images in association with the genre name.

Giphy IDs

EXTERNAL API
Fetching GIFs with Giphy IDs

Some API calls contain an imageType value of "giphyImage". The id parameter on these responses contain Giphy IDs that look like "94ldh8kUuGYLu". Giphy IDs may be used to fetch corresponding data for .gif files hosted on
www.giphy.com
. Reference the Giphy API at
api.giphy.com
to learn more about incorporating related image data in your app.

Response Objects

Below you can find detailed information on the types of objects we return, what they look like, and what specific keys are for. Please see specific endpoints for additional information.

A shortcut to the album that usually follows the pattern "{artist_name}/{album_name}".

name

string

The name of the album the track belongs to.

isStreamable

boolean

This indicates whether or not the album is streamable.

isStreamable

boolean

This indicates whether or not the album is streamable.

released

string

The date and time the album was released.

originallyReleased

string

The date and time the album was orignally released.

label

string

The name of the label the album was released under.

copyright

string

The copyright information.

tags

array

A list of tags related to the album.

discCount

number

The total number of discs the album contains.

trackCount

number

The total number of tracks on the album.

explicit

boolean

This indicates whether or not the album has explicit content.

explicit

boolean

This indicates whether or not the album has explicit content.

isExplicit

boolean

This indicates whether or not the album has explicit content.

single

boolean

This indicates whether or not the album is a single.

single

boolean

This indicates whether or not the album is a single.

isSingle

boolean

This indicates whether or not the album is a single.

accountPartner

string

The account partner for the album.

artistName

string

The name of the artist the album belongs to.

contributingArtists

object

The artists who contributed to the track. This object will have one or more of the following keys- "primaryArtist" "composer", "featuredPerformer", "guestMusician", "producer", "primaryArtist"

discographies

object

The artist discographies for the album. This object will have one or more of the following keys- "compilations" "main", "others", "singlesAndEPs"

links

object

This holds links to all of the Album's related objects.

linked

object

When using the parameter 'include' paired with an object type returned in the links section, this section will be populated with full meta objects of the specified type. Please see 'common features' for more details.

linked

object

NOTE, this will be deprecated in version 2.2. When using the parameter 'include' paired with an object type returned in the links section, this section will be populated with full meta objects of the specified type.

An array of bio objects. Each bio object will have the attributes title, author, publishDate, and bio.

albumGroups

object

The artist's albums organized into one of three groups- "main", "singlesAndEps", "compilations", or "others".

links

object

The links to all of the Artist's related objects.

linked

object

When using the parameter 'include' paired with an object type returned in the links section, this section will be populated with full meta objects of the specified type. Please see 'common features' for more details.

linked

object

NOTE, this will be deprecated in version 2.2. When using the parameter 'include' paired with an object type returned in the links section, this section will be populated with full meta objects of the specified type.

When using the parameter 'include' paired with an object type returned in the links section, this section will be populated with full meta objects of the specified type. Please see 'common features' for more details.

linked

object

NOTE, this will be deprecated in version 2.2. When using the parameter 'include' paired with an object type returned in the links section, this section will be populated with full meta objects of the specified type.

Tag

Response Example

Note: In this version, the parent, links, and linked keys may be excluded from response due to no tag relatives existing or because 'includes' query was not provided on the request.

Note: In this version, the parent, links, and linked keys may be excluded from response due to no tag relatives existing or because 'includes' query was not provided on the request.

When using the parameter 'include' paired with an object type returned in the links section, this section will be populated with full meta objects of the specified type. Please see 'common features' for more details.

links

object

When using the parameter 'include' paired with an object type returned in the links section, this section will be populated with full meta objects of the specified type. Please see 'common features' for more details.

linked

object

NOTE, this will be deprecated in version 2.2. When using the parameter 'include' paired with an object type returned in the links section, this section will be populated with full meta objects of the specified type.

linked

object

NOTE, this will be deprecated in version 2.2. When using the parameter 'include' paired with an object type returned in the links section, this section will be populated with full meta objects of the specified type.

isProtected

boolean

True indicates tag cannot be assigned to any user generated content.

shortcut

string

Alternate id that can be passed to /tags/shortcuts/:shortcut.

href

string

API link to /tags/:id with id key prepopulated.

parentId

string

ID for the tag's parent. If tag has no parent, value is an emptry string.

childIds

array

Tag IDs for tag's children. If tag has no children, value is an empty array.

genreId

string

Tag's related genre ID.

Image

Response Example

Note: In this version, this example is only representative of the avatar and playlist image objects.

The role of the member. Valid types are "member", "editor", and "artist".

followingCount

number

The number of other users the member is following.

followerCount

number

The number of followers the member has.

avatar

string

A link to the member's avatar image.

avatarId

string

The ID of the member's avatar image.

defaultAvatar

boolean

If true, the member has not set their own avatar image.

avatarVersion

number

A timestamp that represents the time at which the profile picture was last updated. The value is 0 if default image is used 1 if Facebook profile image is used.

links

object

Links to all of the Member's related objects.

favoriteAlbumsCount

number

The number of albums the member has favorited. For performance reasons, we have deprecated this functionality. This value will always be 0.

favoriteArtistsCount

number

The number of artists the member has favorited. For performance reasons, we have deprecated this functionality. This value will always be 0.

favoriteTracksCount

number

The number of albums the member has favorited. For performance reasons, we have deprecated this functionality. This value will always be 0.

playlistsTotalCount

number

The number of playlists the member is following. For performance reasons, we have deprecated this functionality. This value will always be 0.

playlistsPublishedCount

number

The number of albums the member has published. For performance reasons, we have deprecated this functionality. This value will always be 0.

stationsCount

number

The number of stations the member is following. For performance reasons, we have deprecated this functionality. This value will always be 0.

radioCount

number

The number of radios the member is following. For performance reasons, we have deprecated this functionality. This value will always be 0.

linked

object

When using the parameter 'include' paired with an object type returned in the links section, this section will be populated with full meta objects of the specified type. Please see 'common features' for more details.

favoriteAlbumsCount

number

The number of albums the member has favorited. For performance reasons, we have deprecated this functionality. This value will always be 0.

favoriteArtistsCount

number

The number of artists the member has favorited. For performance reasons, we have deprecated this functionality. This value will always be 0.

favoriteTracksCount

number

The number of albums the member has favorited. For performance reasons, we have deprecated this functionality. This value will always be 0.

playlistsTotalCount

number

The number of playlists the member is following. For performance reasons, we have deprecated this functionality. This value will always be 0.

playlistsPublishedCount

number

The number of albums the member has published. For performance reasons, we have deprecated this functionality. This value will always be 0.

stationsCount

number

The number of stations the member is following. For performance reasons, we have deprecated this functionality. This value will always be 0.

radioCount

number

The number of radios the member is following. For performance reasons, we have deprecated this functionality. This value will always be 0.

linked

object

NOTE, this will be deprecated in version 2.2. When using the parameter 'include' paired with an object type returned in the links section, this section will be populated with full meta objects of the specified type.

Response Details

Note: Blue rows signify changes between versions

The ID of the playlist. All playlists will have one of the following monikers at the begining "pp.", "mp."

name

string

Th name of the playlist.

modified

string

The time the playlist was last modified.

privacy

string

The privacy of the playlist. Value will either be "private" or "public"

images

array

An array of image objects.

description

string

A short description of the playlist.

favoriteCount

number

The number of users who have favorited the playlist.

freePlayCompliant

boolean

This indicates whether the playlist is freePlayCompliant or not.

links

object

Links to all of the Playlist's related objects.

linked

object

When using the parameter 'include' paired with an object type returned in the links section, this section will be populated with full meta objects of the specified type. Please see 'common features' for more details.

linked

object

NOTE, this will be deprecated in version 2.2. When using the parameter 'include' paired with an object type returned in the links section, this section will be populated with full meta objects of the specified type.

trackCount

object

The number of tracks on the playlist.

Station

Response Example

Note: In this version, the links section may be missing attributes mediumImage and largeImage from some endpoints.

Note: In this version, the links section may be missing attributes mediumImage and largeImage from some endpoints.

When using the parameter 'include' paired with an object type returned in the links section, this section will be populated with full meta objects of the specified type. Please see 'common features' for more details.

linked

object

NOTE, this will be deprecated in version 2.2. When using the parameter 'include' paired with an object type returned in the links section, this section will be populated with full meta objects of the specified type.

A shortcut to the track that usually follows the pattern "{artist_name}/{album_name}/{track_name}"

blurbs

array

A list of blurbs about the track.

artistName

string

The name of the artist the track belongs to.

artistId

string

The ID of the artist the track belongs to.

albumName

string

The name of the album the track belongs to.

albumId

string

The ID of the album the track belongs to.

formats

array of format objects

A list of the tracks valid formats.

contributors

object

The contributors on the track. This object will have one or more of the following keys- "primaryArtist", "composer", "featuredPerformer", "guestMusician", "guestVocals", "producer", "nonPrimary", "conductor"

previewURL

string

A link to a preview of the track.

isStreamable

boolean

This indicates whether or not the track is streamable.

links

object

Links to all of the Track's related objects.

linked

object

When using the parameter 'include' paired with an object type returned in the links section, this section will be populated with full meta objects of the specified type. Please see 'common features' for more details.

linked

object

NOTE, this will be deprecated in version 2.2. When using the parameter 'include' paired with an object type returned in the links section, this section will be populated with full meta objects of the specified type.