Using the Access Token

How to use the Access Token

The access token allows you to make requests to the Boomplay Web API. To do so, you need to include the following header in your API calls:

The following example uses curl to retrieve information about a track using the Get a track endpoint:

    curl --request GET 'https://openapi.boomplay.com/track/v1/trackIds?ids=74767514' \
         --header "Authorization: Bearer NgCXRK...MzYjw" \
         --header "app_id: your app id"

If everything goes correctly, you will receive a response similar to this:

{
  "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_id": 93271,
          "artist_name": "Joh Makini"
        }
      ]
    }
  ]
}