{ "opencollection": "1.0.0", "info": { "name": "Spotify Web Albums Library API", "version": "1.0.0" }, "items": [ { "info": { "name": "Library", "type": "folder" }, "items": [ { "info": { "name": "Get User's Saved Audiobooks\n", "type": "http" }, "http": { "method": "GET", "url": "https://api.spotify.com/v1/me/audiobooks", "params": [ { "name": "limit", "value": "", "type": "query" }, { "name": "offset", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Get a list of the audiobooks saved in the current Spotify user's 'Your Music' library.\n" }, { "info": { "name": "Save Audiobooks for Current User\n", "type": "http" }, "http": { "method": "PUT", "url": "https://api.spotify.com/v1/me/audiobooks", "params": [ { "name": "ids", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Save one or more audiobooks to the current Spotify user's library.\n\n**Note:** This endpoint is deprecated. Use [Save Items to Library](/documentation/web-api/reference/save-library-items) instead.\n" }, { "info": { "name": "Remove User's Saved Audiobooks\n", "type": "http" }, "http": { "method": "DELETE", "url": "https://api.spotify.com/v1/me/audiobooks", "params": [ { "name": "ids", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Remove one or more audiobooks from the Spotify user's library.\n\n**Note:** This endpoint is deprecated. Use [Remove Items from Library](/documentation/web-api/reference/remove-library-items) instead.\n" }, { "info": { "name": "Check User's Saved Audiobooks\n", "type": "http" }, "http": { "method": "GET", "url": "https://api.spotify.com/v1/me/audiobooks/contains", "params": [ { "name": "ids", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Check if one or more audiobooks are already saved in the current Spotify user's library.\n\n**Note:** This endpoint is deprecated. Use [Check User's Saved Items](/documentation/web-api/reference/check-library-contains) instead.\n" }, { "info": { "name": "Change Playlist Details\n", "type": "http" }, "http": { "method": "PUT", "url": "https://api.spotify.com/v1/playlists/:playlist_id", "params": [ { "name": "playlist_id", "value": "", "type": "path" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Change a playlist's name and public/private state. (The user must, of\ncourse, own the playlist.)\n" }, { "info": { "name": "Get Current User's Playlists\n", "type": "http" }, "http": { "method": "GET", "url": "https://api.spotify.com/v1/me/playlists", "params": [ { "name": "limit", "value": "", "type": "query" }, { "name": "offset", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Get a list of the playlists owned or followed by the current Spotify\nuser.\n" }, { "info": { "name": "Create Playlist\n", "type": "http" }, "http": { "method": "POST", "url": "https://api.spotify.com/v1/me/playlists", "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Create a playlist for the current Spotify user. (The playlist will be empty until\nyou [add tracks](/documentation/web-api/reference/add-tracks-to-playlist).)\nEach user is generally limited to a maximum of 11000 playlists.\n" }, { "info": { "name": "Save Items to Library\n", "type": "http" }, "http": { "method": "PUT", "url": "https://api.spotify.com/v1/me/library", "params": [ { "name": "uris", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Add one or more items to the current user's library. Accepts Spotify URIs for tracks, albums, episodes, shows, audiobooks, users, and playlists.\n" }, { "info": { "name": "Remove Items from Library\n", "type": "http" }, "http": { "method": "DELETE", "url": "https://api.spotify.com/v1/me/library", "params": [ { "name": "uris", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Remove one or more items from the current user's library. Accepts Spotify URIs for tracks, albums, episodes, shows, audiobooks, users, and playlists.\n" }, { "info": { "name": "Check User's Saved Items\n", "type": "http" }, "http": { "method": "GET", "url": "https://api.spotify.com/v1/me/library/contains", "params": [ { "name": "uris", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Check if one or more items are already saved in the current user's library. Accepts Spotify URIs for tracks, albums, episodes, shows, audiobooks, artists, users, and playlists.\n" }, { "info": { "name": "Get User's Saved Albums\n", "type": "http" }, "http": { "method": "GET", "url": "https://api.spotify.com/v1/me/albums", "params": [ { "name": "limit", "value": "", "type": "query" }, { "name": "offset", "value": "", "type": "query" }, { "name": "market", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Get a list of the albums saved in the current Spotify user's 'Your Music' library.\n" }, { "info": { "name": "Save Albums for Current User\n", "type": "http" }, "http": { "method": "PUT", "url": "https://api.spotify.com/v1/me/albums", "params": [ { "name": "ids", "value": "", "type": "query" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Save one or more albums to the current user's 'Your Music' library.\n\n**Note:** This endpoint is deprecated. Use [Save Items to Library](/documentation/web-api/reference/save-library-items) instead.\n" }, { "info": { "name": "Remove Users' Saved Albums\n", "type": "http" }, "http": { "method": "DELETE", "url": "https://api.spotify.com/v1/me/albums", "params": [ { "name": "ids", "value": "", "type": "query" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Remove one or more albums from the current user's 'Your Music' library.\n\n**Note:** This endpoint is deprecated. Use [Remove Items from Library](/documentation/web-api/reference/remove-library-items) instead.\n" }, { "info": { "name": "Check User's Saved Albums\n", "type": "http" }, "http": { "method": "GET", "url": "https://api.spotify.com/v1/me/albums/contains", "params": [ { "name": "ids", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Check if one or more albums is already saved in the current Spotify user's 'Your Music' library.\n\n**Note:** This endpoint is deprecated. Use [Check User's Saved Items](/documentation/web-api/reference/check-library-contains) instead.\n" }, { "info": { "name": "Get User's Saved Tracks\n", "type": "http" }, "http": { "method": "GET", "url": "https://api.spotify.com/v1/me/tracks", "params": [ { "name": "market", "value": "", "type": "query" }, { "name": "limit", "value": "", "type": "query" }, { "name": "offset", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Get a list of the songs saved in the current Spotify user's 'Your Music' library.\n" }, { "info": { "name": "Save Tracks for Current User\n", "type": "http" }, "http": { "method": "PUT", "url": "https://api.spotify.com/v1/me/tracks", "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Save one or more tracks to the current user's 'Your Music' library.\n\n**Note:** This endpoint is deprecated. Use [Save Items to Library](/documentation/web-api/reference/save-library-items) instead.\n" }, { "info": { "name": "Remove User's Saved Tracks\n", "type": "http" }, "http": { "method": "DELETE", "url": "https://api.spotify.com/v1/me/tracks", "params": [ { "name": "ids", "value": "", "type": "query" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Remove one or more tracks from the current user's 'Your Music' library.\n\n**Note:** This endpoint is deprecated. Use [Remove Items from Library](/documentation/web-api/reference/remove-library-items) instead.\n" }, { "info": { "name": "Check User's Saved Tracks\n", "type": "http" }, "http": { "method": "GET", "url": "https://api.spotify.com/v1/me/tracks/contains", "params": [ { "name": "ids", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Check if one or more tracks is already saved in the current Spotify user's 'Your Music' library.\n\n**Note:** This endpoint is deprecated. Use [Check User's Saved Items](/documentation/web-api/reference/check-library-contains) instead.\n" }, { "info": { "name": "Get User's Saved Episodes\n", "type": "http" }, "http": { "method": "GET", "url": "https://api.spotify.com/v1/me/episodes", "params": [ { "name": "market", "value": "", "type": "query" }, { "name": "limit", "value": "", "type": "query" }, { "name": "offset", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Get a list of the episodes saved in the current Spotify user's library.\n" }, { "info": { "name": "Save Episodes for Current User\n", "type": "http" }, "http": { "method": "PUT", "url": "https://api.spotify.com/v1/me/episodes", "params": [ { "name": "ids", "value": "", "type": "query" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Save one or more episodes to the current user's library.\n\n**Note:** This endpoint is deprecated. Use [Save Items to Library](/documentation/web-api/reference/save-library-items) instead.\n" }, { "info": { "name": "Remove User's Saved Episodes\n", "type": "http" }, "http": { "method": "DELETE", "url": "https://api.spotify.com/v1/me/episodes", "params": [ { "name": "ids", "value": "", "type": "query" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Remove one or more episodes from the current user's library.\n\n**Note:** This endpoint is deprecated. Use [Remove Items from Library](/documentation/web-api/reference/remove-library-items) instead.\n" }, { "info": { "name": "Check User's Saved Episodes\n", "type": "http" }, "http": { "method": "GET", "url": "https://api.spotify.com/v1/me/episodes/contains", "params": [ { "name": "ids", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Check if one or more episodes is already saved in the current Spotify user's 'Your Episodes' library.\n\n**Note:** This endpoint is deprecated. Use [Check User's Saved Items](/documentation/web-api/reference/check-library-contains) instead.\n" }, { "info": { "name": "Get User's Saved Shows\n", "type": "http" }, "http": { "method": "GET", "url": "https://api.spotify.com/v1/me/shows", "params": [ { "name": "limit", "value": "", "type": "query" }, { "name": "offset", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "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.\n" }, { "info": { "name": "Save Shows for Current User\n", "type": "http" }, "http": { "method": "PUT", "url": "https://api.spotify.com/v1/me/shows", "params": [ { "name": "ids", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Save one or more shows to current Spotify user's library.\n\n**Note:** This endpoint is deprecated. Use [Save Items to Library](/documentation/web-api/reference/save-library-items) instead.\n" }, { "info": { "name": "Remove User's Saved Shows\n", "type": "http" }, "http": { "method": "DELETE", "url": "https://api.spotify.com/v1/me/shows", "params": [ { "name": "ids", "value": "", "type": "query" }, { "name": "market", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Delete one or more shows from current Spotify user's library.\n\n**Note:** This endpoint is deprecated. Use [Remove Items from Library](/documentation/web-api/reference/remove-library-items) instead.\n" }, { "info": { "name": "Check User's Saved Shows\n", "type": "http" }, "http": { "method": "GET", "url": "https://api.spotify.com/v1/me/shows/contains", "params": [ { "name": "ids", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Check if one or more shows is already saved in the current Spotify user's library.\n\n**Note:** This endpoint is deprecated. Use [Check User's Saved Items](/documentation/web-api/reference/check-library-contains) instead.\n" }, { "info": { "name": "Get User's Top Items\n", "type": "http" }, "http": { "method": "GET", "url": "https://api.spotify.com/v1/me/top/:type", "params": [ { "name": "type", "value": "", "type": "path" }, { "name": "time_range", "value": "", "type": "query" }, { "name": "limit", "value": "", "type": "query" }, { "name": "offset", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Get the current user's top artists or tracks based on calculated affinity.\n" }, { "info": { "name": "Create Playlist for user\n", "type": "http" }, "http": { "method": "POST", "url": "https://api.spotify.com/v1/users/:user_id/playlists", "params": [ { "name": "user_id", "value": "", "type": "path" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "**Deprecated**: Use [Create Playlist](/documentation/web-api/reference/create-playlist) instead.\n\nCreate a playlist for a Spotify user. (The playlist will be empty until\nyou [add tracks](/documentation/web-api/reference/add-tracks-to-playlist).)\nEach user is generally limited to a maximum of 11000 playlists.\n" }, { "info": { "name": "Get Followed Artists\n", "type": "http" }, "http": { "method": "GET", "url": "https://api.spotify.com/v1/me/following", "params": [ { "name": "type", "value": "", "type": "query" }, { "name": "after", "value": "", "type": "query" }, { "name": "limit", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Get the current user's followed artists.\n" }, { "info": { "name": "Follow Artists or Users\n", "type": "http" }, "http": { "method": "PUT", "url": "https://api.spotify.com/v1/me/following", "params": [ { "name": "type", "value": "", "type": "query" }, { "name": "ids", "value": "", "type": "query" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Add the current user as a follower of one or more artists or other Spotify users.\n\n**Note:** This endpoint is deprecated. Use [Save Items to Library](/documentation/web-api/reference/save-library-items) instead.\n" }, { "info": { "name": "Unfollow Artists or Users\n", "type": "http" }, "http": { "method": "DELETE", "url": "https://api.spotify.com/v1/me/following", "params": [ { "name": "type", "value": "", "type": "query" }, { "name": "ids", "value": "", "type": "query" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Remove the current user as a follower of one or more artists or other Spotify users.\n\n**Note:** This endpoint is deprecated. Use [Remove Items from Library](/documentation/web-api/reference/remove-library-items) instead.\n" }, { "info": { "name": "Check If User Follows Artists or Users\n", "type": "http" }, "http": { "method": "GET", "url": "https://api.spotify.com/v1/me/following/contains", "params": [ { "name": "type", "value": "", "type": "query" }, { "name": "ids", "value": "", "type": "query" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.spotify.com/authorize", "accessTokenUrl": "https://accounts.spotify.com/api/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Check to see if the current user is following one or more artists or other Spotify users.\n\n**Note:** This endpoint is deprecated. Use [Check User's Saved Items](/documentation/web-api/reference/check-library-contains) instead.\n" } ] } ], "bundled": true }