openapi-directory
Version:
Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS
1 lines • 236 kB
JSON
{"openapi":"3.0.3","servers":[{"url":"https://api.spotify.com/v1"}],"info":{"contact":{"name":"sonallux","url":"https://github.com/sonallux/spotify-web-api"},"description":"You can use Spotify's Web API to discover music and podcasts, manage your Spotify library, control audio playback, and much more. Browse our available Web API endpoints using the sidebar at left, or via the navigation bar on top of this page on smaller screens.\n\nIn order to make successful Web API requests your app will need a valid access token. One can be obtained through <a href=\"https://developer.spotify.com/documentation/general/guides/authorization-guide/\">OAuth 2.0</a>.\n\nThe base URI for all Web API requests is `https://api.spotify.com/v1`.\n\nNeed help? See our <a href=\"https://developer.spotify.com/documentation/web-api/guides/\">Web API guides</a> for more information, or visit the <a href=\"https://community.spotify.com/t5/Spotify-for-Developers/bd-p/Spotify_Developer\">Spotify for Developers community forum</a> to ask questions and connect with other developers.\n","termsOfService":"https://developer.spotify.com/terms/","title":"Spotify Web API with fixes and improvements from sonallux","version":"2023.2.27","x-apisguru-categories":["media"],"x-logo":{"url":"https://logo-core.clearbit.com/spotify.com"},"x-origin":[{"format":"openapi","url":"https://raw.githubusercontent.com/sonallux/spotify-web-api/main/fixed-spotify-open-api.yml","version":"3.0"}],"x-providerName":"spotify.com","x-serviceName":"sonallux","x-unofficialSpec":true},"paths":{"/albums":{"get":{"description":"Get Spotify catalog information for multiple albums identified by their Spotify IDs.\n","operationId":"get-multiple-albums","parameters":[{"$ref":"#/components/parameters/QueryAlbumIds"},{"$ref":"#/components/parameters/QueryMarket"}],"responses":{"200":{"$ref":"#/components/responses/ManyAlbums"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":[]}],"summary":"Get Several Albums\n","tags":["Albums"],"x-spotify-docs-console-url":"/console/get-several-albums/","x-spotify-docs-endpoint-name":"Get Multiple Albums"},"x-spotify-docs-category":"Albums","x-spotify-docs-display-name":"several-albums"},"/albums/{id}":{"get":{"description":"Get Spotify catalog information for a single album.\n","operationId":"get-an-album","parameters":[{"$ref":"#/components/parameters/PathAlbumId"},{"$ref":"#/components/parameters/QueryMarket"}],"responses":{"200":{"$ref":"#/components/responses/OneAlbum"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":[]}],"summary":"Get Album\n","tags":["Albums"],"x-spotify-docs-console-url":"/console/get-album/?id=0sNOF9WDwhWunNAHPD3Baj","x-spotify-docs-endpoint-name":"Get an Album"},"x-spotify-docs-category":"Albums","x-spotify-docs-display-name":"album"},"/albums/{id}/tracks":{"get":{"description":"Get Spotify catalog information about an album’s tracks.\nOptional parameters can be used to limit the number of tracks returned.\n","operationId":"get-an-albums-tracks","parameters":[{"$ref":"#/components/parameters/PathAlbumId"},{"$ref":"#/components/parameters/QueryMarket"},{"$ref":"#/components/parameters/QueryLimit"},{"$ref":"#/components/parameters/QueryOffset"}],"responses":{"200":{"$ref":"#/components/responses/PagingSimplifiedTrackObject"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":[]}],"summary":"Get Album Tracks\n","tags":["Albums","Tracks"],"x-spotify-docs-console-url":"/console/get-album-tracks/","x-spotify-docs-endpoint-name":"Get an Album's Tracks"},"x-spotify-docs-category":"Albums","x-spotify-docs-display-name":"album-tracks"},"/artists":{"get":{"description":"Get Spotify catalog information for several artists based on their Spotify IDs.\n","operationId":"get-multiple-artists","parameters":[{"in":"query","name":"ids","required":true,"schema":{"description":"A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids) for the artists. Maximum: 50 IDs.\n","example":"2CIMQHirSU0MQqyYHq0eOx,57dN52uHvrHOxijzpIgu3E,1vCWHaC5f2uS3yhpwWbIA6","title":"Spotify Artist IDs","type":"string"}}],"responses":{"200":{"$ref":"#/components/responses/ManyArtists"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":[]}],"summary":"Get Several Artists\n","tags":["Artists"],"x-spotify-docs-console-url":"/console/get-several-artists/?ids=0oSGxfWSnnOXhD2fKuz2Gy,3dBVyJ7JuOMt4GE9607Qin","x-spotify-docs-endpoint-name":"Get Multiple Artists"},"x-spotify-docs-category":"Artists","x-spotify-docs-display-name":"several-artists"},"/artists/{id}":{"get":{"description":"Get Spotify catalog information for a single artist identified by their unique Spotify ID.\n","operationId":"get-an-artist","parameters":[{"$ref":"#/components/parameters/PathArtistId"}],"responses":{"200":{"$ref":"#/components/responses/OneArtist"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":[]}],"summary":"Get Artist\n","tags":["Artists"],"x-spotify-docs-console-url":"/console/get-artist/?id=0OdUWJ0sBjDrqHygGUXeCF","x-spotify-docs-endpoint-name":"Get an Artist"},"x-spotify-docs-category":"Artists","x-spotify-docs-display-name":"artist"},"/artists/{id}/albums":{"get":{"description":"Get Spotify catalog information about an artist's albums.\n","operationId":"get-an-artists-albums","parameters":[{"$ref":"#/components/parameters/PathArtistId"},{"$ref":"#/components/parameters/QueryIncludeGroups"},{"$ref":"#/components/parameters/QueryMarket"},{"$ref":"#/components/parameters/QueryLimit"},{"$ref":"#/components/parameters/QueryOffset"}],"responses":{"200":{"$ref":"#/components/responses/PagingSimplifiedAlbumObject"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":[]}],"summary":"Get Artist's Albums\n","tags":["Artists","Albums"],"x-spotify-docs-console-url":"/console/get-artist-albums/?album_type=single&limit=2&market=ES&id=1vCWHaC5f2uS3yhpwWbIA6","x-spotify-docs-endpoint-name":"Get an Artist's Albums"},"x-spotify-docs-category":"Artists","x-spotify-docs-display-name":"artist-albums"},"/artists/{id}/related-artists":{"get":{"description":"Get Spotify catalog information about artists similar to a given artist. Similarity is based on analysis of the Spotify community's [listening history](http://news.spotify.com/se/2010/02/03/related-artists/).\n","operationId":"get-an-artists-related-artists","parameters":[{"$ref":"#/components/parameters/PathArtistId"}],"responses":{"200":{"$ref":"#/components/responses/ManyArtists"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":[]}],"summary":"Get Artist's Related Artists\n","tags":["Artists"],"x-spotify-docs-console-url":"/console/get-artist-related-artists/?id=43ZHCT0cAZBISjO8DG9PnE","x-spotify-docs-endpoint-name":"Get an Artist's Related Artists"},"x-spotify-docs-category":"Artists","x-spotify-docs-display-name":"artist-related-artists"},"/artists/{id}/top-tracks":{"get":{"description":"Get Spotify catalog information about an artist's top tracks by country.\n","operationId":"get-an-artists-top-tracks","parameters":[{"$ref":"#/components/parameters/PathArtistId"},{"$ref":"#/components/parameters/QueryMarket"}],"responses":{"200":{"$ref":"#/components/responses/ManyTracks"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":[]}],"summary":"Get Artist's Top Tracks\n","tags":["Artists","Tracks"],"x-spotify-docs-console-url":"/console/get-artist-top-tracks/?country=SE&id=43ZHCT0cAZBISjO8DG9PnE","x-spotify-docs-endpoint-name":"Get an Artist's Top Tracks"},"x-spotify-docs-category":"Artists","x-spotify-docs-display-name":"artist-top-tracks"},"/audio-analysis/{id}":{"get":{"description":"Get a low-level audio analysis for a track in the Spotify catalog. The audio analysis describes the track’s structure and musical content, including rhythm, pitch, and timbre.\n","operationId":"get-audio-analysis","parameters":[{"in":"path","name":"id","required":true,"schema":{"description":"The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids)\nfor the track.\n","example":"11dFghVXANMlKmJXsNCbNl","title":"Spotify Track ID","type":"string"}}],"responses":{"200":{"$ref":"#/components/responses/OneAudioAnalysis"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":[]}],"summary":"Get Track's Audio Analysis\n","tags":["Tracks"],"x-spotify-docs-console-url":"/console/get-audio-analysis-track/?id=06AKEBrKUckW0KREUWRnvT","x-spotify-docs-endpoint-name":"Get Audio Analysis for a Track"},"x-spotify-docs-category":"Tracks","x-spotify-docs-display-name":"audio-analysis-track"},"/audio-features":{"get":{"description":"Get audio features for multiple tracks based on their Spotify IDs.\n","operationId":"get-several-audio-features","parameters":[{"in":"query","name":"ids","required":true,"schema":{"description":"A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids)\nfor the tracks. Maximum: 100 IDs.\n","example":"7ouMYWpwJ422jRcDASZB7P,4VqPOruhp5EdPBeR92t6lQ,2takcwOaAZWiXQijPHIx7B","title":"Spotify Track IDs","type":"string"}}],"responses":{"200":{"$ref":"#/components/responses/ManyAudioFeatures"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":[]}],"summary":"Get Tracks' Audio Features\n","tags":["Tracks"],"x-spotify-docs-console-url":"/console/get-audio-features-several-tracks/?ids=4JpKVNYnVcJ8tuMKjAj50A,2NRANZE9UCmPAS5XVbXL40,24JygzOLM0EmRQeGtFcIcG","x-spotify-docs-endpoint-name":"Get Audio Features for Several Tracks"},"x-spotify-docs-category":"Tracks","x-spotify-docs-display-name":"audio-features-several-tracks"},"/audio-features/{id}":{"get":{"description":"Get audio feature information for a single track identified by its unique\nSpotify ID.\n","operationId":"get-audio-features","parameters":[{"in":"path","name":"id","required":true,"schema":{"description":"The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the track.\n","example":"11dFghVXANMlKmJXsNCbNl","title":"Spotify Track ID","type":"string"}}],"responses":{"200":{"$ref":"#/components/responses/OneAudioFeatures"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":[]}],"summary":"Get Track's Audio Features\n","tags":["Tracks"],"x-spotify-docs-console-url":"/console/get-audio-features-track/?id=06AKEBrKUckW0KREUWRnvT","x-spotify-docs-endpoint-name":"Get Audio Features for a Track"},"x-spotify-docs-category":"Tracks","x-spotify-docs-display-name":"audio-features-track"},"/audiobooks":{"get":{"description":"Get Spotify catalog information for several audiobooks identified by their Spotify IDs.<br />\n**Note: Audiobooks are only available for the US, UK, Ireland, New Zealand and Australia markets.**\n","operationId":"get-multiple-audiobooks","parameters":[{"$ref":"#/components/parameters/QueryAudiobookIds"},{"$ref":"#/components/parameters/QueryMarket"}],"responses":{"200":{"$ref":"#/components/responses/ManyAudiobooks"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":[]}],"summary":"Get Several Audiobooks\n","tags":["Audiobooks"],"x-spotify-docs-console-url":"/console/get-several-audiobooks/?ids=5thw29eqjomhIDMY1XKsLk,2IEBhnu61ieYGFRPEJIO40","x-spotify-docs-endpoint-name":"Get Several Audiobooks"},"x-spotify-docs-category":"Audiobooks","x-spotify-docs-display-name":"several-audiobooks"},"/audiobooks/{id}":{"get":{"description":"Get Spotify catalog information for a single audiobook.<br />\n**Note: Audiobooks are only available for the US, UK, Ireland, New Zealand and Australia markets.**\n","operationId":"get-an-audiobook","parameters":[{"$ref":"#/components/parameters/PathAudiobookId"},{"$ref":"#/components/parameters/QueryMarket"}],"responses":{"200":{"$ref":"#/components/responses/OneAudiobook"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":[]}],"summary":"Get an Audiobook\n","tags":["Audiobooks"],"x-spotify-docs-console-url":"/console/get-audiobook/?id=5thw29eqjomhIDMY1XKsLk","x-spotify-docs-endpoint-name":"Get an Audiobook"},"x-spotify-docs-category":"Audiobooks","x-spotify-docs-display-name":"audiobook"},"/audiobooks/{id}/chapters":{"get":{"description":"Get Spotify catalog information about an audiobook's chapters.<br />\n**Note: Audiobooks are only available for the US, UK, Ireland, New Zealand and Australia markets.**\n","operationId":"get-audiobook-chapters","parameters":[{"$ref":"#/components/parameters/PathAudiobookId"},{"$ref":"#/components/parameters/QueryMarket"},{"$ref":"#/components/parameters/QueryLimit"},{"$ref":"#/components/parameters/QueryOffset"}],"responses":{"200":{"$ref":"#/components/responses/PagingSimplifiedChapterObject"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":[]}],"summary":"Get Audiobook Chapters\n","tags":["Audiobooks","Chapters"],"x-spotify-docs-console-url":"/console/get-audiobook-chapters/?id=5thw29eqjomhIDMY1XKsLk","x-spotify-docs-endpoint-name":"Get an Audiobook's Chapters"},"x-spotify-docs-category":"Audiobooks","x-spotify-docs-display-name":"audiobook-chapters"},"/browse/categories":{"get":{"description":"Get a list of categories used to tag items in Spotify (on, for example, the Spotify player’s “Browse” tab).\n","operationId":"get-categories","parameters":[{"in":"query","name":"country","required":false,"schema":{"description":"A country: an [ISO 3166-1 alpha-2 country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Provide this parameter if you want to narrow the list of returned categories to those relevant to a particular country. If omitted, the returned items will be globally relevant.\n","example":"SE","title":"Country","type":"string"}},{"in":"query","name":"locale","required":false,"schema":{"description":"The desired language, consisting of an [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code and an [ISO 3166-1 alpha-2 country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), joined by an underscore. For example: `es_MX`, meaning \"Spanish (Mexico)\". Provide this parameter if you want the category metadata returned in a particular language. <br/>\n_**Note**: if `locale` is not supplied, or if the specified language is not available, all strings will be returned in the Spotify default language (American English). The `locale` parameter, combined with the `country` parameter, may give odd results if not carefully matched. For example `country=SE&locale=de_DE` will return a list of categories relevant to Sweden but as German language strings._\n","example":"sv_SE","title":"Locale","type":"string"}},{"$ref":"#/components/parameters/QueryLimit"},{"$ref":"#/components/parameters/QueryOffset"}],"responses":{"200":{"$ref":"#/components/responses/PagedCategories"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":[]}],"summary":"Get Several Browse Categories\n","tags":["Categories"],"x-spotify-docs-console-url":"/console/get-browse-categories/","x-spotify-docs-endpoint-name":"Get All Categories"},"x-spotify-docs-category":"Browse","x-spotify-docs-display-name":"browse-categories"},"/browse/categories/{category_id}":{"get":{"description":"Get a single category used to tag items in Spotify (on, for example, the Spotify player’s “Browse” tab).\n","operationId":"get-a-category","parameters":[{"in":"path","name":"category_id","required":true,"schema":{"description":"The [Spotify category ID](/documentation/web-api/concepts/spotify-uris-ids) for the category.\n","example":"dinner","title":"Category ID","type":"string"}},{"in":"query","name":"country","required":false,"schema":{"description":"A country: an [ISO 3166-1 alpha-2 country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Provide this parameter to ensure that the category exists for a particular country.\n","example":"SE","title":"Country","type":"string"}},{"in":"query","name":"locale","required":false,"schema":{"description":"The desired language, consisting of an [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code and an [ISO 3166-1 alpha-2 country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), joined by an underscore. For example: `es_MX`, meaning "Spanish (Mexico)". Provide this parameter if you want the category strings returned in a particular language.<br/> _**Note**: if `locale` is not supplied, or if the specified language is not available, the category strings returned will be in the Spotify default language (American English)._\n","example":"sv_SE","title":"Locale","type":"string"}}],"responses":{"200":{"$ref":"#/components/responses/OneCategory"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":[]}],"summary":"Get Single Browse Category\n","tags":["Categories"],"x-spotify-docs-console-url":"/console/get-browse-category/","x-spotify-docs-endpoint-name":"Get a Category"},"x-spotify-docs-category":"Browse","x-spotify-docs-display-name":"browse-category"},"/browse/categories/{category_id}/playlists":{"get":{"description":"Get a list of Spotify playlists tagged with a particular category.\n","operationId":"get-a-categories-playlists","parameters":[{"in":"path","name":"category_id","required":true,"schema":{"description":"The [Spotify category ID](/documentation/web-api/concepts/spotify-uris-ids) for the category.\n","example":"dinner","title":"Category ID","type":"string"}},{"in":"query","name":"country","required":false,"schema":{"description":"A country: an [ISO 3166-1 alpha-2 country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Provide this parameter to ensure that the category exists for a particular country.\n","example":"SE","title":"Country","type":"string"}},{"$ref":"#/components/parameters/QueryLimit"},{"$ref":"#/components/parameters/QueryOffset"}],"responses":{"200":{"$ref":"#/components/responses/PagedFeaturedPlaylists"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":[]}],"summary":"Get Category's Playlists\n","tags":["Playlists","Categories"],"x-spotify-docs-console-url":"/console/get-category-playlists/?country=BR&category_id=party&limit=2","x-spotify-docs-endpoint-name":"Get a Category's Playlists"},"x-spotify-docs-category":"Browse","x-spotify-docs-display-name":"category-playlists"},"/browse/featured-playlists":{"get":{"description":"Get a list of Spotify featured playlists (shown, for example, on a Spotify player's 'Browse' tab).\n","operationId":"get-featured-playlists","parameters":[{"in":"query","name":"country","required":false,"schema":{"description":"A country: an [ISO 3166-1 alpha-2 country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Provide this parameter if you want the list of returned items to be relevant to a particular country. If omitted, the returned items will be relevant to all countries.\n","example":"SE","title":"Country","type":"string"}},{"in":"query","name":"locale","required":false,"schema":{"description":"The desired language, consisting of a lowercase [ISO 639-1 language code](http://en.wikipedia.org/wiki/ISO_639-1) and an uppercase [ISO 3166-1 alpha-2 country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), joined by an underscore. For example: `es_MX`, meaning \"Spanish (Mexico)\". Provide this parameter if you want the results returned in a particular language (where available). <br/>\n_**Note**: if `locale` is not supplied, or if the specified language is not available, all strings will be returned in the Spotify default language (American English). The `locale` parameter, combined with the `country` parameter, may give odd results if not carefully matched. For example `country=SE&locale=de_DE` will return a list of categories relevant to Sweden but as German language strings._\n","example":"sv_SE","title":"Locale","type":"string"}},{"in":"query","name":"timestamp","required":false,"schema":{"description":"A timestamp in [ISO 8601 format](http://en.wikipedia.org/wiki/ISO_8601): `yyyy-MM-ddTHH:mm:ss`. Use this parameter to specify the user's local time to get results tailored for that specific date and time in the day. If not provided, the response defaults to the current UTC time. Example: \"2014-10-23T09:00:00\" for a user whose local time is 9AM. If there were no featured playlists (or there is no data) at the specified time, the response will revert to the current UTC time.\n","example":"2025-04-15T13:51:53.825Z","title":"Timestamp","type":"string"}},{"$ref":"#/components/parameters/QueryLimit"},{"$ref":"#/components/parameters/QueryOffset"}],"responses":{"200":{"$ref":"#/components/responses/PagedFeaturedPlaylists"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":[]}],"summary":"Get Featured Playlists\n","tags":["Playlists"],"x-spotify-docs-console-url":"/console/get-featured-playlists/?country=SE&limit=2","x-spotify-docs-endpoint-name":"Get All Featured Playlists"},"x-spotify-docs-category":"Browse","x-spotify-docs-display-name":"featured-playlists"},"/browse/new-releases":{"get":{"description":"Get a list of new album releases featured in Spotify (shown, for example, on a Spotify player’s “Browse” tab).\n","operationId":"get-new-releases","parameters":[{"in":"query","name":"country","required":false,"schema":{"description":"A country: an [ISO 3166-1 alpha-2 country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Provide this parameter if you want the list of returned items to be relevant to a particular country. If omitted, the returned items will be relevant to all countries.\n","example":"SE","title":"Country","type":"string"}},{"$ref":"#/components/parameters/QueryLimit"},{"$ref":"#/components/parameters/QueryOffset"}],"responses":{"200":{"$ref":"#/components/responses/PagedAlbums"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":[]}],"summary":"Get New Releases\n","tags":["Albums"],"x-spotify-docs-console-url":"/console/get-new-releases/?country=SE","x-spotify-docs-endpoint-name":"Get All New Releases"},"x-spotify-docs-category":"Browse","x-spotify-docs-display-name":"new-releases"},"/chapters":{"get":{"description":"Get Spotify catalog information for several chapters identified by their Spotify IDs.<br />\n**Note: Chapters are only available for the US, UK, Ireland, New Zealand and Australia markets.**\n","operationId":"get-several-chapters","parameters":[{"$ref":"#/components/parameters/QueryChapterIds"},{"$ref":"#/components/parameters/QueryMarket"}],"responses":{"200":{"$ref":"#/components/responses/ManyChapters"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":[]}],"summary":"Get Several Chapters\n","tags":["Chapters"],"x-spotify-docs-console-url":"/console/get-several-chapters/?ids=2i47HuOBSV2XaJNy0NCZXM,2GUbORsUnP1qVVlLwd9DzP","x-spotify-docs-endpoint-name":"Get Several Chapters"},"x-spotify-docs-category":"Chapters","x-spotify-docs-display-name":"several-chapters"},"/chapters/{id}":{"get":{"description":"Get Spotify catalog information for a single chapter.<br />\n**Note: Chapters are only available for the US, UK, Ireland, New Zealand and Australia markets.**\n","operationId":"get-a-chapter","parameters":[{"$ref":"#/components/parameters/PathChapterId"},{"$ref":"#/components/parameters/QueryMarket"}],"responses":{"200":{"$ref":"#/components/responses/OneChapter"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":[]}],"summary":"Get a Chapter\n","tags":["Chapters"],"x-spotify-docs-console-url":"/console/get-chapter/?id=2i47HuOBSV2XaJNy0NCZXM","x-spotify-docs-endpoint-name":"Get a Chapter"},"x-spotify-docs-category":"Chapters","x-spotify-docs-display-name":"chapters"},"/episodes":{"get":{"description":"Get Spotify catalog information for several episodes based on their Spotify IDs.\n","operationId":"get-multiple-episodes","parameters":[{"in":"query","name":"ids","required":true,"schema":{"description":"A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids) for the episodes. Maximum: 50 IDs.\n","example":"77o6BIVlYM3msb4MMIL1jH,0Q86acNRm6V9GYx55SXKwf","title":"Ids","type":"string"}},{"$ref":"#/components/parameters/QueryMarket"}],"responses":{"200":{"$ref":"#/components/responses/ManyEpisodes"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":["user-read-playback-position"]}],"summary":"Get Several Episodes\n","tags":["Episodes"],"x-spotify-docs-console-url":"/console/get-several-episodes/?ids=77o6BIVlYM3msb4MMIL1jH,0Q86acNRm6V9GYx55SXKwf","x-spotify-docs-endpoint-name":"Get Multiple Episodes"},"x-spotify-docs-category":"Episodes","x-spotify-docs-display-name":"several-episodes"},"/episodes/{id}":{"get":{"description":"Get Spotify catalog information for a single episode identified by its\nunique Spotify ID.\n","operationId":"get-an-episode","parameters":[{"in":"path","name":"id","required":true,"schema":{"description":"The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the episode.","example":"512ojhOuo1ktJprKbVcKyQ","title":"Get an Episode","type":"string"}},{"$ref":"#/components/parameters/QueryMarket"}],"responses":{"200":{"$ref":"#/components/responses/OneEpisode"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":["user-read-playback-position"]}],"summary":"Get Episode\n","tags":["Episodes"],"x-spotify-docs-console-url":"/console/get-episode/?id=512ojhOuo1ktJprKbVcKyQ","x-spotify-docs-endpoint-name":"Get an Episode"},"x-spotify-docs-category":"Episodes","x-spotify-docs-display-name":"episode"},"/markets":{"get":{"description":"Get the list of markets where Spotify is available.\n","operationId":"get-available-markets","responses":{"200":{"$ref":"#/components/responses/Markets"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":[]}],"summary":"Get Available Markets\n","tags":["Markets"],"x-spotify-docs-console-url":"/console/get-available-markets/","x-spotify-docs-endpoint-name":"Get Available Markets"},"x-spotify-docs-category":"Markets","x-spotify-docs-display-name":"available-markets"},"/me":{"get":{"description":"Get detailed profile information about the current user (including the\ncurrent user's username).\n","operationId":"get-current-users-profile","responses":{"200":{"$ref":"#/components/responses/OnePrivateUser"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":["user-read-private","user-read-email"]}],"summary":"Get Current User's Profile\n","tags":["Users"],"x-spotify-docs-console-url":"/console/get-current-user/","x-spotify-docs-endpoint-name":"Get Current User's Profile"},"x-spotify-docs-category":"Users Profile","x-spotify-docs-display-name":"current-user"},"/me/albums":{"delete":{"description":"Remove one or more albums from the current user's 'Your Music' library.\n","operationId":"remove-albums-user","parameters":[{"$ref":"#/components/parameters/QueryAlbumIds"}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"properties":{"ids":{"description":"A JSON array of the [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). For example: `[\"4iV5W9uYEdYUVa79Axb7Rh\", \"1301WleyT98MSxVHPZCA6M\"]`<br/>A maximum of 50 items can be specified in one request. _**Note**: if the `ids` parameter is present in the query string, any IDs listed here in the body will be ignored._\n","items":{"type":"string"},"type":"array"}},"type":"object"}}}},"responses":{"200":{"description":"Album(s) have been removed from the library"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":["user-library-modify"]}],"summary":"Remove Users' Saved Albums\n","tags":["Albums","Library"],"x-spotify-docs-console-url":"/console/delete-current-user-saved-albums/?ids=07bYtmE3bPsLB6ZbmmFi8d%2C48JYNjh7GMie6NjqYHMmtT%2C27cZdqrQiKt3IT00338dws","x-spotify-docs-endpoint-name":"Remove Albums for Current User"},"get":{"description":"Get a list of the albums saved in the current Spotify user's 'Your Music' library.\n","operationId":"get-users-saved-albums","parameters":[{"$ref":"#/components/parameters/QueryLimit"},{"$ref":"#/components/parameters/QueryOffset"},{"$ref":"#/components/parameters/QueryMarket"}],"responses":{"200":{"$ref":"#/components/responses/PagingSavedAlbumObject"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":["user-library-read"]}],"summary":"Get User's Saved Albums\n","tags":["Albums","Library"],"x-spotify-docs-console-url":"/console/get-current-user-saved-albums/?limit=1","x-spotify-docs-endpoint-name":"Get User's Saved Albums"},"put":{"description":"Save one or more albums to the current user's 'Your Music' library.\n","operationId":"save-albums-user","parameters":[{"$ref":"#/components/parameters/QueryAlbumIds"}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"properties":{"ids":{"description":"A JSON array of the [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). For example: `[\"4iV5W9uYEdYUVa79Axb7Rh\", \"1301WleyT98MSxVHPZCA6M\"]`<br/>A maximum of 50 items can be specified in one request. _**Note**: if the `ids` parameter is present in the query string, any IDs listed here in the body will be ignored._\n","items":{"type":"string"},"type":"array"}},"type":"object"}}}},"responses":{"200":{"description":"The album is saved"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":["user-library-modify"]}],"summary":"Save Albums for Current User\n","tags":["Albums","Library"],"x-spotify-docs-console-url":"/console/put-current-user-saved-albums/?ids=07bYtmE3bPsLB6ZbmmFi8d%2C48JYNjh7GMie6NjqYHMmtT%2C27cZdqrQiKt3IT00338dws","x-spotify-docs-endpoint-name":"Save Albums for Current User"},"x-spotify-docs-category":"Library","x-spotify-docs-display-name":"current-user-saved-albums"},"/me/albums/contains":{"get":{"description":"Check if one or more albums is already saved in the current Spotify user's 'Your Music' library.\n","operationId":"check-users-saved-albums","parameters":[{"$ref":"#/components/parameters/QueryAlbumIds"}],"responses":{"200":{"$ref":"#/components/responses/ArrayOfBooleans"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":["user-library-read"]}],"summary":"Check User's Saved Albums\n","tags":["Albums","Library"],"x-spotify-docs-console-url":"/console/get-current-user-contains-saved-albums/?ids=0pJJgBzj26qnE1nSQUxaB0%2C5ZAKzV4ZIa5Gt7z29OYHv0","x-spotify-docs-endpoint-name":"Check User's Saved Albums"},"x-spotify-docs-category":"Library","x-spotify-docs-display-name":"current-user-contains-saved-albums"},"/me/audiobooks":{"delete":{"description":"Remove one or more audiobooks from the Spotify user's library.\n","operationId":"remove-audiobooks-user","parameters":[{"$ref":"#/components/parameters/QueryAudiobookIds"}],"responses":{"200":{"description":"Audiobook(s) have been removed from the library"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":["user-library-modify"]}],"summary":"Remove User's Saved Audiobooks\n","tags":["Audiobooks","Library"],"x-spotify-docs-console-url":"/console/delete-current-user-saved-audiobooks/?ids=07bYtmE3bPsLB6ZbmmFi8d%2C48JYNjh7GMie6NjqYHMmtT%2C27cZdqrQiKt3IT00338dws","x-spotify-docs-endpoint-name":"Remove Audiobooks for Current User"},"get":{"description":"Get a list of the audiobooks saved in the current Spotify user's 'Your Music' library.\n","operationId":"get-users-saved-audiobooks","parameters":[{"$ref":"#/components/parameters/QueryLimit"},{"$ref":"#/components/parameters/QueryOffset"}],"responses":{"200":{"$ref":"#/components/responses/PagingSavedAudiobookObject"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":["user-library-read"]}],"summary":"Get User's Saved Audiobooks\n","tags":["Audiobooks","Library"],"x-spotify-docs-console-url":"/console/get-current-user-saved-audiobooks/?limit=1","x-spotify-docs-endpoint-name":"Get User's Saved Audiobooks"},"put":{"description":"Save one or more audiobooks to the current Spotify user's library.\n","operationId":"save-audiobooks-user","parameters":[{"$ref":"#/components/parameters/QueryAudiobookIds"}],"responses":{"200":{"description":"Audiobook(s) are saved to the library"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":["user-library-modify"]}],"summary":"Save Audiobooks for Current User\n","tags":["Audiobooks","Library"],"x-spotify-docs-console-url":"/console/put-current-user-saved-audiobooks/?ids=07bYtmE3bPsLB6ZbmmFi8d%2C48JYNjh7GMie6NjqYHMmtT%2C27cZdqrQiKt3IT00338dws","x-spotify-docs-endpoint-name":"Save Audiobooks for Current User"},"x-spotify-docs-category":"Library","x-spotify-docs-display-name":"current-user-saved-audiobooks"},"/me/audiobooks/contains":{"get":{"description":"Check if one or more audiobooks are already saved in the current Spotify user's library.\n","operationId":"check-users-saved-audiobooks","parameters":[{"$ref":"#/components/parameters/QueryAudiobookIds"}],"responses":{"200":{"$ref":"#/components/responses/ArrayOfBooleans"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":["user-library-read"]}],"summary":"Check User's Saved Audiobooks\n","tags":["Audiobooks","Library"],"x-spotify-docs-console-url":"/console/get-current-user-contains-saved-audiobooks/?ids=0pJJgBzj26qnE1nSQUxaB0%2C5ZAKzV4ZIa5Gt7z29OYHv0","x-spotify-docs-endpoint-name":"Check User's Saved Audiobooks"},"x-spotify-docs-category":"Library","x-spotify-docs-display-name":"current-user-contains-saved-audiobooks"},"/me/episodes":{"delete":{"description":"Remove one or more episodes from the current user's library.<br/>\nThis API endpoint is in __beta__ and could change without warning. Please share any feedback that you have, or issues that you discover, in our [developer community forum](https://community.spotify.com/t5/Spotify-for-Developers/bd-p/Spotify_Developer).\n","operationId":"remove-episodes-user","parameters":[{"$ref":"#/components/parameters/QueryTrackIds"}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"properties":{"ids":{"description":"A JSON array of the [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). <br/>A maximum of 50 items can be specified in one request. _**Note**: if the `ids` parameter is present in the query string, any IDs listed here in the body will be ignored._\n","items":{"type":"string"},"type":"array"}},"type":"object"}}}},"responses":{"200":{"description":"Episode removed"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":["user-library-modify"]}],"summary":"Remove User's Saved Episodes\n","tags":["Episodes","Library"],"x-spotify-docs-console-url":"/console/delete-current-user-saved-episodes/?ids=77o6BIVlYM3msb4MMIL1jH%2C0Q86acNRm6V9GYx55SXKwf","x-spotify-docs-endpoint-name":"Remove User's Saved Episodes"},"get":{"description":"Get a list of the episodes saved in the current Spotify user's library.<br/>\nThis API endpoint is in __beta__ and could change without warning. Please share any feedback that you have, or issues that you discover, in our [developer community forum](https://community.spotify.com/t5/Spotify-for-Developers/bd-p/Spotify_Developer).\n","operationId":"get-users-saved-episodes","parameters":[{"$ref":"#/components/parameters/QueryMarket"},{"$ref":"#/components/parameters/QueryLimit"},{"$ref":"#/components/parameters/QueryOffset"}],"responses":{"200":{"$ref":"#/components/responses/PagingSavedEpisodeObject"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":["user-library-read","user-read-playback-position"]}],"summary":"Get User's Saved Episodes\n","tags":["Episodes","Library"],"x-spotify-docs-console-url":"/console/get-current-user-saved-episodes/","x-spotify-docs-endpoint-name":"Get User's Saved Episodes"},"put":{"description":"Save one or more episodes to the current user's library.<br/>\nThis API endpoint is in __beta__ and could change without warning. Please share any feedback that you have, or issues that you discover, in our [developer community forum](https://community.spotify.com/t5/Spotify-for-Developers/bd-p/Spotify_Developer).\n","operationId":"save-episodes-user","parameters":[{"in":"query","name":"ids","required":true,"schema":{"description":"A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). Maximum: 50 IDs.\n","example":"77o6BIVlYM3msb4MMIL1jH,0Q86acNRm6V9GYx55SXKwf","title":"Spotify Episodes IDs","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"properties":{"ids":{"description":"A JSON array of the [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). <br/>A maximum of 50 items can be specified in one request. _**Note**: if the `ids` parameter is present in the query string, any IDs listed here in the body will be ignored._\n","items":{"type":"string"},"type":"array"}},"required":["ids"],"type":"object"}}}},"responses":{"200":{"description":"Episode saved"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":["user-library-modify"]}],"summary":"Save Episodes for Current User\n","tags":["Episodes","Library"],"x-spotify-docs-console-url":"/console/put-current-user-saved-episodes/?ids=77o6BIVlYM3msb4MMIL1jH%2C0Q86acNRm6V9GYx55SXKwf","x-spotify-docs-endpoint-name":"Save Episodes for Current User"},"x-spotify-docs-category":"Library","x-spotify-docs-display-name":"current-user-saved-episodes"},"/me/episodes/contains":{"get":{"description":"Check if one or more episodes is already saved in the current Spotify user's 'Your Episodes' library.<br/>\nThis API endpoint is in __beta__ and could change without warning. Please share any feedback that you have, or issues that you discover, in our [developer community forum](https://community.spotify.com/t5/Spotify-for-Developers/bd-p/Spotify_Developer)..\n","operationId":"check-users-saved-episodes","parameters":[{"in":"query","name":"ids","required":true,"schema":{"description":"A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids) for the episodes. Maximum: 50 IDs.\n","example":"77o6BIVlYM3msb4MMIL1jH,0Q86acNRm6V9GYx55SXKwf","title":"Spotify Episode IDs","type":"string"}}],"responses":{"200":{"$ref":"#/components/responses/ArrayOfBooleans"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":["user-library-read"]}],"summary":"Check User's Saved Episodes\n","tags":["Episodes","Library"],"x-spotify-docs-console-url":"/console/get-current-user-contains-saved-episodes/?ids=77o6BIVlYM3msb4MMIL1jH%2C0Q86acNRm6V9GYx55SXKwf","x-spotify-docs-endpoint-name":"Check User's Saved Episodes"},"x-spotify-docs-category":"Library","x-spotify-docs-display-name":"current-user-contains-saved-episodes"},"/me/following":{"delete":{"description":"Remove the current user as a follower of one or more artists or other Spotify users.\n","operationId":"unfollow-artists-users","parameters":[{"in":"query","name":"type","required":true,"schema":{"description":"The ID type: either `artist` or `user`.\n","enum":["artist","user"],"example":"artist","title":"Item Type","type":"string"}},{"in":"query","name":"ids","required":true,"schema":{"description":"A comma-separated list of the artist or the user [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). For example: `ids=74ASZWbe4lXaubB36ztrGX,08td7MxkoHQkXnWAYD8d6Q`. A maximum of 50 IDs can be sent in one request.\n","example":"2CIMQHirSU0MQqyYHq0eOx,57dN52uHvrHOxijzpIgu3E,1vCWHaC5f2uS3yhpwWbIA6","title":"Spotify IDs","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"properties":{"ids":{"description":"A JSON array of the artist or user [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). For example: `{ids:[\"74ASZWbe4lXaubB36ztrGX\", \"08td7MxkoHQkXnWAYD8d6Q\"]}`. A maximum of 50 IDs can be sent in one request. _**Note**: if the `ids` parameter is present in the query string, any IDs listed here in the body will be ignored._\n","items":{"type":"string"},"type":"array"}},"type":"object"}}}},"responses":{"200":{"description":"Artist or user unfollowed"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":["user-follow-modify"]}],"summary":"Unfollow Artists or Users\n","tags":["Users","Artists","Library"],"x-spotify-docs-console-url":"/console/delete-following/?type=user&ids=exampleuser01","x-spotify-docs-endpoint-name":"Unfollow Artists or Users"},"get":{"description":"Get the current user's followed artists.\n","operationId":"get-followed","parameters":[{"in":"query","name":"type","required":true,"schema":{"description":"The ID type: currently only `artist` is supported.\n","enum":["artist"],"example":"artist","title":"Item Type","type":"string"}},{"in":"query","name":"after","required":false,"schema":{"description":"The last artist ID retrieved from the previous request.\n","example":"0I2XqVXqHScXjHhk6AYYRe","title":"After","type":"string"}},{"$ref":"#/components/parameters/QueryLimit"}],"responses":{"200":{"$ref":"#/components/responses/CursorPagedArtists"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":["user-follow-read"]}],"summary":"Get Followed Artists\n","tags":["Users","Library","Artists"],"x-spotify-docs-console-url":"/console/get-following/?type=artist&limit=20","x-spotify-docs-endpoint-name":"Get User's Followed Artists"},"put":{"description":"Add the current user as a follower of one or more artists or other Spotify users.\n","operationId":"follow-artists-users","parameters":[{"in":"query","name":"type","required":true,"schema":{"description":"The ID type.\n","enum":["artist","user"],"example":"artist","title":"Item Type","type":"string"}},{"in":"query","name":"ids","required":true,"schema":{"description":"A comma-separated list of the artist or the user [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids).\nA maximum of 50 IDs can be sent in one request.\n","example":"2CIMQHirSU0MQqyYHq0eOx,57dN52uHvrHOxijzpIgu3E,1vCWHaC5f2uS3yhpwWbIA6","title":"Spotify IDs","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"properties":{"ids":{"description":"A JSON array of the artist or user [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids).\nFor example: `{ids:[\"74ASZWbe4lXaubB36ztrGX\", \"08td7MxkoHQkXnWAYD8d6Q\"]}`. A maximum of 50 IDs can be sent in one request. _**Note**: if the `ids` parameter is present in the query string, any IDs listed here in the body will be ignored._\n","items":{"type":"string"},"type":"array"}},"required":["ids"],"type":"object"}}}},"responses":{"204":{"description":"Artist or user followed"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":["user-follow-modify"]}],"summary":"Follow Artists or Users\n","tags":["Users","Artists","Library"],"x-spotify-docs-console-url":"/console/put-following/?type=user&ids=exampleuser01","x-spotify-docs-endpoint-name":"Follow Artists or Users"},"x-spotify-docs-category":"Follow","x-spotify-docs-display-name":"following"},"/me/following/contains":{"get":{"description":"Check to see if the current user is following one or more artists or other Spotify users.\n","operationId":"check-current-user-follows","parameters":[{"in":"query","name":"type","required":true,"schema":{"description":"The ID type: either `artist` or `user`.\n","enum":["artist","user"],"example":"artist","title":"Item Type","type":"string"}},{"in":"query","name":"ids","required":true,"schema":{"description":"A comma-separated list of the artist or the user [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids) to check. For example: `ids=74ASZWbe4lXaubB36ztrGX,08td7MxkoHQkXnWAYD8d6Q`. A maximum of 50 IDs can be sent in one request.\n","example":"2CIMQHirSU0MQqyYHq0eOx,57dN52uHvrHOxijzpIgu3E,1vCWHaC5f2uS3yhpwWbIA6","title":"Spotify IDs","type":"string"}}],"responses":{"200":{"$ref":"#/components/responses/ArrayOfBooleans"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":["user-follow-read"]}],"summary":"Check If User Follows Artists or Users\n","tags":["Users","Artists","Library"],"x-spotify-docs-console-url":"/console/get-following-contains/?type=user&ids=exampleuser01","x-spotify-docs-endpoint-name":"Get Following State for Artists/Users"},"x-spotify-docs-category":"Follow","x-spotify-docs-display-name":"following-contains"},"/me/player":{"get":{"description":"Get information about the user’s current playback state, including track or episode, progress, and active device.\n","operationId":"get-information-about-the-users-current-playback","parameters":[{"$ref":"#/components/parameters/QueryMarket"},{"$ref":"#/components/parameters/QueryAdditionalTypes"}],"responses":{"200":{"$ref":"#/components/responses/OneCurrentlyPlaying"},"204":{"description":"Playback not available or active"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"security":[{"oauth_2_0":["user-read-playback-state"]}],"summary":"Get Playback State\n","tags":["Player"],"x-spotify-docs-console-url":"/console/get-user-player/","x-spotify-docs-endpoint-name":"Get Information About The User's Current Playback"},"put":{"description":"Transfer playback t