Skip to content
Web API •References / Playlists / Get Playlist Items

Get Playlist Items

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

Important policy notes
Authorization scopes

Request

  • playlist_id
    string
    Required

    The Spotify ID of the playlist.

    Example value: "3cEYpjA9oz9GiPac4AsH4n"
  • market
    string

    An ISO 3166-1 alpha-2 country code. If a country code is specified, only content that is available in that market will be returned.
    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 content is considered unavailable for the client.
    Users can view the country that is associated with their account in the account settings.

    Example value: "ES"
  • fields
    string

    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)

    Example value: "items(added_by.id,track(name,href,album(name,href)))"
  • limit
    integer

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

    Example value: 10Default value: 20Range: 0 - 50
  • offset
    integer

    The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.

    Example value: 5Default value: 0
  • additional_types
    string

    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.

Response

Pages of tracks

  • href
    string
    Required

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

    Example value: "https://api.spotify.com/v1/me/shows?offset=0&limit=20"
  • limit
    integer
    Required

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

    Example value: 20
  • next
    string
    Required
    Nullable

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

    Example value: "https://api.spotify.com/v1/me/shows?offset=1&limit=1"
  • offset
    integer
    Required

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

    Example value: 0
  • previous
    string
    Required
    Nullable

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

    Example value: "https://api.spotify.com/v1/me/shows?offset=1&limit=1"
  • total
    integer
    Required

    The total number of items available to return.

    Example value: 4
  • Required
    • added_at
      string [date-time]

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

    • The Spotify user who added the track or episode. Note: some very old playlists may return null in this field.

    • is_local
      boolean

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

    • track
      oneOf

      Information about the track or episode.

      Will be one of the following: