Contents

Get Charts Playlists by Storefront Value

Fetch one or more Charts Playlists by using their Storefront value.

URL

GET https://api.music.apple.com/v1/catalog/{storefront}/playlists

Path Parameters

NameTypeDescription
storefront Requiredstring

An iTunes Store territory, specified by an ISO 3166 alpha-2 country code. The possible values are the id attributes of Storefront objects.

Query Parameters

NameTypeDescription
extend Optional[string]

A list of attribute extensions to apply to resources in the response.

filter[storefront-chart] Required[string]

A filter to apply to the request.

include Optional[string]

Additional relationships to include in the fetch.

l Optionalstring

The localization to use, specified by a language tag. The possible values are in the supportedLanguageTags array belonging to the Storefront object specified by storefront. Otherwise, the default is defaultLanguageTag in Storefront.

Response Codes

StatusReasonTypeDescription
200OK
Content-Type: application/json
PlaylistsResponse

The request was successful.

401Unauthorized
Content-Type: application/json
UnauthorizedResponse

A response indicating an incorrect Authorization header.

500Internal Server Error
Content-Type: application/json
ErrorsResponse

A response indicating an error occurred on the server.

Discussion

Example

See Also

Related Documentation

Requesting a Catalog Playlist