Spotify Web API
  1. category-library
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 a Category
    • Get a Category's Playlists
    • Get All Featured Playlists
    • Get All New Releases
    • Get Recommendations
    • Get Recommendation Genres
  • 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
      DELETE
    • Get User's Saved Albums
      GET
    • Save Albums for Current User
      PUT
    • Check User's Saved Albums
      GET
    • Remove User's Saved Episodes
      DELETE
    • Get User's Saved Episodes
      GET
    • Save Episodes for User
      PUT
    • Check User's Saved Episodes
      GET
    • Remove User's Saved Shows
      DELETE
    • Get User's Saved Shows
      GET
    • Save Shows for Current User
      PUT
    • Check User's Saved Shows
      GET
    • Remove User's Saved Tracks
      DELETE
    • Get User's Saved Tracks
      GET
    • Save Tracks for User
      PUT
    • Check User's Saved Tracks
      GET
  • 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 a Playlist
    • Change a Playlist's Details
    • Get a Playlist Cover Image
    • Upload a Custom Playlist Cover Image
    • Remove Items from a Playlist
    • Get a Playlist's Items
    • Add Items to a Playlist
    • Reorder or Replace a Playlist's Items
    • Get a List of a User's Playlists
    • Create a Playlist
  • 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-library

Get User's Saved Shows

Developing
GET
/me/shows
category-library
Get a list of shows saved in the current Spotify user's library. Optional parameters can be used to limit the number of shows returned.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.spotify.com/v1/me/shows' \
--header 'Authorization;'
Response Response Example
200 - Example 1
{
  "href": "string",
  "items": [
    {
      "added_at": "2019-08-24T14:15:22Z",
      "show": {
        "available_markets": [
          "string"
        ],
        "copyrights": [
          {
            "text": "string",
            "type": "string"
          }
        ],
        "description": "string",
        "explicit": true,
        "external_urls": {
          "spotify": "string"
        },
        "href": "string",
        "html_description": "string",
        "id": "string",
        "images": [
          {
            "height": 0,
            "url": "string",
            "width": 0
          }
        ],
        "is_externally_hosted": true,
        "languages": [
          "string"
        ],
        "media_type": "string",
        "name": "string",
        "publisher": "string",
        "type": "string",
        "uri": "string"
      }
    }
  ],
  "limit": 0,
  "next": "string",
  "offset": 0,
  "previous": "string",
  "total": 0
}

Request

Query Params
limit
integer 
optional
The maximum number of shows to return. Default: 20. Minimum: 1. Maximum: 50
offset
integer 
optional
The index of the first show to return. Default: 0 (the first object). Use with limit to get the next set of shows.
Header Params
Authorization
string 
required
A valid access token from the Spotify Accounts service: see the Web API Authorization Guide for details. The access token must have been isued on behalf of the user. The user-library-read scope must have been authorised by the user.

Responses

🟢200On success, the HTTP status code in the response header is `200` OK and the response body contains an array of [saved show objects](https://developer.spotify.com/documentation/web-api/reference/#object-savedshowobject) (wrapped in a [paging object](https:
application/json
Body
href
string 
optional
A link to the Web API endpoint returning the full result of the request
items
array[object (SavedShowObject) {2}] 
optional
The requested data.
added_at
string <date-time>
optional
The date and time the show was saved. Timestamps are returned in ISO 8601 format as Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ. If the time is imprecise (for example, the date/time of an album release), an additional field indicates the precision; see for example, release_date in an album object.
show
object (SimplifiedShowObject) 
optional
limit
integer <int32>
optional
The maximum number of items in the response (as set in the query or by default).
next
string 
optional
URL to the next page of items. ( null if none)
offset
integer <int32>
optional
The offset of the items returned (as set in the query or by default)
previous
string 
optional
URL to the previous page of items. ( null if none)
total
integer <int32>
optional
The total number of items available to return.
🔴500500
Modified at 2022-09-12 10:04:50
Previous
Remove User's Saved Shows
Next
Save Shows for Current User
Built with