Listings: View Release

• URL: https://api.promoonly.com/release/RELEASE_ID
• Call Type: GET
• Header encoding: Base64
• Data return format: JSON

1. userid: integer
2. token: string

• id: Integer
• formatid: Integer
• date: Date (YYYY-MM-DD)
• label_img: URL String
• mod_time: Integer (Unix Timestamp)
• month: Integer (0)
• release: String (Chart Name)
• release_artist: String ("Promo Only")
• release_genre: String ("Compilation")
• release_img: URL String
• release_label: String ("Promo Only Issue")
• year: Integer (YYYY)
• tracks: List
  • artist: String
  • bpm: Integer
  • content_warning: Boolean (True/False)
  • downloaded: Binary (0/1)
  • duration: Integer
  • end: String ("Cold"/"Fade")
  • explicit: Binary (0/1)
  • genre: String
  • label: String
  • media_type: Integer (1-video/2-audio)
  • mix: String
  • order: Integer
  • title: String
  • titleid: Integer
  • trackid: Integer

1. URL: https://api.promoonly.com/release/RELEASE_ID
2. Header: Authorization: Bearer Base64(userid:token)
3. Method: GET
4. Returned: JSON
   

   Example JSON Output:

   {
       "date": "2020-04-01",
       "formatid": 89,
       "id": 24200,
       "label_img": "https://loop.promoonly.com/assets/po_small.png",
       "mod_time": 1585760932,
       "month": 0,
       "release": "Mainstream Top 20",
       "release_artist": "Promo Only",
       "release_genre": "Compilation",
       "release_img": "http://pomed.promoonly.com/issue_imgs/24200_chart.jpg",
       "release_label": "Promo Only Issue",
       "year": 0,
       "tracks":
       [
           {
               "artist": "Dua Lipa",
               "bpm": 124,
               "content_warning": false,
               "downloaded": 0,
               "duration": 203,
               "end": "Cold",
               "explicit": 0,
               "genre": "Pop",
               "label": "Warner",
               "media_type": 2,
               "mix": "PopRoXxX Intro Edit",
               "order": 1,
               "title": "Don't Start Now",
               "titleid": 617020,
               "trackid": 357364
           },
           {
               "artist": "Harry Styles",
               "bpm": 99,
               "content_warning": false,
               "downloaded": 0,
               "duration": 206,
               "end": "Cold",
               "explicit": 0,
               "genre": "Pop",
               "label": "Erskine/Columbia",
               "media_type": 2,
               "mix": "",
               "order": 2,
               "title": "Adore You",
               "titleid": 618501,
               "trackid": 359383
           },
           {
               "artist": "blackbear",
               "bpm": 65,
               "content_warning": true,
               "downloaded": 0,
               "duration": 270,
               "end": "Cold",
               "explicit": 0,
               "genre": "Hip-Hop",
               "label": "Beartrap/Alamo/Interscope",
               "media_type": 2,
               "mix": "PO Intro Edit",
               "order": 3,
               "title": "Hot Girl Bummer",
               "titleid": 615258,
               "trackid": 359381
           }
       ]
   }

Examples

1. PHP (using cURL):

   <?php
       $userid = 1;
       $token = "8b26e1e4f3f5e00a888807e605565c47";
       $chart_url = "https://api.promoonly.com/release/24200";
   
       $ch = curl_init();
       curl_setopt($ch, CURLOPT_URL, $charts_url);
       curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: Bearer ".base64_encode($userid.":".$token)));
       curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
   
       $charts_result = curl_exec($ch);
       curl_close($ch);
   
       $sync_obj = json_decode($charts_result);
   ?>

2. Javascript (using jQuery):

   function b64EncodeUnicode(str)
   {
       return btoa(encodeURIComponent(str).replace(/%([0-9A-F]{2})/g,
           function toSolidBytes(match, p1)
           {
               return String.fromCharCode('0x' + p1);
           }));
   }
   
   var userid = 1;
   var token = "8b26e1e4f3f5e00a888807e605565c47";
   var auth_str = "Bearer " + b64EncodeUnicode(userid + ":" + token);
   
   $.ajax({
       type: "GET",
       url: "https://api.promoonly.com/release/24200",
       headers: { "Authorization": auth_str },
       dataType: "json",
       success: function (data)
       {
           console.log(data);
       }
   });

3. Python (using requests):

   #!/usr/bin/env python
   
   import requests
   import base64
   import urllib
   
   userid = 1
   token = "8b26e1e4f3f5e00a888807e605565c47"
   
   b64_key = base64.b64encode("%s:%s" % (userid, token))
   headers = {"Authorization": "Bearer %s" % b64_key}
   chart_url = "https://api.promoonly.com/release/24200"
   result_return = requests.get(chart_url, headers=headers)
   
   print(result_return.text)