Get Details Of The Charts
Request
GET /charts/v1/playlist/detail/{id}
Parameter
HEADER PARAMETER | VALUE |
---|---|
Content-Type | Required Set to application/json |
Accept-Language | Such as zh-CN,en-US... default en |
app_id | Required The app ID provided to you by Boomplay when you register your application. |
Authorization | Required Access Token |
REQUEST PARAMETER | VALUE |
---|---|
id | Required Integer The Boomplay ID for the playlist. Example value: 1234 |
Responses Body
Body
code (integer) required
desc (string)
data (object)date_updated (string) The data when the playlist is updated.
playlist_id (integer) Boomplay ID for the playlist
playlist_title (string) The name of the playlist
playlist_creator (string)The creator of the playlist
description (string) The description of the playlist web_url (string) A link of playlist on webplayer mobile_url (string) A link of playlist on app followers (integer) The followers of the playlist track_count (integer) The number of tracks in the playlistartwork object
width (integer) The image width in pixels
height (integer) The image height in pixels
url (string) The source URL of the imagetracks (array of objects) tracks
track_id (integer) The Boomplay ID for the track track_title (string) The name of the track isrc (string) The ISRC of the track duration (string) The duration of the track. Example value:PT04H30M00S album_id (integer) The Boomplay ID for the album album_title (integer) The name of the album genres (string) The genre of the track web_url (string) A link of the track on webplayer mobile_url (string) A link of the track on app track_rank (integer) The rank of the track in playlist track_rank_lastweek (integer) The rank of the track last week in playlist artists (array of objects) The artists of the track
artist_id (integer) The Boomplay ID for the artist artist_name (string) The name of the artist artist_role (string) The role of the artist.Example value:Main Artists, Featured Artists
artwork object
width (integer) The image width in pixels
height (integer) The image height in pixels
url (string) The source URL of the image
Request Sample
GET /charts/v1/playlist/detail/12345 HTTP/1.1
Authorization: ${authorization}
app_id: ${app_id}
Host: openapi.boomplay.com
Response Example
{
"desc": null,
"code": 0,
"data": [
{
"playlist_id": 4028402,
"playlist_title": "Daily 100 Christian&Gospel",
"playlist_creator": "Boomplay Charts",
"description": "Mise à jour quotidienne des titres Chrétiens & Gospel les plus écoutées au Benin Mise à jour le 23 décembre 2022",
"date_updated": "2022-11-22",
"web_url": "https://test.boomplay.com/playlists/4028402?srModel=openapi_hb1",
"mobile_url": "https://test.boomplay.com/share/playlist/4028402?srModel=openapi_hb1",
"track_count": 100,
"followers": 4,
"tracks": [
{
"track_id": 54285618,
"track_title": "test 03",
"isrc": "yqq202304201834003",
"duration": "00:02:47",
"album_id": 70020480,
"album_title": "test 03",
"genres": "Folk",
"web_url": "https://test.boomplay.com/songs/54285618?srModel=openapi_hb1",
"mobile_url": "https://test.boomplay.com/share/music/54285618?srModel=openapi_hb1",
"artwork": {
"width": 464,
"height": 464,
"url": "https://testsource.boomplaymusic.com/test_group10/M00/05/08/2d39a0a339f44ab697ac20dc50507de5_464_464.jpg"
},
"artists": [
{
"artist_id": 21884824,
"artist_name": "Mockxun06",
"artist_role": "Main Artist"
},
{
"artist_id": 21884682,
"artist_name": "Jake zhou",
"artist_role": "Featured Artist"
}
],
"track_rank": 1,
"track_rank_previous": 1
}
]
}
]
}