Get a Playlist's Items

GET

/playlists/{playlist_id}/tracks

Get full details of the items of a playlist owned by a Spotify user.

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.spotify.com/playlists//tracks' \
--header 'Authorization;'

响应示例

200 - 示例 1

{
    "href": "string",
    "items": [
        {
            "added_at": "2019-08-24T14:15:22Z",
            "added_by": {
                "display_name": "string",
                "external_urls": {
                    "spotify": "string"
                },
                "followers": {
                    "href": "string",
                    "total": 0
                },
                "href": "string",
                "id": "string",
                "images": [
                    {
                        "height": 0,
                        "url": "string",
                        "width": 0
                    }
                ],
                "type": "string",
                "uri": "string"
            },
            "is_local": true,
            "track": {
                "album": {
                    "album_group": "string",
                    "album_type": "string",
                    "artists": [
                        {
                            "external_urls": {
                                "spotify": "string"
                            },
                            "href": "string",
                            "id": "string",
                            "name": "string",
                            "type": "string",
                            "uri": "string"
                        }
                    ],
                    "available_markets": [
                        "string"
                    ],
                    "external_urls": {
                        "spotify": "string"
                    },
                    "href": "string",
                    "id": "string",
                    "images": [
                        {
                            "height": 0,
                            "url": "string",
                            "width": 0
                        }
                    ],
                    "name": "string",
                    "release_date": "string",
                    "release_date_precision": "string",
                    "restrictions": {
                        "reason": "string"
                    },
                    "total_tracks": 0,
                    "type": "string",
                    "uri": "string"
                },
                "artists": [
                    {
                        "external_urls": {
                            "spotify": "string"
                        },
                        "followers": {
                            "href": "string",
                            "total": 0
                        },
                        "genres": [
                            "string"
                        ],
                        "href": "string",
                        "id": "string",
                        "images": [
                            {
                                "height": 0,
                                "url": "string",
                                "width": 0
                            }
                        ],
                        "name": "string",
                        "popularity": 0,
                        "type": "string",
                        "uri": "string"
                    }
                ],
                "available_markets": [
                    "string"
                ],
                "disc_number": 0,
                "duration_ms": 0,
                "explicit": true,
                "external_ids": {
                    "ean": "string",
                    "isrc": "string",
                    "upc": "string"
                },
                "external_urls": {
                    "spotify": "string"
                },
                "href": "string",
                "id": "string",
                "is_local": true,
                "is_playable": true,
                "linked_from": {
                    "external_urls": {
                        "spotify": "string"
                    },
                    "href": "string",
                    "id": "string",
                    "type": "string",
                    "uri": "string"
                },
                "name": "string",
                "popularity": 0,
                "preview_url": "string",
                "restrictions": {
                    "reason": "string"
                },
                "track_number": 0,
                "type": "string",
                "uri": "string"
            }
        }
    ],
    "limit": 0,
    "next": "string",
    "offset": 0,
    "previous": "string",
    "total": 0
}

请求参数

Path 参数

playlist_id

必需

The Spotify ID for the playlist.

Query 参数

market

可选

An ISO 3166-1 alpha-2 country code or the string from_token. Provide this parameter if you want to apply Track
Relinking. For episodes, if a valid user access token is specified in the request header, the country associated with the user account will take priority over this parameter.
Note: If neither market or user country are provided, the episode is considered unavailable for the client.

fields

可选

Filters for the query: a comma-separated list of the fields to return. If omitted, all fields are returned. For example, to get just the total number of items and the request limit:
fields=total,limit
A dot separator can be used to specify non-reoccurring fields, while parentheses can be used to specify reoccurring fields within objects. For example, to get just the added date and user ID of the adder:
fields=items(added_at,added_by.id)
Use multiple parentheses to drill down into nested objects, for example:
fields=items(track(name,href,album(name,href)))
Fields can be excluded by prefixing them with an exclamation mark, for example:
fields=items.track.album(!external_urls,images)

limit

可选

The maximum number of items to return. Default: 100. Minimum: 1. Maximum: 100.

offset

可选

The index of the first item to return. Default: 0 (the first object).

additional_types

可选

A comma-separated list of item types that your client supports besides the default track type. Valid types are: track and episode. Note : This parameter was introduced to allow existing clients to maintain their current behaviour and might be deprecated in the future. In addition to providing this parameter, make sure that your client properly handles cases of new types in the future by checking against the type field of each object.

Header 参数

Authorization

必需

A valid access token from the Spotify Accounts service: see the Web API Authorization Guide for details. Both Public and Private playlists belonging to any user are retrievable on provision of a valid access token.

返回响应

🟢200On success, the response body contains an array of [track objects](https://developer.spotify.com/documentation/web-api/reference/#object-simplifiedtrackobject) and [episode objects](https://developer.spotify.com/documentation/web-api/reference/#object-sim

application/json

Body

href

string

可选

A link to the Web API endpoint returning the full result of the request

items

array[object (PlaylistTrackObject) {4}]

可选

The requested data.

added_at

string <date-time>

可选

The date and time the track or episode was added. Note that some very old playlists may return null in this field.

added_by

object (PublicUserObject)

可选

is_local

boolean

可选

Whether this track or episode is a local file or not.

track

可选

Information about the track or episode.

limit

integer <int32>

可选

The maximum number of items in the response (as set in the query or by default).

string

可选

URL to the next page of items. ( null if none)

offset

integer <int32>

可选

The offset of the items returned (as set in the query or by default)

string

可选

URL to the previous page of items. ( null if none)

total

integer <int32>

可选

The total number of items available to return.

🔴500500

修改于 2021-08-02 10:49:34

Remove Items from a Playlist

Add Items to a Playlist