Listings: Specialty Tracks by Decade

• URL: https://api.promoonly.com/specialty/decade/[DECADE YYYY]/[PAGE_NUMBER]
• Call Type: GET
• Header encoding: Base64
• Data return format: JSON

1. userid: integer
2. token: string

• artist: String
• bpm: Integer
• content_warning: Boolean
• downloaded: Integer
• duration: Integer
• end: String (Cold/Fade)
• explicit: Binary (0/1)
• formatid: Integer
• genre: String
• label: String
• media_type: Integer (1=video, 2=audio)
• mix: String
• modified: Integer (Unix Timestamp)
• release_artist: String
• release_image: URL String
• releaseid: Integer
• title: String
• titleid: Integer
• trackid: Integer

1. URL: https://api.promoonly.com/specialty/decade/[DECADE YYYY]/[PAGE_NUMBER]
2. Header: Authorization: Bearer Base64(userid:token)
3. Method: GET
4. Returned: JSON
   

   Example JSON Output

   [
       {
           "artist": "Crystal Waters",
           "bpm": 120,
           "content_warning": false,
           "downloaded": 0,
           "duration": 187,
           "end": "Cold",
           "explicit": 0,
           "formatid": 9,
           "genre": "",
           "label": "Mercury",
           "media_type": 1,
           "mix": "",
           "modified": 1462292902,
           "release_artist": "Promo Only",
           "release_image": "https://pomed.promoonly.com/issue_imgs/HVC-1994v1-500.png",
           "releaseid": 248,
           "title": "100% Pure Love",
           "titleid": 5058,
           "trackid": 44211
       },
       {
           "artist": "Crystal Waters",
           "bpm": 120,
           "content_warning": false,
           "downloaded": 0,
           "duration": 260,
           "end": "Cold",
           "explicit": 0,
           "formatid": 59,
           "genre": "",
           "label": "Mercury",
           "media_type": 1,
           "mix": "Club Edit*",
           "modified": 1559853892,
           "release_artist": "Promo Only",
           "release_image": "https://pomed.promoonly.com/issue_imgs/POREMIXES-500.png",
           "releaseid": 4911,
           "title": "100% Pure Love",
           "titleid": 113173,
           "trackid": 45323
       },
       {
           "artist": "Beat Dominator",
           "bpm": 132,
           "content_warning": false,
           "downloaded": 0,
           "duration": 226,
           "end": "Fade",
           "explicit": 0,
           "formatid": 9,
           "genre": "",
           "label": "Pandisc",
           "media_type": 1,
           "mix": "",
           "modified": 1462292841,
           "release_artist": "Promo Only",
           "release_image": "https://pomed.promoonly.com/issue_imgs/HVC-1993v2-500.png",
           "releaseid": 1784,
           "title": "1-2-3-4-5-6 Bass",
           "titleid": 55636,
           "trackid": 44916
       }
   ]

Examples

1. PHP (using cURL):

   <?php
       $userid = 1;
       $token = "8b26e1e4f3f5e00a888807e605565c47";
   
       $specialty_url = "https://api.promoonly.com/specialty/decade/1990/1";
   
       $ch = curl_init();
       curl_setopt($ch, CURLOPT_URL, $specialty_url);
       curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: Bearer ".base64_encode($userid.":".$token)));
       curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
   
       $specialty_result = curl_exec($ch);
       curl_close($ch);
   
       $specialty_obj = json_decode($specialty_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/specialty/decade/1990/1",
       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}
   specialty_url = "https://api.promoonly.com/specialty/decade/1990/1"
   result_return = requests.get(specialty_url, headers=headers)
   
   print(result_return.text)