Spotify Web API
  1. category-playlists
Spotify Web API
  • category-albums
    • Get Multiple Albums
      GET
    • Get an Album
      GET
    • Get an Album's Tracks
      GET
  • category-artists
    • Get Multiple Artists
      GET
    • Get an Artist
      GET
    • Get an Artist's Albums
      GET
    • Get an Artist's Related Artists
      GET
    • Get an Artist's Top Tracks
      GET
  • category-tracks
    • Get Audio Analysis for a Track
      GET
    • Get Audio Features for Several Tracks
      GET
    • Get Audio Features for a Track
      GET
    • Get Several Tracks
      GET
    • Get a Track
      GET
  • category-browse
    • Get All Categories
      GET
    • Get a Category
      GET
    • Get a Category's Playlists
      GET
    • Get All Featured Playlists
      GET
    • Get All New Releases
      GET
    • Get Recommendations
      GET
    • Get Recommendation Genres
      GET
  • category-episodes
    • Get Multiple Episodes
    • Get an Episode
  • category-markets
    • Get Available Markets
  • category-users-profile
    • Get Current User's Profile
    • Get a User's Profile
  • category-library
    • Remove Albums for Current User
    • Get User's Saved Albums
    • Save Albums for Current User
    • Check User's Saved Albums
    • Remove User's Saved Episodes
    • Get User's Saved Episodes
    • Save Episodes for User
    • Check User's Saved Episodes
    • Remove User's Saved Shows
    • Get User's Saved Shows
    • Save Shows for Current User
    • Check User's Saved Shows
    • Remove User's Saved Tracks
    • Get User's Saved Tracks
    • Save Tracks for User
    • Check User's Saved Tracks
  • category-follow
    • Unfollow Artists or Users
    • Get User's Followed Artists
    • Follow Artists or Users
    • Get Following State for Artists/Users
    • Unfollow Playlist
    • Follow a Playlist
    • Check if Users Follow a Playlist
  • category-player
    • Get Information About The User's Current Playback
    • Transfer a User's Playback
    • Get the User's Currently Playing Track
    • Get a User's Available Devices
    • Skip User’s Playback To Next Track
    • Pause a User's Playback
    • Start/Resume a User's Playback
    • Skip User’s Playback To Previous Track
    • Add an item to queue
    • Get Current User's Recently Played Tracks
    • Set Repeat Mode On User’s Playback
    • Seek To Position In Currently Playing Track
    • Toggle Shuffle For User’s Playback
    • Set Volume For User's Playback
  • category-playlists
    • Get a List of Current User's Playlists
      GET
    • Get a Playlist
      GET
    • Change a Playlist's Details
      PUT
    • Get a Playlist Cover Image
      GET
    • Upload a Custom Playlist Cover Image
      PUT
    • Remove Items from a Playlist
      DELETE
    • Get a Playlist's Items
      GET
    • Add Items to a Playlist
      POST
    • Reorder or Replace a Playlist's Items
      PUT
    • Get a List of a User's Playlists
      GET
    • Create a Playlist
      POST
  • category-personalization
    • Get a User's Top Artists and Tracks
  • category-search
    • Search for an Item
  • category-shows
    • Get Multiple Shows
    • Get a Show
    • Get a Show's Episodes
  1. category-playlists

Get a Playlist's Items

GET
/playlists/{playlist_id}/tracks
category-playlists
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).
next
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)
previous
string 
可选
URL to the previous page of items. ( null if none)
total
integer <int32>
可选
The total number of items available to return.
🔴500500
上一页
Remove Items from a Playlist
下一页
Add Items to a Playlist
Built with