{"openapi":"3.1.0","info":{"version":"2.0.0","title":"Groovia API","description":"The music API behind Groovia. Songs, albums, artists and playlists, search, synced lyrics,\ncharts, new releases, moods, radio stations and recommendations for Indian music, as JSON.\n\nEvery list comes back in one `MediaItem` shape, songs come back ready to play in five qualities up to 320 kbps,\nand `language` takes a comma-separated list such as `hindi,punjabi`.\n\n**Limits.** One address may make 240 requests a minute; past that the API answers `429` with `Retry-After`.\nAnswers are cached for five minutes."},"servers":[{"url":"https://api.groovia.me","description":"Current environment"}],"components":{"schemas":{},"parameters":{}},"paths":{"/api/search":{"get":{"tags":["Search"],"summary":"Global search","description":"Search for songs, albums, artists, and playlists based on the provided query string.","operationId":"globalSearch","parameters":[{"schema":{"type":"string","description":"Search query","title":"Search query","example":"Imagine Dragons"},"required":true,"name":"query","in":"query"}],"responses":{"200":{"description":"Successful global search","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indicates whether the search was successful","example":true},"data":{"type":"object","properties":{"albums":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"artist":{"type":"string"},"url":{"type":"string"},"type":{"type":"string"},"description":{"type":"string"},"year":{"type":"string"},"language":{"type":"string"},"songIds":{"type":"string"}},"required":["id","title","image","artist","url","type","description","year","language","songIds"]}},"position":{"type":"number"}},"required":["results","position"]},"songs":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"album":{"type":"string"},"url":{"type":"string"},"type":{"type":"string"},"description":{"type":"string"},"primaryArtists":{"type":"string"},"singers":{"type":"string"},"language":{"type":"string"}},"required":["id","title","image","album","url","type","description","primaryArtists","singers","language"]}},"position":{"type":"number"}},"required":["results","position"]},"artists":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"type":{"type":"string"},"description":{"type":"string"},"position":{"type":"number"}},"required":["id","title","image","type","description","position"]}},"position":{"type":"number"}},"required":["results","position"]},"playlists":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"},"language":{"type":"string"},"type":{"type":"string"},"description":{"type":"string"}},"required":["id","title","image","url","language","type","description"]}},"position":{"type":"number"}},"required":["results","position"]},"topQuery":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"album":{"type":"string"},"url":{"type":"string"},"type":{"type":"string"},"description":{"type":"string"},"primaryArtists":{"type":"string"},"singers":{"type":"string"},"language":{"type":"string"}},"required":["id","title","image","album","url","type","description","primaryArtists","singers","language"]}},"position":{"type":"number"}},"required":["results","position"]}},"required":["albums","songs","artists","playlists","topQuery"],"description":"Search results including songs, albums, artists, and playlists"}},"required":["success","data"]}}}}}}},"/api/search/songs":{"get":{"tags":["Search"],"summary":"Search for songs","description":"Search for songs based on the provided query","operationId":"searchSongs","parameters":[{"schema":{"type":"string","description":"Search query for songs","title":"Search query","example":"Believer"},"required":true,"name":"query","in":"query"},{"schema":{"type":"integer","description":"The page number of the search results to retrieve","title":"Page Number","example":"0","default":"0"},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","description":"Number of search results per page","title":"Limit","example":"10","default":"10"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Successful response with song search results","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indicates whether the song search was successful","example":true},"data":{"type":"object","properties":{"total":{"type":"number"},"start":{"type":"number"},"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"]}}},"required":["total","start","results"],"description":"Search results for songs"}},"required":["success","data"]}}}}}}},"/api/search/albums":{"get":{"tags":["Search"],"summary":"Search for albums","description":"Search for albums based on the provided query","operationId":"searchAlbums","parameters":[{"schema":{"type":"string","description":"Search query for albums","example":"Evolve"},"required":true,"name":"query","in":"query"},{"schema":{"type":"integer","description":"The page number of the search results to retrieve","example":"0","default":"0"},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","description":"The number of search results per page","example":"10","default":"10"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Successful response with album search results","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indicates whether the album search was successful","example":true},"data":{"type":"object","properties":{"total":{"type":"number"},"start":{"type":"number"},"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"year":{"type":["number","null"]},"type":{"type":"string"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"explicitContent":{"type":"boolean"},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"url":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","description","year","type","playCount","language","explicitContent","artists","url","image"]}}},"required":["total","start","results"],"description":"Search results for albums"}},"required":["success","data"]}}}}}}},"/api/search/artists":{"get":{"tags":["Search"],"summary":"Search for artists","description":"Search for artists based on the provided query","operationId":"searchArtists","parameters":[{"schema":{"type":"string","description":"Search query for artists","title":"Search query","example":"Adele"},"required":true,"name":"query","in":"query"},{"schema":{"type":"integer","description":"The page number of the search results to retrieve","title":"Page Number","example":"0","default":"0"},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","description":"Number of search results per page","title":"Limit","example":"10","default":"10"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Successful response with artist search results","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indicates whether the artist search was successful","example":true},"data":{"type":"object","properties":{"total":{"type":"number"},"start":{"type":"number"},"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["total","start","results"],"description":"Search results for artists"}},"required":["success","data"]}}}}}}},"/api/search/playlists":{"get":{"tags":["Search"],"summary":"Search for playlists","description":"Search for playlists based on the provided query","operationId":"searchPlaylists","parameters":[{"schema":{"type":"string","description":"Search query for playlists","title":"Search query","example":"Indie"},"required":true,"name":"query","in":"query"},{"schema":{"type":"integer","description":"The page number of the search results to retrieve","title":"Page Number","example":"0","default":"0"},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","description":"Number of search results per page","title":"Limit","example":"10","default":"10"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Successful response with playlist search results","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indicates whether the playlist search was successful","example":true},"data":{"type":"object","properties":{"total":{"type":"number"},"start":{"type":"number"},"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"},"songCount":{"type":["number","null"]},"language":{"type":"string"},"explicitContent":{"type":"boolean"}},"required":["id","name","type","image","url","songCount","language","explicitContent"]}}},"required":["total","start","results"],"description":"Search results for playlist"}},"required":["success","data"]}}}}}}},"/api/songs":{"get":{"tags":["Songs"],"summary":"Retrieve songs by ID or link","description":"Retrieve songs by a comma-separated list of IDs or by the song's share link.","operationId":"getSongByIdsOrLink","parameters":[{"schema":{"type":"string","description":"Comma-separated list of song IDs","title":"Song IDs","example":"3IoDK8qI,4IoDK8qI,5IoDK8qI"},"required":false,"name":"ids","in":"query"},{"schema":{"type":"string","description":"The song's share link","title":"Song Link"},"required":false,"name":"link","in":"query"}],"responses":{"200":{"description":"Successful response with song details","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indicates whether the request was successful","example":true},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"]},"description":"Array of song details","title":"Song Details"}},"required":["success","data"]}}}},"400":{"description":"Bad request when query parameters are missing or invalid"},"404":{"description":"Song not found with the given ID or link"}}}},"/api/songs/{id}":{"get":{"tags":["Songs"],"summary":"Retrieve song by ID","description":"Retrieve a song by its ID. Optionally, include lyrics in the response.","operationId":"getSongById","parameters":[{"schema":{"type":"string","description":"ID of the song to retrieve","title":"Song ID","example":"3IoDK8qI"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Successful response with song details","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indicates whether the request was successful","example":true},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"]},"description":"Array of songs"}},"required":["success","data"]}}}},"400":{"description":"Bad request when query parameters are missing or invalid"},"404":{"description":"Song not found for the given ID"}}}},"/api/songs/{id}/suggestions":{"get":{"tags":["Songs"],"summary":"Retrieve song suggestions","description":"Retrieve song suggestions based on the given song ID. This can be used to get similar songs to the one provided for infinite playback.","operationId":"getSongSuggestions","parameters":[{"schema":{"type":"string","description":"ID of the song to retrieve suggestions for","example":"yDeAS8Eh"},"required":true,"name":"id","in":"path"},{"schema":{"type":"number","description":"Limit the number of suggestions to retrieve","title":"Limit","example":"10","default":"10"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Successful response with song suggestions","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indicates whether the request was successful","example":true},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"]},"description":"Array of song suggestions"}},"required":["success","data"]}}}}}}},"/api/songs/{id}/lyrics":{"get":{"tags":["Songs"],"summary":"Song lyrics","description":"Time-synced lyrics (seconds per line) where available, plain lyrics otherwise.","operationId":"getSongLyrics","parameters":[{"schema":{"type":"string","example":"rjkrTnma"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"source":{"type":"string","enum":["catalog","community"]},"synced":{"type":["array","null"],"items":{"type":"object","properties":{"time":{"type":"number"},"text":{"type":"string"}},"required":["time","text"]}},"plain":{"type":["string","null"]},"copyright":{"type":["string","null"]}},"required":["source","synced","plain","copyright"]}},"required":["success","data"]}}}},"400":{"description":"Bad request when query parameters are missing or invalid"},"404":{"description":"Nothing found for the given input"},"502":{"description":"The music catalogue did not answer"}}}},"/api/albums":{"get":{"tags":["Album"],"summary":"Retrieve an album by ID or link","description":"Retrieve an album by providing either an ID or its share link.","operationId":"getAlbumByIdOrLink","parameters":[{"schema":{"type":"string","description":"The unique ID of the album","title":"Album ID","example":"23241654","default":"23241654"},"required":false,"name":"id","in":"query"},{"schema":{"type":"string","description":"The album's share link","title":"Album Link"},"required":false,"name":"link","in":"query"}],"responses":{"200":{"description":"Successful response with album details","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indicates the success status of the request.","example":true},"data":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"year":{"type":["number","null"]},"type":{"type":"string"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"explicitContent":{"type":"boolean"},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"songCount":{"type":["number","null"]},"url":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"songs":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"]}}},"required":["id","name","description","year","type","playCount","language","explicitContent","artists","songCount","url","image","songs"],"description":"The detailed information of the album.","title":"Album Details"}},"required":["success","data"]}}}},"400":{"description":"Bad request due to missing or invalid query parameters."},"404":{"description":"The album could not be found with the provided ID or link."}}}},"/api/artists":{"get":{"tags":["Artists"],"summary":"Retrieve artists by ID or link","description":"Retrieve artists by ID or by a direct artist link.","operationId":"getArtistByIdOrLink","parameters":[{"schema":{"type":"string","description":"Artist ID","title":"Artist ID","example":"1274170"},"required":false,"name":"id","in":"query"},{"schema":{"type":"string","description":"The artist's share link","title":"Artist Link"},"required":false,"name":"link","in":"query"},{"schema":{"type":"number","description":"page number","title":"Page number","example":"1"},"required":false,"name":"page","in":"query"},{"schema":{"type":"number","description":"Number of songs to fetch","title":"Song count","example":"10"},"required":false,"name":"songCount","in":"query"},{"schema":{"type":"number","description":"Number of albums to fetch","title":"Album count","example":"10"},"required":false,"name":"albumCount","in":"query"},{"schema":{"type":"string","description":"sort by","title":"Sort by","example":"popularity"},"required":false,"name":"sortBy","in":"query"},{"schema":{"type":"string","description":"sort order","title":"Sort order","example":"desc","default":"desc"},"required":false,"name":"sortOrder","in":"query"}],"responses":{"200":{"description":"Successful response with artist details","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indicates whether the request was successful","example":true},"data":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"followerCount":{"type":["number","null"]},"fanCount":{"type":["string","null"]},"isVerified":{"type":["boolean","null"]},"dominantLanguage":{"type":["string","null"]},"dominantType":{"type":["string","null"]},"bio":{"type":["array","null"],"items":{"type":"object","properties":{"text":{"type":["string","null"]},"title":{"type":["string","null"]},"sequence":{"type":["number","null"]}},"required":["text","title","sequence"]}},"dob":{"type":["string","null"]},"fb":{"type":["string","null"]},"twitter":{"type":["string","null"]},"wiki":{"type":["string","null"]},"availableLanguages":{"type":"array","items":{"type":"string"}},"isRadioPresent":{"type":["boolean","null"]},"topSongs":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"]}},"topAlbums":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"year":{"type":["number","null"]},"type":{"type":"string"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"explicitContent":{"type":"boolean"},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"songCount":{"type":["number","null"]},"url":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"songs":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"]}}},"required":["id","name","description","year","type","playCount","language","explicitContent","artists","songCount","url","image","songs"]}},"singles":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"]}},"similarArtists":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"languages":{"type":["object","null"],"additionalProperties":{"type":"string"}},"wiki":{"type":"string"},"dob":{"type":"string"},"fb":{"type":"string"},"twitter":{"type":"string"},"isRadioPresent":{"type":"boolean"},"type":{"type":"string"},"dominantType":{"type":"string"},"aka":{"type":"string"},"bio":{"type":["string","null"]},"similarArtists":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]}}},"required":["id","name","url","image","languages","wiki","dob","fb","twitter","isRadioPresent","type","dominantType","aka","bio","similarArtists"]}}},"required":["id","name","url","type","image","followerCount","fanCount","isVerified","dominantLanguage","dominantType","bio","dob","fb","twitter","wiki","availableLanguages","isRadioPresent","topSongs","topAlbums","singles","similarArtists"],"description":"Artist details"}},"required":["success","data"]}}}}}}},"/api/artists/{id}":{"get":{"tags":["Artists"],"summary":"Retrieve artist by ID","description":"Retrieve artist by ID","operationId":"getArtistById","parameters":[{"schema":{"type":"string","description":"ID of the artist to retrieve","title":"Artist ID","example":"1274170"},"required":true,"name":"id","in":"path"},{"schema":{"type":"integer","description":"The page number of the results to retrieve","title":"Page number","example":"0"},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","description":"The number of songs to retrieve for the artist","title":"Song count","example":"10"},"required":false,"name":"songCount","in":"query"},{"schema":{"type":"integer","description":"The number of albums to retrieve for the artist","title":"Album count","example":"10"},"required":false,"name":"albumCount","in":"query"},{"schema":{"type":"string","description":"The field to sort the results by","title":"Sort by","example":"popularity","enum":["popularity","latest","alphabetical"]},"required":false,"name":"sortBy","in":"query"},{"schema":{"type":"string","description":"The order to sort the results by","title":"Sort order","example":"desc","enum":["asc","desc"]},"required":false,"name":"sortOrder","in":"query"}],"responses":{"200":{"description":"Successful response with artist details","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indicates whether the request was successful","example":true},"data":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"followerCount":{"type":["number","null"]},"fanCount":{"type":["string","null"]},"isVerified":{"type":["boolean","null"]},"dominantLanguage":{"type":["string","null"]},"dominantType":{"type":["string","null"]},"bio":{"type":["array","null"],"items":{"type":"object","properties":{"text":{"type":["string","null"]},"title":{"type":["string","null"]},"sequence":{"type":["number","null"]}},"required":["text","title","sequence"]}},"dob":{"type":["string","null"]},"fb":{"type":["string","null"]},"twitter":{"type":["string","null"]},"wiki":{"type":["string","null"]},"availableLanguages":{"type":"array","items":{"type":"string"}},"isRadioPresent":{"type":["boolean","null"]},"topSongs":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"]}},"topAlbums":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"year":{"type":["number","null"]},"type":{"type":"string"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"explicitContent":{"type":"boolean"},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"songCount":{"type":["number","null"]},"url":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"songs":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"]}}},"required":["id","name","description","year","type","playCount","language","explicitContent","artists","songCount","url","image","songs"]}},"singles":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"]}},"similarArtists":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"languages":{"type":["object","null"],"additionalProperties":{"type":"string"}},"wiki":{"type":"string"},"dob":{"type":"string"},"fb":{"type":"string"},"twitter":{"type":"string"},"isRadioPresent":{"type":"boolean"},"type":{"type":"string"},"dominantType":{"type":"string"},"aka":{"type":"string"},"bio":{"type":["string","null"]},"similarArtists":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]}}},"required":["id","name","url","image","languages","wiki","dob","fb","twitter","isRadioPresent","type","dominantType","aka","bio","similarArtists"]}}},"required":["id","name","url","type","image","followerCount","fanCount","isVerified","dominantLanguage","dominantType","bio","dob","fb","twitter","wiki","availableLanguages","isRadioPresent","topSongs","topAlbums","singles","similarArtists"]}},"required":["success","data"]}}}},"404":{"description":"Artist not found for the given ID"}}}},"/api/artists/{id}/songs":{"get":{"tags":["Artists"],"summary":"Retrieve artist's songs","description":"Retrieve a list of songs for a given artist by their ID, with optional sorting and pagination.","operationId":"getArtistSongs","parameters":[{"schema":{"type":"string","description":"ID of the artist to retrieve the songs for","example":"1274170","default":"1274170"},"required":true,"name":"id","in":"path"},{"schema":{"type":"number","description":"The page number of the results to retrieve","example":"0","default":"0"},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","description":"The criterion to sort the songs by","example":"popularity","enum":["popularity","latest","alphabetical"],"default":"popularity"},"required":false,"name":"sortBy","in":"query"},{"schema":{"type":"string","description":"The order to sort the songs","example":"desc","enum":["asc","desc"],"default":"desc"},"required":false,"name":"sortOrder","in":"query"}],"responses":{"200":{"description":"Successful response with a list of songs for the artist","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indicates whether the request was successful","example":true},"data":{"type":"object","properties":{"total":{"type":"number"},"songs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"]}}},"required":["total","songs"],"description":"An array of songs associated with the artist"}},"required":["success","data"]}}}},"404":{"description":"Artist not found for the given ID"}}}},"/api/artists/{id}/albums":{"get":{"tags":["Artists"],"summary":"Retrieve artist's albums","description":"Retrieve a list of albums for a given artist by their ID, with optional sorting and pagination.","operationId":"getArtistAlbums","parameters":[{"schema":{"type":"string","description":"ID of the artist to retrieve the albums for","example":"1274170","default":"1274170"},"required":true,"name":"id","in":"path"},{"schema":{"type":"number","description":"The page number of the results to retrieve","example":"0","default":"0"},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","description":"The criterion to sort the albums by","example":"popularity","enum":["popularity","latest","alphabetical"],"default":"popularity"},"required":false,"name":"sortBy","in":"query"},{"schema":{"type":"string","description":"The order to sort the albums","example":"desc","enum":["asc","desc"],"default":"desc"},"required":false,"name":"sortOrder","in":"query"}],"responses":{"200":{"description":"Successful response with a list of albums for the artist","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indicates whether the request was successful","example":true},"data":{"type":"object","properties":{"total":{"type":"number"},"albums":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"year":{"type":["number","null"]},"type":{"type":"string"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"explicitContent":{"type":"boolean"},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"songCount":{"type":["number","null"]},"url":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"songs":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"]}}},"required":["id","name","description","year","type","playCount","language","explicitContent","artists","songCount","url","image","songs"]}}},"required":["total","albums"],"description":"An array of albums associated with the artist"}},"required":["success","data"]}}}},"404":{"description":"Artist not found for the given ID"}}}},"/api/playlists":{"get":{"tags":["Playlist"],"summary":"Retrieve a playlist by ID or link","description":"Retrieve a playlist by providing either an ID or its share link.","operationId":"getPlaylistByIdOrLink","parameters":[{"schema":{"type":"string","description":"The unique ID of the playlist","title":"Playlist ID","example":"82914609","default":"82914609"},"required":false,"name":"id","in":"query"},{"schema":{"type":"string","description":"The playlist's share link","title":"Playlist Link"},"required":false,"name":"link","in":"query"},{"schema":{"type":"integer","description":"The page number of the songs to retrieve from the playlist","title":"Page Number","example":"0","default":"0"},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","description":"Number of songs to retrieve per page","title":"Limit","example":"10","default":"10"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Successful response with playlist details","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indicates the success status of the request.","example":true},"data":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"year":{"type":["number","null"]},"type":{"type":"string"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"explicitContent":{"type":"boolean"},"songCount":{"type":["number","null"]},"url":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"songs":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"]}},"artists":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["id","name","description","year","type","playCount","language","explicitContent","songCount","url","image","songs","artists"],"description":"The detailed information of the playlist.","title":"Playlist Details"}},"required":["success","data"]}}}},"400":{"description":"Bad request due to missing or invalid query parameters."},"404":{"description":"The playlist could not be found with the provided ID or link."}}}},"/api/home":{"get":{"tags":["Browse"],"summary":"Home page sections","description":"The home page as ordered sections — weekly top songs, trending, top charts, new releases, editorial picks, radio stations, artist stations, regional hits, fresh hits, genres & moods, decades — shaped by the listener's languages.","operationId":"getHome","parameters":[{"schema":{"type":"string","description":"Comma-separated languages, most preferred first (hindi, english, punjabi, tamil, telugu, ...)","title":"Languages","example":"hindi,punjabi"},"required":false,"name":"language","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"languages":{"type":"array","items":{"type":"string"}},"sections":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"charts"},"title":{"type":"string","example":"Top Charts"},"subtitle":{"type":["string","null"]},"layout":{"type":"string","enum":["shelf","chart","grid","stations","artists","channels","songs","hero"],"description":"A hint for how the section is meant to be shown"},"reason":{"type":["string","null"],"description":"Why this section is here, for personal sections"},"more":{"type":["string","null"],"description":"An API path that returns the full list"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["song","album","playlist","artist","radio","channel","mix","show"]},"name":{"type":"string"},"subtitle":{"type":["string","null"]},"description":{"type":["string","null"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":["string","null"]},"language":{"type":["string","null"]},"year":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"songCount":{"type":["number","null"]},"followerCount":{"type":["number","null"]},"playCount":{"type":["number","null"]},"artists":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","image"]}},"station":{"type":["object","null"],"properties":{"kind":{"type":"string","enum":["featured","artist"]},"query":{"type":"string"},"language":{"type":["string","null"]}},"required":["kind","query","language"],"description":"For radio stations: pass to /radio/featured or /radio/artist to get songs"},"channel":{"type":["object","null"],"properties":{"subType":{"type":["string","null"]},"video":{"type":["string","null"]}},"required":["subType","video"]},"color":{"type":["string","null"]},"song":{"type":["object","null"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"],"description":"For songs: the full, playable song with stream links"}},"required":["id","type","name","subtitle","description","image","url","language","year","explicitContent","songCount","followerCount","playCount","artists","station","channel","color","song"]}}},"required":["id","title","subtitle","layout","reason","more","items"]}}},"required":["languages","sections"]}},"required":["success","data"]}}}},"400":{"description":"Bad request when query parameters are missing or invalid"},"404":{"description":"Nothing found for the given input"},"502":{"description":"The music catalogue did not answer"}}}},"/api/trending":{"get":{"tags":["Browse"],"summary":"Trending now","description":"What is trending today: songs, albums, playlists, or all three.","operationId":"getTrending","parameters":[{"schema":{"type":"string","enum":["song","album","playlist","all"],"example":"all"},"required":false,"name":"type","in":"query"},{"schema":{"type":"string","description":"Comma-separated languages, most preferred first (hindi, english, punjabi, tamil, telugu, ...)","title":"Languages","example":"hindi,punjabi"},"required":false,"name":"language","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["song","album","playlist","artist","radio","channel","mix","show"]},"name":{"type":"string"},"subtitle":{"type":["string","null"]},"description":{"type":["string","null"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":["string","null"]},"language":{"type":["string","null"]},"year":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"songCount":{"type":["number","null"]},"followerCount":{"type":["number","null"]},"playCount":{"type":["number","null"]},"artists":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","image"]}},"station":{"type":["object","null"],"properties":{"kind":{"type":"string","enum":["featured","artist"]},"query":{"type":"string"},"language":{"type":["string","null"]}},"required":["kind","query","language"],"description":"For radio stations: pass to /radio/featured or /radio/artist to get songs"},"channel":{"type":["object","null"],"properties":{"subType":{"type":["string","null"]},"video":{"type":["string","null"]}},"required":["subType","video"]},"color":{"type":["string","null"]},"song":{"type":["object","null"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"],"description":"For songs: the full, playable song with stream links"}},"required":["id","type","name","subtitle","description","image","url","language","year","explicitContent","songCount","followerCount","playCount","artists","station","channel","color","song"]}}},"required":["success","data"]}}}},"400":{"description":"Bad request when query parameters are missing or invalid"},"404":{"description":"Nothing found for the given input"},"502":{"description":"The music catalogue did not answer"}}}},"/api/charts":{"get":{"tags":["Browse"],"summary":"Top charts","description":"The editorial charts (India Superhits Top 50, most searched, most streamed love songs, decades) for the given languages.","operationId":"getCharts","parameters":[{"schema":{"type":"string","description":"Comma-separated languages, most preferred first (hindi, english, punjabi, tamil, telugu, ...)","title":"Languages","example":"hindi,punjabi"},"required":false,"name":"language","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["song","album","playlist","artist","radio","channel","mix","show"]},"name":{"type":"string"},"subtitle":{"type":["string","null"]},"description":{"type":["string","null"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":["string","null"]},"language":{"type":["string","null"]},"year":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"songCount":{"type":["number","null"]},"followerCount":{"type":["number","null"]},"playCount":{"type":["number","null"]},"artists":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","image"]}},"station":{"type":["object","null"],"properties":{"kind":{"type":"string","enum":["featured","artist"]},"query":{"type":"string"},"language":{"type":["string","null"]}},"required":["kind","query","language"],"description":"For radio stations: pass to /radio/featured or /radio/artist to get songs"},"channel":{"type":["object","null"],"properties":{"subType":{"type":["string","null"]},"video":{"type":["string","null"]}},"required":["subType","video"]},"color":{"type":["string","null"]},"song":{"type":["object","null"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"],"description":"For songs: the full, playable song with stream links"}},"required":["id","type","name","subtitle","description","image","url","language","year","explicitContent","songCount","followerCount","playCount","artists","station","channel","color","song"]}}},"required":["success","data"]}}}},"400":{"description":"Bad request when query parameters are missing or invalid"},"404":{"description":"Nothing found for the given input"},"502":{"description":"The music catalogue did not answer"}}}},"/api/new-releases":{"get":{"tags":["Browse"],"summary":"New releases","description":"Newly released songs and albums, newest first. Songs come back playable.","operationId":"getNewReleases","parameters":[{"schema":{"type":"string","description":"Comma-separated languages, most preferred first (hindi, english, punjabi, tamil, telugu, ...)","title":"Languages","example":"hindi,punjabi"},"required":false,"name":"language","in":"query"},{"schema":{"type":"string","example":"1"},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","example":"20"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["song","album","playlist","artist","radio","channel","mix","show"]},"name":{"type":"string"},"subtitle":{"type":["string","null"]},"description":{"type":["string","null"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":["string","null"]},"language":{"type":["string","null"]},"year":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"songCount":{"type":["number","null"]},"followerCount":{"type":["number","null"]},"playCount":{"type":["number","null"]},"artists":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","image"]}},"station":{"type":["object","null"],"properties":{"kind":{"type":"string","enum":["featured","artist"]},"query":{"type":"string"},"language":{"type":["string","null"]}},"required":["kind","query","language"],"description":"For radio stations: pass to /radio/featured or /radio/artist to get songs"},"channel":{"type":["object","null"],"properties":{"subType":{"type":["string","null"]},"video":{"type":["string","null"]}},"required":["subType","video"]},"color":{"type":["string","null"]},"song":{"type":["object","null"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"],"description":"For songs: the full, playable song with stream links"}},"required":["id","type","name","subtitle","description","image","url","language","year","explicitContent","songCount","followerCount","playCount","artists","station","channel","color","song"]}}},"required":["success","data"]}}}},"400":{"description":"Bad request when query parameters are missing or invalid"},"404":{"description":"Nothing found for the given input"},"502":{"description":"The music catalogue did not answer"}}}},"/api/featured-playlists":{"get":{"tags":["Browse"],"summary":"Editorial playlists","description":"Editorial playlist picks, paged.","operationId":"getFeaturedPlaylists","parameters":[{"schema":{"type":"string","description":"Comma-separated languages, most preferred first (hindi, english, punjabi, tamil, telugu, ...)","title":"Languages","example":"hindi,punjabi"},"required":false,"name":"language","in":"query"},{"schema":{"type":"string","example":"1"},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","example":"20"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["song","album","playlist","artist","radio","channel","mix","show"]},"name":{"type":"string"},"subtitle":{"type":["string","null"]},"description":{"type":["string","null"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":["string","null"]},"language":{"type":["string","null"]},"year":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"songCount":{"type":["number","null"]},"followerCount":{"type":["number","null"]},"playCount":{"type":["number","null"]},"artists":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","image"]}},"station":{"type":["object","null"],"properties":{"kind":{"type":"string","enum":["featured","artist"]},"query":{"type":"string"},"language":{"type":["string","null"]}},"required":["kind","query","language"],"description":"For radio stations: pass to /radio/featured or /radio/artist to get songs"},"channel":{"type":["object","null"],"properties":{"subType":{"type":["string","null"]},"video":{"type":["string","null"]}},"required":["subType","video"]},"color":{"type":["string","null"]},"song":{"type":["object","null"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"],"description":"For songs: the full, playable song with stream links"}},"required":["id","type","name","subtitle","description","image","url","language","year","explicitContent","songCount","followerCount","playCount","artists","station","channel","color","song"]}},"hasMore":{"type":"boolean"}},"required":["items","hasMore"]}},"required":["success","data"]}}}},"400":{"description":"Bad request when query parameters are missing or invalid"},"404":{"description":"Nothing found for the given input"},"502":{"description":"The music catalogue did not answer"}}}},"/api/top-artists":{"get":{"tags":["Browse"],"summary":"Top artists","description":"The most followed artists right now.","operationId":"getTopArtists","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["song","album","playlist","artist","radio","channel","mix","show"]},"name":{"type":"string"},"subtitle":{"type":["string","null"]},"description":{"type":["string","null"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":["string","null"]},"language":{"type":["string","null"]},"year":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"songCount":{"type":["number","null"]},"followerCount":{"type":["number","null"]},"playCount":{"type":["number","null"]},"artists":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","image"]}},"station":{"type":["object","null"],"properties":{"kind":{"type":"string","enum":["featured","artist"]},"query":{"type":"string"},"language":{"type":["string","null"]}},"required":["kind","query","language"],"description":"For radio stations: pass to /radio/featured or /radio/artist to get songs"},"channel":{"type":["object","null"],"properties":{"subType":{"type":["string","null"]},"video":{"type":["string","null"]}},"required":["subType","video"]},"color":{"type":["string","null"]},"song":{"type":["object","null"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"],"description":"For songs: the full, playable song with stream links"}},"required":["id","type","name","subtitle","description","image","url","language","year","explicitContent","songCount","followerCount","playCount","artists","station","channel","color","song"]}}},"required":["success","data"]}}}},"400":{"description":"Bad request when query parameters are missing or invalid"},"404":{"description":"Nothing found for the given input"},"502":{"description":"The music catalogue did not answer"}}}},"/api/top-searches":{"get":{"tags":["Browse"],"summary":"Top searches","description":"What people are searching for right now, for an empty search screen.","operationId":"getTopSearches","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["song","album","playlist","artist","radio","channel","mix","show"]},"name":{"type":"string"},"subtitle":{"type":["string","null"]},"description":{"type":["string","null"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":["string","null"]},"language":{"type":["string","null"]},"year":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"songCount":{"type":["number","null"]},"followerCount":{"type":["number","null"]},"playCount":{"type":["number","null"]},"artists":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","image"]}},"station":{"type":["object","null"],"properties":{"kind":{"type":"string","enum":["featured","artist"]},"query":{"type":"string"},"language":{"type":["string","null"]}},"required":["kind","query","language"],"description":"For radio stations: pass to /radio/featured or /radio/artist to get songs"},"channel":{"type":["object","null"],"properties":{"subType":{"type":["string","null"]},"video":{"type":["string","null"]}},"required":["subType","video"]},"color":{"type":["string","null"]},"song":{"type":["object","null"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"],"description":"For songs: the full, playable song with stream links"}},"required":["id","type","name","subtitle","description","image","url","language","year","explicitContent","songCount","followerCount","playCount","artists","station","channel","color","song"]}}},"required":["success","data"]}}}},"400":{"description":"Bad request when query parameters are missing or invalid"},"404":{"description":"Nothing found for the given input"},"502":{"description":"The music catalogue did not answer"}}}},"/api/channels":{"get":{"tags":["Browse"],"summary":"Moods and genres","description":"The curated moods (Romance, Party, Chill…), genres (Hip Hop, Sufi, Ghazal…) and decades.","operationId":"getChannels","parameters":[{"schema":{"type":"string","description":"Comma-separated languages, most preferred first (hindi, english, punjabi, tamil, telugu, ...)","title":"Languages","example":"hindi,punjabi"},"required":false,"name":"language","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"moods":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["song","album","playlist","artist","radio","channel","mix","show"]},"name":{"type":"string"},"subtitle":{"type":["string","null"]},"description":{"type":["string","null"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":["string","null"]},"language":{"type":["string","null"]},"year":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"songCount":{"type":["number","null"]},"followerCount":{"type":["number","null"]},"playCount":{"type":["number","null"]},"artists":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","image"]}},"station":{"type":["object","null"],"properties":{"kind":{"type":"string","enum":["featured","artist"]},"query":{"type":"string"},"language":{"type":["string","null"]}},"required":["kind","query","language"],"description":"For radio stations: pass to /radio/featured or /radio/artist to get songs"},"channel":{"type":["object","null"],"properties":{"subType":{"type":["string","null"]},"video":{"type":["string","null"]}},"required":["subType","video"]},"color":{"type":["string","null"]},"song":{"type":["object","null"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"],"description":"For songs: the full, playable song with stream links"}},"required":["id","type","name","subtitle","description","image","url","language","year","explicitContent","songCount","followerCount","playCount","artists","station","channel","color","song"]}},"genres":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["song","album","playlist","artist","radio","channel","mix","show"]},"name":{"type":"string"},"subtitle":{"type":["string","null"]},"description":{"type":["string","null"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":["string","null"]},"language":{"type":["string","null"]},"year":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"songCount":{"type":["number","null"]},"followerCount":{"type":["number","null"]},"playCount":{"type":["number","null"]},"artists":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","image"]}},"station":{"type":["object","null"],"properties":{"kind":{"type":"string","enum":["featured","artist"]},"query":{"type":"string"},"language":{"type":["string","null"]}},"required":["kind","query","language"],"description":"For radio stations: pass to /radio/featured or /radio/artist to get songs"},"channel":{"type":["object","null"],"properties":{"subType":{"type":["string","null"]},"video":{"type":["string","null"]}},"required":["subType","video"]},"color":{"type":["string","null"]},"song":{"type":["object","null"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"],"description":"For songs: the full, playable song with stream links"}},"required":["id","type","name","subtitle","description","image","url","language","year","explicitContent","songCount","followerCount","playCount","artists","station","channel","color","song"]}},"more":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["song","album","playlist","artist","radio","channel","mix","show"]},"name":{"type":"string"},"subtitle":{"type":["string","null"]},"description":{"type":["string","null"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":["string","null"]},"language":{"type":["string","null"]},"year":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"songCount":{"type":["number","null"]},"followerCount":{"type":["number","null"]},"playCount":{"type":["number","null"]},"artists":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","image"]}},"station":{"type":["object","null"],"properties":{"kind":{"type":"string","enum":["featured","artist"]},"query":{"type":"string"},"language":{"type":["string","null"]}},"required":["kind","query","language"],"description":"For radio stations: pass to /radio/featured or /radio/artist to get songs"},"channel":{"type":["object","null"],"properties":{"subType":{"type":["string","null"]},"video":{"type":["string","null"]}},"required":["subType","video"]},"color":{"type":["string","null"]},"song":{"type":["object","null"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"],"description":"For songs: the full, playable song with stream links"}},"required":["id","type","name","subtitle","description","image","url","language","year","explicitContent","songCount","followerCount","playCount","artists","station","channel","color","song"]}}},"required":["moods","genres","more"]}},"required":["success","data"]}}}},"400":{"description":"Bad request when query parameters are missing or invalid"},"404":{"description":"Nothing found for the given input"},"502":{"description":"The music catalogue did not answer"}}}},"/api/channels/{id}":{"get":{"tags":["Browse"],"summary":"One mood or genre","description":"A mood or genre page: its top songs (playable), its top playlists and quick stations.","operationId":"getChannel","parameters":[{"schema":{"type":"string","description":"Channel id from /channels","example":"27"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","description":"Comma-separated languages, most preferred first (hindi, english, punjabi, tamil, telugu, ...)","title":"Languages","example":"hindi,punjabi"},"required":false,"name":"language","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["song","album","playlist","artist","radio","channel","mix","show"]},"name":{"type":"string"},"subtitle":{"type":["string","null"]},"description":{"type":["string","null"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":["string","null"]},"language":{"type":["string","null"]},"year":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"songCount":{"type":["number","null"]},"followerCount":{"type":["number","null"]},"playCount":{"type":["number","null"]},"artists":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","image"]}},"station":{"type":["object","null"],"properties":{"kind":{"type":"string","enum":["featured","artist"]},"query":{"type":"string"},"language":{"type":["string","null"]}},"required":["kind","query","language"],"description":"For radio stations: pass to /radio/featured or /radio/artist to get songs"},"channel":{"type":["object","null"],"properties":{"subType":{"type":["string","null"]},"video":{"type":["string","null"]}},"required":["subType","video"]},"color":{"type":["string","null"]},"song":{"type":["object","null"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"],"description":"For songs: the full, playable song with stream links"},"editorsNote":{"type":["string","null"]},"topSongs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"]}},"topPlaylists":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["song","album","playlist","artist","radio","channel","mix","show"]},"name":{"type":"string"},"subtitle":{"type":["string","null"]},"description":{"type":["string","null"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":["string","null"]},"language":{"type":["string","null"]},"year":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"songCount":{"type":["number","null"]},"followerCount":{"type":["number","null"]},"playCount":{"type":["number","null"]},"artists":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","image"]}},"station":{"type":["object","null"],"properties":{"kind":{"type":"string","enum":["featured","artist"]},"query":{"type":"string"},"language":{"type":["string","null"]}},"required":["kind","query","language"],"description":"For radio stations: pass to /radio/featured or /radio/artist to get songs"},"channel":{"type":["object","null"],"properties":{"subType":{"type":["string","null"]},"video":{"type":["string","null"]}},"required":["subType","video"]},"color":{"type":["string","null"]},"song":{"type":["object","null"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"],"description":"For songs: the full, playable song with stream links"}},"required":["id","type","name","subtitle","description","image","url","language","year","explicitContent","songCount","followerCount","playCount","artists","station","channel","color","song"]}},"stations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["song","album","playlist","artist","radio","channel","mix","show"]},"name":{"type":"string"},"subtitle":{"type":["string","null"]},"description":{"type":["string","null"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":["string","null"]},"language":{"type":["string","null"]},"year":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"songCount":{"type":["number","null"]},"followerCount":{"type":["number","null"]},"playCount":{"type":["number","null"]},"artists":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","image"]}},"station":{"type":["object","null"],"properties":{"kind":{"type":"string","enum":["featured","artist"]},"query":{"type":"string"},"language":{"type":["string","null"]}},"required":["kind","query","language"],"description":"For radio stations: pass to /radio/featured or /radio/artist to get songs"},"channel":{"type":["object","null"],"properties":{"subType":{"type":["string","null"]},"video":{"type":["string","null"]}},"required":["subType","video"]},"color":{"type":["string","null"]},"song":{"type":["object","null"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"],"description":"For songs: the full, playable song with stream links"}},"required":["id","type","name","subtitle","description","image","url","language","year","explicitContent","songCount","followerCount","playCount","artists","station","channel","color","song"]}}},"required":["id","type","name","subtitle","description","image","url","language","year","explicitContent","songCount","followerCount","playCount","artists","station","channel","color","song","editorsNote","topSongs","topPlaylists","stations"]}},"required":["success","data"]}}}},"400":{"description":"Bad request when query parameters are missing or invalid"},"404":{"description":"Nothing found for the given input"},"502":{"description":"The music catalogue did not answer"}}}},"/api/radio/stations":{"get":{"tags":["Radio"],"summary":"Radio stations","description":"Featured stations (Hindi Superhits, Bhajan Sagar, Sufiyana Safar…) and recommended artist stations.","operationId":"getRadioStations","parameters":[{"schema":{"type":"string","description":"Comma-separated languages, most preferred first (hindi, english, punjabi, tamil, telugu, ...)","title":"Languages","example":"hindi,punjabi"},"required":false,"name":"language","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["song","album","playlist","artist","radio","channel","mix","show"]},"name":{"type":"string"},"subtitle":{"type":["string","null"]},"description":{"type":["string","null"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":["string","null"]},"language":{"type":["string","null"]},"year":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"songCount":{"type":["number","null"]},"followerCount":{"type":["number","null"]},"playCount":{"type":["number","null"]},"artists":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","image"]}},"station":{"type":["object","null"],"properties":{"kind":{"type":"string","enum":["featured","artist"]},"query":{"type":"string"},"language":{"type":["string","null"]}},"required":["kind","query","language"],"description":"For radio stations: pass to /radio/featured or /radio/artist to get songs"},"channel":{"type":["object","null"],"properties":{"subType":{"type":["string","null"]},"video":{"type":["string","null"]}},"required":["subType","video"]},"color":{"type":["string","null"]},"song":{"type":["object","null"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"],"description":"For songs: the full, playable song with stream links"}},"required":["id","type","name","subtitle","description","image","url","language","year","explicitContent","songCount","followerCount","playCount","artists","station","channel","color","song"]}},"artists":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["song","album","playlist","artist","radio","channel","mix","show"]},"name":{"type":"string"},"subtitle":{"type":["string","null"]},"description":{"type":["string","null"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":["string","null"]},"language":{"type":["string","null"]},"year":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"songCount":{"type":["number","null"]},"followerCount":{"type":["number","null"]},"playCount":{"type":["number","null"]},"artists":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","image"]}},"station":{"type":["object","null"],"properties":{"kind":{"type":"string","enum":["featured","artist"]},"query":{"type":"string"},"language":{"type":["string","null"]}},"required":["kind","query","language"],"description":"For radio stations: pass to /radio/featured or /radio/artist to get songs"},"channel":{"type":["object","null"],"properties":{"subType":{"type":["string","null"]},"video":{"type":["string","null"]}},"required":["subType","video"]},"color":{"type":["string","null"]},"song":{"type":["object","null"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"],"description":"For songs: the full, playable song with stream links"}},"required":["id","type","name","subtitle","description","image","url","language","year","explicitContent","songCount","followerCount","playCount","artists","station","channel","color","song"]}}},"required":["featured","artists"]}},"required":["success","data"]}}}},"400":{"description":"Bad request when query parameters are missing or invalid"},"404":{"description":"Nothing found for the given input"},"502":{"description":"The music catalogue did not answer"}}}},"/api/radio/featured":{"get":{"tags":["Radio"],"summary":"Play a featured station","description":"Starts a featured station by name (the `station.query` of an item from /radio/stations) and returns its first songs.","operationId":"playFeaturedStation","parameters":[{"schema":{"type":"string","minLength":1,"example":"Hindi Superhits"},"required":true,"name":"name","in":"query"},{"schema":{"type":"string","description":"Comma-separated languages, most preferred first (hindi, english, punjabi, tamil, telugu, ...)","title":"Languages","example":"hindi,punjabi"},"required":false,"name":"language","in":"query"},{"schema":{"type":"string","example":"15"},"required":false,"name":"count","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"stationId":{"type":"string","description":"Pass to /radio/{stationId}/next for more songs"},"songs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"]}}},"required":["stationId","songs"]}},"required":["success","data"]}}}},"400":{"description":"Bad request when query parameters are missing or invalid"},"404":{"description":"Nothing found for the given input"},"502":{"description":"The music catalogue did not answer"}}}},"/api/radio/artist":{"get":{"tags":["Radio"],"summary":"Play an artist station","description":"Songs by and like an artist, endless.","operationId":"playArtistStation","parameters":[{"schema":{"type":"string","minLength":1,"example":"Arijit Singh"},"required":true,"name":"name","in":"query"},{"schema":{"type":"string","description":"Comma-separated languages, most preferred first (hindi, english, punjabi, tamil, telugu, ...)","title":"Languages","example":"hindi,punjabi"},"required":false,"name":"language","in":"query"},{"schema":{"type":"string","example":"15"},"required":false,"name":"count","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"stationId":{"type":"string","description":"Pass to /radio/{stationId}/next for more songs"},"songs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"]}}},"required":["stationId","songs"]}},"required":["success","data"]}}}},"400":{"description":"Bad request when query parameters are missing or invalid"},"404":{"description":"Nothing found for the given input"},"502":{"description":"The music catalogue did not answer"}}}},"/api/radio/mix":{"get":{"tags":["Radio"],"summary":"A mix from songs","description":"A station seeded from up to ten songs — the listener’s own mix. Seed songs are left out of the result.","operationId":"playSongMix","parameters":[{"schema":{"type":"string","description":"Comma-separated song ids","example":"ZIMh-Qq7,rjkrTnma"},"required":true,"name":"ids","in":"query"},{"schema":{"type":"string","example":"20"},"required":false,"name":"count","in":"query"},{"schema":{"type":"string","description":"Comma-separated song ids","example":"ZIMh-Qq7,rjkrTnma"},"required":false,"name":"exclude","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"stationId":{"type":"string","description":"Pass to /radio/{stationId}/next for more songs"},"songs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"]}}},"required":["stationId","songs"]}},"required":["success","data"]}}}},"400":{"description":"Bad request when query parameters are missing or invalid"},"404":{"description":"Nothing found for the given input"},"502":{"description":"The music catalogue did not answer"}}}},"/api/radio/{stationId}/next":{"get":{"tags":["Radio"],"summary":"More from a station","description":"The next songs from a station started earlier; call it again for endless playback.","operationId":"getStationNext","parameters":[{"schema":{"type":"string"},"required":true,"name":"stationId","in":"path"},{"schema":{"type":"string","example":"10"},"required":false,"name":"count","in":"query"},{"schema":{"type":"string","description":"Comma-separated song ids","example":"ZIMh-Qq7,rjkrTnma"},"required":false,"name":"exclude","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"]}}},"required":["success","data"]}}}},"400":{"description":"Bad request when query parameters are missing or invalid"},"404":{"description":"Nothing found for the given input"},"502":{"description":"The music catalogue did not answer"}}}},"/api/for-you":{"get":{"tags":["For you"],"summary":"Personal sections","description":"Sections built from what the listener plays: Your mix, Because you played …, More from <artist>, Your artist stations, Albums for you, and the charts in their language. Send the recent songs, newest first.","operationId":"getForYou","parameters":[{"schema":{"type":"string","description":"Recently played song ids, newest first (up to 10 are used)","example":"ZIMh-Qq7,rjkrTnma"},"required":false,"name":"songs","in":"query"},{"schema":{"type":"string","description":"Artist ids the listener follows or plays most","example":"459320"},"required":false,"name":"artists","in":"query"},{"schema":{"type":"string","description":"Comma-separated languages, most preferred first (hindi, english, punjabi, tamil, telugu, ...)","title":"Languages","example":"hindi,punjabi"},"required":false,"name":"language","in":"query"},{"schema":{"type":"string","description":"Song ids to leave out (already in the library, for example)","example":""},"required":false,"name":"exclude","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"seeds":{"type":"object","properties":{"songs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]}},"artists":{"type":"array","items":{"type":"string"}},"languages":{"type":"array","items":{"type":"string"}}},"required":["songs","artists","languages"]},"sections":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"charts"},"title":{"type":"string","example":"Top Charts"},"subtitle":{"type":["string","null"]},"layout":{"type":"string","enum":["shelf","chart","grid","stations","artists","channels","songs","hero"],"description":"A hint for how the section is meant to be shown"},"reason":{"type":["string","null"],"description":"Why this section is here, for personal sections"},"more":{"type":["string","null"],"description":"An API path that returns the full list"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["song","album","playlist","artist","radio","channel","mix","show"]},"name":{"type":"string"},"subtitle":{"type":["string","null"]},"description":{"type":["string","null"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":["string","null"]},"language":{"type":["string","null"]},"year":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"songCount":{"type":["number","null"]},"followerCount":{"type":["number","null"]},"playCount":{"type":["number","null"]},"artists":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","image"]}},"station":{"type":["object","null"],"properties":{"kind":{"type":"string","enum":["featured","artist"]},"query":{"type":"string"},"language":{"type":["string","null"]}},"required":["kind","query","language"],"description":"For radio stations: pass to /radio/featured or /radio/artist to get songs"},"channel":{"type":["object","null"],"properties":{"subType":{"type":["string","null"]},"video":{"type":["string","null"]}},"required":["subType","video"]},"color":{"type":["string","null"]},"song":{"type":["object","null"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"],"description":"For songs: the full, playable song with stream links"}},"required":["id","type","name","subtitle","description","image","url","language","year","explicitContent","songCount","followerCount","playCount","artists","station","channel","color","song"]}}},"required":["id","title","subtitle","layout","reason","more","items"]}}},"required":["seeds","sections"]}},"required":["success","data"]}}}},"400":{"description":"Bad request when query parameters are missing or invalid"},"404":{"description":"Nothing found for the given input"},"502":{"description":"The music catalogue did not answer"}}}},"/api/songs/{id}/recommendations":{"get":{"tags":["For you"],"summary":"Songs like this one","description":"Recommendations for a song — the basis of “Because you played …”.","operationId":"getSongRecommendations","parameters":[{"schema":{"type":"string","example":"ZIMh-Qq7"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","example":"15"},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","description":"Song ids to leave out","example":""},"required":false,"name":"exclude","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"]}}},"required":["success","data"]}}}},"400":{"description":"Bad request when query parameters are missing or invalid"},"404":{"description":"Nothing found for the given input"},"502":{"description":"The music catalogue did not answer"}}}},"/api/songs/{id}/autoplay":{"get":{"tags":["For you"],"summary":"What plays after this song","description":"Songs to keep playing when the queue runs out, similar to this one. Falls back through recommendations, the station for the song, its artists and the trending songs in its language, so it is never empty while the catalogue answers. `sources` says where the songs came from.","operationId":"getSongAutoplay","parameters":[{"schema":{"type":"string","example":"ZIMh-Qq7"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","example":"20"},"required":false,"name":"count","in":"query"},{"schema":{"type":"string","description":"Song ids to leave out: recently played, already queued, disliked","example":""},"required":false,"name":"exclude","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"seed":{"type":"string"},"sources":{"type":"array","items":{"type":"string"}},"songs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"]}}},"required":["seed","sources","songs"]}},"required":["success","data"]}}}},"400":{"description":"Bad request when query parameters are missing or invalid"},"404":{"description":"Nothing found for the given input"},"502":{"description":"The music catalogue did not answer"}}}},"/api/albums/{id}/recommendations":{"get":{"tags":["For you"],"summary":"Albums like this one","operationId":"getAlbumRecommendations","parameters":[{"schema":{"type":"string","example":"35727253"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","example":"12"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["song","album","playlist","artist","radio","channel","mix","show"]},"name":{"type":"string"},"subtitle":{"type":["string","null"]},"description":{"type":["string","null"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":["string","null"]},"language":{"type":["string","null"]},"year":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"songCount":{"type":["number","null"]},"followerCount":{"type":["number","null"]},"playCount":{"type":["number","null"]},"artists":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","image"]}},"station":{"type":["object","null"],"properties":{"kind":{"type":"string","enum":["featured","artist"]},"query":{"type":"string"},"language":{"type":["string","null"]}},"required":["kind","query","language"],"description":"For radio stations: pass to /radio/featured or /radio/artist to get songs"},"channel":{"type":["object","null"],"properties":{"subType":{"type":["string","null"]},"video":{"type":["string","null"]}},"required":["subType","video"]},"color":{"type":["string","null"]},"song":{"type":["object","null"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"year":{"type":["string","null"]},"releaseDate":{"type":["string","null"]},"duration":{"type":["number","null"]},"label":{"type":["string","null"]},"explicitContent":{"type":"boolean"},"playCount":{"type":["number","null"]},"language":{"type":"string"},"hasLyrics":{"type":"boolean"},"lyricsId":{"type":["string","null"]},"url":{"type":"string"},"copyright":{"type":["string","null"]},"album":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["id","name","url"]},"artists":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"featured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}},"all":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"url":{"type":"string"}},"required":["id","name","role","type","image","url"]}}},"required":["primary","featured","all"]},"image":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}},"downloadUrl":{"type":"array","items":{"type":"object","properties":{"quality":{"type":"string"},"url":{"type":"string"}},"required":["quality","url"]}}},"required":["id","name","type","year","releaseDate","duration","label","explicitContent","playCount","language","hasLyrics","lyricsId","url","copyright","album","artists","image","downloadUrl"],"description":"For songs: the full, playable song with stream links"}},"required":["id","type","name","subtitle","description","image","url","language","year","explicitContent","songCount","followerCount","playCount","artists","station","channel","color","song"]}}},"required":["success","data"]}}}},"400":{"description":"Bad request when query parameters are missing or invalid"},"404":{"description":"Nothing found for the given input"},"502":{"description":"The music catalogue did not answer"}}}}},"webhooks":{}}