Search: Release Search

• URL: https://api.promoonly.com/rsearch/[SEARCH_STRING]
• Call Type: GET
• Header encoding: Base64
• Data return format: JSON

1. userid: integer
2. token: string

• artist: String
• downloaded: Integer
• genre: String
• id: Integer
• label: String
• media_type: Integer (1=video, 2=audio)
• modified: Integer (Unix Timestamp)
• release: String
• release_date: Date
• release_image: URL String
• tracks: Integer

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

   Example JSON Output

   [
       {
           "artist": "Steven Malcolm f./Jay-Way",
           "downloaded": 0,
           "genre": "Hip-Hop",
           "id": 52421,
           "label": "4 Against 5/Word",
           "media_type": 2,
           "modified": 1568036067,
           "release": "Summertime",
           "release_date": "2019-09-09",
           "release_image": "https://s3.amazonaws.com/pool.images/52421.jpg",
           "tracks": 1
       },
       {
           "artist": "Captain Cuts & Digital Farm Animals",
           "downloaded": 0,
           "genre": "Dance",
           "id": 52303,
           "label": "Epic",
           "media_type": 2,
           "modified": 1567207213,
           "release": "Summertime Love",
           "release_date": "2019-08-30",
           "release_image": "https://s3.amazonaws.com/pool.images/52303.jpg",
           "tracks": 1
       },
       {
           "artist": "Childish Gambino",
           "downloaded": 0,
           "genre": "Unspecified",
           "id": 44782,
           "label": "RCA",
           "media_type": 2,
           "modified": 1531399595,
           "release": "Summertime Magic",
           "release_date": "2018-07-12",
           "release_image":"https://s3.amazonaws.com/pool.images/44782.jpg",
           "tracks": 1
       }
   ]

Examples

1. PHP (using cURL):

   <?php
       $userid = 1;
       $token = "8b26e1e4f3f5e00a888807e605565c47";
   
       $api_url = "https://api.promoonly.com/rsearch/summertime";
   
       $ch = curl_init();
       curl_setopt($ch, CURLOPT_URL, $api_url);
       curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: Bearer ".base64_encode($userid.":".$token)));
       curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
   
       $api_result = curl_exec($ch);
       curl_close($ch);
   
       $api_obj = json_decode($api_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/rsearch/summertime",
       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}
   api_url = "https://api.promoonly.com/rsearch/summertime"
   result_return = requests.get(api_url, headers=headers)
   
   print(result_return.text)