Get Albums by UPC

Request

GET /album/v1/upc/{upc}

Parameter

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 object

width (integer) image width
height (integer) image height
url (string) cover

artists (array of objects)

artist_id (integer) The Boomplay ID for the artist.
artist_name (string) The Boomplay name for the artis

artist_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/upc/UPC132 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
        }
      ]
    }
  ]
}