Get a List of a User's Playlists

Get a list of the playlists owned or followed by a Spotify user.

{ "href": "string", "items": [ { "collaborative": true, "description": "string", "external_urls": { "spotify": "string" }, "href": "string", "id": "string", "images": [ { "height": 0, "url": "string", "width": 0 } ], "name": "string", "owner": { "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" }, "public": true, "snapshot_id": "string", "tracks": { "href": "string", "total": 0 }, "type": "string", "uri": "string" } ], "limit": 0, "next": "string", "offset": 0, "previous": "string", "total": 0 }

请求参数

Path 参数

user_id

必需

The user's Spotify user ID.

Query 参数

limit

可选

The maximum number of playlists to return. Default: 20. Minimum: 1. Maximum: 50.

offset

可选

The index of the first playlist to return. Default: 0 (the first object). Maximum offset: 100.000. Use with limit to get the next set of playlists.

Header 参数

Authorization

必需

A valid access token from the Spotify Accounts service: see the Web API Authorization Guide for details.
Private playlists are only retrievable for the current user and requires the playlist-read-private scope to have been authorized by the user. Note that this scope alone will not return collaborative playlists, even though they are always private.
Collaborative playlists are only retrievable for the current user and requires the playlist-read-collaborative scope to have been authorized by the user.

返回响应

🟢200On success, the HTTP status code in the response header is `200` OK and the response body contains an array of simplified [playlist objects](https://developer.spotify.com/documentation/web-api/reference/#object-simplifiedplaylistobject) (wrapped in a [pag

application/json

Body

href

string

可选

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

items

array[object (SimplifiedPlaylistObject) {13}]

可选

The requested data.

collaborative

boolean

可选

true if the owner allows other users to modify the playlist.

description

string

可选

The playlist description. Only returned for modified, verified playlists, otherwise null.

external_urls

object (ExternalUrlObject)

可选

href

string

可选

A link to the Web API endpoint providing full details of the playlist.

string

可选

The Spotify ID for the playlist.

images

array[object (ImageObject) {3}]

可选

Images for the playlist. The array may be empty or contain up to three images. The images are returned by size in descending order. See Working with Playlists. Note: If returned, the source URL for the image (url) is temporary and will expire in less than a day.

name

string

可选

The name of the playlist.

owner

object (PublicUserObject)

可选

public

boolean

可选

The playlist's public/private status: true the playlist is public, false the playlist is private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists

snapshot_id

string

可选

The version identifier for the current playlist. Can be supplied in other requests to target a specific playlist version

tracks

object (PlaylistTracksRefObject)

可选

type

string

可选

The object type: "playlist"

uri

string

可选

The Spotify URI for the playlist.

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