Get Tracks by IDs

Request

GET /track/v1/trackIds

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 track. Maximum: 20 IDs.
Example value:"123,456"

Responses Body

Body

code (integer) required
desc (string)
data (object)

track_id (integer) The Boomplay ID for the track.
track_title (string) The Boomplay title for the track.
track_number (integer) Ranking of track in the album.
isrc (string) isrc
duration (string) Track duration
album_id (integer) The Boomplay ID for the album.
album_title (string) The Boomplay title for the album.
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

Request Sample

GET /track/v1/trackIds?ids=123,152 HTTP/1.1
Authorization: ${authorization}
app_id: ${app_id}
Host: openapi.boomplay.com

Response Example

{
  "desc": null,
  "code": 0,
  "data": [
    {
      "track_id": 74767514,
      "track_title": "Swagg ft. Nandy",
      "track_number": 1,
      "isrc": "",
      "duration": "00:03:31",
      "album_id": 34412630,
      "album_title": "",
      "genres": "",
      "available_markets": "PS,PT,PW,PY,AD,AF,AG,AL,AM,AO,AR,AS,AT,AU,AZ,RO,BA,BB,RS,BD,BE,RU,BF,BG,RW,BI,BJ,BN,BO,SB,SC,BR,BS,SE,BT,SG,BW,SI,BY,SK,BZ,SL,SM,SN,SO,CA,SR,SS,CD,ST,CF,SV,CG,CH,CI,SZ,CK,CL,CM,CN,CO,CR,TD,CU,CV,TG,TH,CY,TJ,CZ,TK,TL,TM,TO,TR,TT,DE,TV,TW,DJ,TZ,DK,DM,DO,UA,UG,US,EC,EE,UY,UZ,VA,ER,VC,ES,ET,VE,VN,VU,FI,FJ,FK,FM,FR,WF,GA,GB,WS,GD,GE,GF,GH,GM,GN,GQ,GR,GS,GT,GU,GW,GY,XO,HN,HR,HT,HU,ID,IE,IL,IN,ZA,IQ,IS,IT,ZM,ZW,JM,JP,KE,KG,KH,KI,KM,KN,KP,KR,KZ,LC,LI,LK,LR,LS,LT,LU,LV,MC,MD,ME,MG,MH,MK,ML,MM,MN,MP,MR,MT,MU,MV,MW,MX,MY,MZ,NA,NC,NE,NF,NG,NI,NL,NO,NP,NR,NU,NZ,OT,PA,PE,PF,PG,PH,PK,PL,PN",
      "web_url": "https://test.boomplay.com/songs/74767514?srModel=openapi_hb1",
      "mobile_url": "https://test.boomplay.com/share/music/74767514?srModel=openapi_hb1",
      "artwork": {
        "width": 464,
        "height": 464,
        "url": "https://testsource.boomplaymusic.com/test_group10/M00/03/17/a5d36d70a1ee4bc6be2f8205b123199b_464_464.jpg"
      },
      "artists": [
        {
          "artist_id": 93271,
          "artist_name": "Joh Makini",
          "artist_role": "Main Artists"
        },
        {
          "artist_id": 93271,
          "artist_name": "Joh Makini",
          "artist_role": "Main Artists"
        }
      ]
    }
  ]
}

results matching ""

    No results matching ""