{"openapi":"3.2.0","info":{"title":"Spotify API","description":"Spotify Data API for Millions of songs & podcasts, artists, albums, playlists and more.","version":"1.0.0"},"servers":[{"url":"https://spotify.jojapi.net"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"Explore"},{"name":"Albums"},{"name":"Artists"},{"name":"Tracks"},{"name":"Playlists"},{"name":"Users"},{"name":"Genres"},{"name":"Concerts"},{"name":"Extras"},{"name":"Podcasts"},{"name":"Episodes"},{"name":"Deprecated Endpoints (v1)"}],"paths":{"/v1.1/browse_all/":{"get":{"operationId":"get_v1_1_browse_all","summary":"Explore","tags":["Explore"]}},"/v1.1/search/":{"get":{"operationId":"get_v1_1_search","summary":"Search","tags":["Explore"],"parameters":[{"name":"q","in":"query","description":"Search query","required":false,"schema":{"type":"string","title":"q"}},{"name":"type","in":"query","description":"`multi` or one of these:\n\n- albums\n- artists\n- episodes\n- genres\n- playlists\n- podcasts\n- tracks\n- users","required":false,"schema":{"type":"string","title":"type","example":"multi"}},{"name":"offset","in":"query","required":false,"schema":{"type":"string","title":"offset","example":"0"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","title":"limit","example":"10"}},{"name":"numberOfTopResults","in":"query","required":false,"schema":{"type":"string","title":"numberOfTopResults","example":"5"}},{"name":"gl","in":"query","required":false,"schema":{"type":"string","title":"gl"}}]}},"/v2/album/detailsAndTracks":{"get":{"operationId":"get_v2_album_detailsAndTracks","summary":"v2/Album details & tracks","tags":["Albums"],"parameters":[{"name":"albumId","in":"query","required":false,"schema":{"type":"string","title":"Spotify Album ID or URI","example":"3IBcauSj5M2A6lTeffJzdv"}},{"name":"offset","in":"query","required":false,"schema":{"type":"string","title":"Tracks offset","example":"0"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","title":"Tracks limit","example":"50"}}]}},"/v2/album/metadata":{"get":{"operationId":"get_v2_album_metadata","summary":"v2/Album metadata","tags":["Albums"],"parameters":[{"name":"albumId","in":"query","required":false,"schema":{"type":"string","title":"Spotify Album ID or URI","example":"3IBcauSj5M2A6lTeffJzdv"}}]}},"/v1.1/album_tracks/":{"get":{"operationId":"get_v1_1_album_tracks","summary":"Album tracks","tags":["Albums"],"parameters":[{"name":"id","in":"query","description":"Album ID","required":false,"schema":{"type":"string","title":"id","example":"3IBcauSj5M2A6lTeffJzdv"}},{"name":"offset","in":"query","required":false,"schema":{"type":"string","title":"offset","example":"0"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","title":"limit","example":"300"}}]}},"/v1.1/album_metadata/":{"get":{"operationId":"get_v1_1_album_metadata","summary":"Album metadata","description":"Get album metadata","tags":["Albums"],"parameters":[{"name":"id","in":"query","description":"Album ID","required":false,"schema":{"type":"string","title":"id","example":"3IBcauSj5M2A6lTeffJzdv"}}]}},"/v1.1/albums/":{"get":{"operationId":"get_v1_1_albums","summary":"Get albums","description":"Get one or more albums","tags":["Albums"],"parameters":[{"name":"ids","in":"query","description":"Album IDs (you can use commas)","required":false,"schema":{"type":"string","title":"ids","example":"3IBcauSj5M2A6lTeffJzdv"}}]}},"/v2/artist/overview":{"get":{"operationId":"get_v2_artist_overview","summary":"v2/Artist overview","tags":["Artists"],"parameters":[{"name":"artistId","in":"query","required":false,"schema":{"type":"string","title":"Spotify Artist ID or URI","example":"2w9zwq3AktTeYYMuhMjju8"}}]}},"/v2/artist/concerts":{"get":{"operationId":"get_v2_artist_concerts","summary":"v2/Artist concerts","tags":["Artists"],"parameters":[{"name":"artistId","in":"query","required":false,"schema":{"type":"string","title":"Spotify Artist ID or URI","example":"2w9zwq3AktTeYYMuhMjju8"}}]}},"/v2/artist/fansFirstPresales":{"get":{"operationId":"get_v2_artist_fansFirstPresales","summary":"v2/Artist fans-first presales","tags":["Artists"],"parameters":[{"name":"artistId","in":"query","required":false,"schema":{"type":"string","title":"Spotify Artist ID or URI","example":"2w9zwq3AktTeYYMuhMjju8"}}]}},"/v1.1/artist_related/":{"get":{"operationId":"get_v1_1_artist_related","summary":"Artist related","tags":["Artists"],"parameters":[{"name":"id","in":"query","description":"Artist ID","required":false,"schema":{"type":"string","title":"id","example":"2w9zwq3AktTeYYMuhMjju8"}}]}},"/v1.1/artist_featuring/":{"get":{"operationId":"get_v1_1_artist_featuring","summary":"Artist featuring","tags":["Artists"],"parameters":[{"name":"id","in":"query","description":"Artist ID","required":false,"schema":{"type":"string","title":"id","example":"2w9zwq3AktTeYYMuhMjju8"}}]}},"/v1.1/artist_discovered_on/":{"get":{"operationId":"get_v1_1_artist_discovered_on","summary":"Artist discovered on","tags":["Artists"],"parameters":[{"name":"id","in":"query","description":"Artist ID","required":false,"schema":{"type":"string","title":"id","example":"2w9zwq3AktTeYYMuhMjju8"}}]}},"/v1.1/artist_appears_on/":{"get":{"operationId":"get_v1_1_artist_appears_on","summary":"Artist appears on","tags":["Artists"],"parameters":[{"name":"id","in":"query","description":"Artist ID","required":false,"schema":{"type":"string","title":"id","example":"2w9zwq3AktTeYYMuhMjju8"}}]}},"/v1.1/artist_singles/":{"get":{"operationId":"get_v1_1_artist_singles","summary":"Artist singles","tags":["Artists"],"parameters":[{"name":"id","in":"query","description":"Artist ID","required":false,"schema":{"type":"string","title":"id","example":"2w9zwq3AktTeYYMuhMjju8"}},{"name":"offset","in":"query","required":false,"schema":{"type":"string","title":"offset","example":"0"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","title":"limit","example":"20"}}]}},"/v1.1/artist_albums/":{"get":{"operationId":"get_v1_1_artist_albums","summary":"Artist albums","tags":["Artists"],"parameters":[{"name":"id","in":"query","description":"Artist ID","required":false,"schema":{"type":"string","title":"id","example":"2w9zwq3AktTeYYMuhMjju8"}},{"name":"offset","in":"query","required":false,"schema":{"type":"string","title":"offset","example":"0"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","title":"limit","example":"100"}}]}},"/v1.1/artist_discography_overview/":{"get":{"operationId":"get_v1_1_artist_discography_overview","summary":"Artist discography overview","tags":["Artists"],"parameters":[{"name":"id","in":"query","description":"Artist ID","required":false,"schema":{"type":"string","title":"id","example":"2w9zwq3AktTeYYMuhMjju8"}}]}},"/v1.1/artist_overview/":{"get":{"operationId":"get_v1_1_artist_overview","summary":"Artist overview","tags":["Artists"],"parameters":[{"name":"id","in":"query","description":"Artist ID","required":false,"schema":{"type":"string","title":"id","example":"2w9zwq3AktTeYYMuhMjju8"}}]}},"/v1.1/artists/":{"get":{"operationId":"get_v1_1_artists","summary":"Artists","tags":["Artists"],"parameters":[{"name":"ids","in":"query","description":"Artist IDs (you can use commas)","required":false,"schema":{"type":"string","title":"ids","example":"2w9zwq3AktTeYYMuhMjju8"}}]}},"/v2/track/details":{"get":{"operationId":"get_v2_track_details","summary":"v2/Track details","tags":["Tracks"],"parameters":[{"name":"trackId","in":"query","required":false,"schema":{"type":"string","title":"Spotify Track ID or URI","example":"4WNcduiCmDNfmTEz7JvmLv"}}]}},"/v2/track/metadata":{"get":{"operationId":"get_v2_track_metadata","summary":"v2/Track metadata","tags":["Tracks"],"parameters":[{"name":"trackId","in":"query","required":false,"schema":{"type":"string","title":"Spotify Track ID or URI","example":"4WNcduiCmDNfmTEz7JvmLv"}}]}},"/v1.1/track_lyrics/":{"get":{"operationId":"get_v1_1_track_lyrics","summary":"Track lyrics","tags":["Tracks"],"parameters":[{"name":"id","in":"query","description":"Track ID","required":false,"schema":{"type":"string","title":"id","example":"4snRyiaLyvTMui0hzp8MF7"}}]}},"/v1.1/track_credits/":{"get":{"operationId":"get_v1_1_track_credits","summary":"Track credits","tags":["Tracks"],"parameters":[{"name":"id","in":"query","description":"Track ID","required":false,"schema":{"type":"string","title":"id","example":"4WNcduiCmDNfmTEz7JvmLv"}}]}},"/v2/playlist/detailsAndItems":{"get":{"operationId":"get_v2_playlist_detailsAndItems","summary":"v2/Playlist details & items","tags":["Playlists"],"parameters":[{"name":"playlistId","in":"query","required":false,"schema":{"type":"string","title":"Spotify Playlist ID or URI","example":"37i9dQZF1DX4Wsb4d7NKfP"}},{"name":"offset","in":"query","required":false,"schema":{"type":"string","title":"Items offset","example":"0"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","title":"Items limit","example":"25"}}]}},"/v1.1/user_followers/":{"get":{"operationId":"get_v1_1_user_followers","summary":"User followers","tags":["Users"],"parameters":[{"name":"id","in":"query","description":"User ID","required":false,"schema":{"type":"string","title":"id","example":"nocopyrightsounds"}}]}},"/v1.1/user_profile/":{"get":{"operationId":"get_v1_1_user_profile","summary":"User profile","tags":["Users"],"parameters":[{"name":"id","in":"query","description":"User ID","required":false,"schema":{"type":"string","title":"id","example":"nocopyrightsounds"}},{"name":"playlistLimit","in":"query","required":false,"schema":{"type":"string","title":"playlistLimit","example":"10"}},{"name":"artistLimit","in":"query","required":false,"schema":{"type":"string","title":"artistLimit","example":"10"}}]}},"/v1.1/genre_view/":{"get":{"operationId":"get_v1_1_genre_view","summary":"Genre View","tags":["Genres"],"parameters":[{"name":"id","in":"query","description":"Genre ID","required":false,"schema":{"type":"string","title":"id","example":"0JQ5DAqbMKFEC4WFtoNRpw"}},{"name":"content_limit","in":"query","required":false,"schema":{"type":"string","title":"content_limit","example":"10"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","title":"limit","example":"20"}}]}},"/v1.1/concert/":{"get":{"operationId":"get_v1_1_concert","summary":"Get Concert","tags":["Concerts"],"parameters":[{"name":"id","in":"query","description":"Concert ID","required":false,"schema":{"type":"string","title":"id","example":"6PodeS6Nvq7AwacfxsxHKT"}}]}},"/v1.1/concerts/":{"get":{"operationId":"get_v1_1_concerts","summary":"Concerts","tags":["Concerts"],"parameters":[{"name":"gl","in":"query","required":false,"schema":{"type":"string","title":"gl","example":"US"}}]}},"/v1.1/seed_to_playlist/":{"get":{"operationId":"get_v1_1_seed_to_playlist","summary":"Get radio playlist","tags":["Extras"],"parameters":[{"name":"uri","in":"query","description":"Artist or song URI","required":false,"schema":{"type":"string","title":"uri","example":"spotify:artist:2w9zwq3AktTeYYMuhMjju8"}}]}},"/v1.1/podcast_episodes/":{"get":{"operationId":"get_v1_1_podcast_episodes","summary":"Podcast Episodes","tags":["Podcasts"],"parameters":[{"name":"id","in":"query","description":"Podcast Show ID","required":false,"schema":{"type":"string","title":"id","example":"0ofXAdFIQQRsCYj9754UFx"}},{"name":"offset","in":"query","required":false,"schema":{"type":"string","title":"offset","example":"0"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","title":"limit","example":"50"}}]}},"/v1.1/episode_sound/":{"get":{"operationId":"get_v1_1_episode_sound","summary":"Episode Sound","tags":["Episodes"],"parameters":[{"name":"id","in":"query","description":"Episode ID","required":false,"schema":{"type":"string","title":"id","example":"55EWbmkVr8iDNmSyperh9o"}}]}},"/v1.1/episode/":{"get":{"operationId":"get_v1_1_episode","summary":"Get Episode","tags":["Episodes"],"parameters":[{"name":"id","in":"query","description":"Episode ID","required":false,"schema":{"type":"string","title":"id","example":"55EWbmkVr8iDNmSyperh9o"}}]}},"/v1.1/tracks/":{"get":{"operationId":"get_v1_1_tracks","summary":"Get tracks","tags":["Deprecated Endpoints (v1)"],"parameters":[{"name":"ids","in":"query","description":"Track IDs (you can use commas)","required":false,"schema":{"type":"string","title":"ids","example":"4WNcduiCmDNfmTEz7JvmLv"}}]}},"/v1.1/playlist_tracks/":{"get":{"operationId":"get_v1_1_playlist_tracks","summary":"Playlist tracks","tags":["Deprecated Endpoints (v1)"],"parameters":[{"name":"id","in":"query","description":"Playlist ID","required":false,"schema":{"type":"string","title":"id","example":"37i9dQZF1DX4Wsb4d7NKfP"}},{"name":"offset","in":"query","required":false,"schema":{"type":"string","title":"offset","example":"0"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","title":"limit","example":"100"}}]}},"/v1.1/playlist/":{"get":{"operationId":"get_v1_1_playlist","summary":"Get playlist","tags":["Deprecated Endpoints (v1)"],"parameters":[{"name":"id","in":"query","description":"Playlist ID","required":false,"schema":{"type":"string","title":"id","example":"37i9dQZF1DX4Wsb4d7NKfP"}}]}},"/v1.1/recommendations/":{"get":{"operationId":"get_v1_1_recommendations","summary":"Track recommendations","tags":["Deprecated Endpoints (v1)"],"parameters":[{"name":"limit","in":"query","description":"The target size of the list of recommended tracks.\nDefault: 20. Minimum: 1. Maximum: 100.","required":false,"schema":{"type":"string","title":"limit","example":"20"}},{"name":"seed_tracks","in":"query","description":"A comma separated list of Spotify IDs for a seed track.\n\nUp to 5 seed values may be provided in any combination of seed_artists, seed_tracks and seed_genres.","required":false,"schema":{"type":"string","title":"seed_tracks","example":"0c6xIDDpzE81m2q797ordA"}},{"name":"seed_artists","in":"query","description":"A comma separated list of Spotify IDs for seed artists.","required":false,"schema":{"type":"string","title":"seed_artists","example":"4NHQUGzhtTLFvgF5SZesLK"}},{"name":"seed_genres","in":"query","description":"A comma separated list of any genres in the set of available genre seeds.","required":false,"schema":{"type":"string","title":"seed_genres","example":"classical,country"}}]}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-JoJAPI-Key","description":"Your JoJ API key."}}}}