Get Albums by IDs
Request
GET /album/v1/albumIds
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 |
|---|---|
| ids | Required string A comma-separated list of the Boomplay IDs for the albums. Maximum: 20 IDs. Example value:"123,456" |
Responses Body
Body
code (integer) required
desc (string)
data (object)album_id (integer) The Boomplay ID for the album.
album_title (string) The Boomplay title for the album.
album_type (string) The Boomplay type for the album.
upc (string) The Boomplay upc for the album.
release_date (string) The album Release date.
label (string) Record label.
genres (string) The album genres.
available_markets (string) Release country .
web_url (string) web url.
mobile_url (string) mobile url.
artwork objectwidth (integer) image width
height (integer) image height
url (string) coverartists (array of objects)
artist_id (integer) The Boomplay ID for the artist.
artist_name (string) The Boomplay name for the artisartist_role (string) The role of the artist.Example value:Main Artists, Featured Artists
track_count (integer) Number of tracks
tracks (array of objects)track_id (integer) The Boomplay ID for the track.
track_title (string) The Boomplay ID for the title.
track_number (integer) The Track sort value
Request Sample
GET /album/v1/albumIds?ids=123 HTTP/1.1
Authorization: ${authorization}
app_id: ${app_id}
Host: openapi.boomplay.com
Response Example
{
"desc": null,
"code": 0,
"data": [
{
"album_id": 40002743,
"album_title": "TestOT001",
"album_type": "EP",
"upc": "",
"track_count": 5,
"release_date": "2022-03-18",
"label": "10/10 Records",
"genres": "World Music,World Music",
"available_markets": "OT,CN",
"web_url": "https://test.boomplay.com/albums/40002743?srModel=openapi_hb66",
"mobile_url": "https://test.boomplay.com/share/album/40002743?srModel=openapi_hb66",
"artwork": {
"width": 464,
"height": 464,
"url": "https://testsource.boomplaymusic.com/test_group10/M00/03/17/a5d36d70a1ee4bc6be2f8205b123199b_464_464.jpg"
},
"artists": [
{
"artist_id": 21884682,
"artist_name": "Jake zhou",
"artist_role": "Main Artists"
},
{
"artist_id": 21876670,
"artist_name": "YYYsmIconIDBigIconID",
"artist_role": "Main Artists"
}
],
"tracks": [
{
"track_id": 54220292,
"track_title": "TestOT001",
"track_number": 1
}
]
}
]
}