Search: Quick Search

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

1. userid: integer
2. token: string

• release_results: List
  • artist: String
  • downloaded: Integer
  • genre: String
  • id: Integer
  • image_url: URL String
  • label: String
  • modified: Integer (Unix Timestamp)
  • release: String
  • release_date: Date
  • tracks: Integer
  • type: Integer (1=video, 2=audio)
• title_results: List
  • id: Integer
  • titleid: Integer
  • artist: String
  • title: String
  • mix: String
  • label: String
  • duration: Integer
  • downloaded: Integer
  • bpm: Integer
  • genre: String
  • explicit: Binary (0/1)
  • type: Integer (1=video, 2=audio)
  • media: String
  • releaseid: Integer
  • release: String
  • release_img: URL String
  • content_warning: Boolean (true/false)
  • modified: Integer (Unix Timestamp)

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

   Example JSON Output

   {
       "release_results":
       [
           {
               "artist": "Davido x Chris Brown",
               "downloaded": 0,
               "genre": "R&B",
               "id": 51848,
               "image_url": "https://s3.amazonaws.com/pool.images/51848.jpg",
               "label": "RCA",
               "modified": 1565632015,
               "release": "Blow My Mind",
               "release_date": "Mon, 12 Aug 2019 00:00:00 GMT",
               "tracks": 4,
               "type": 2
           },
           {
               "artist": "DaVido x Chris Brown",
               "downloaded": 0,
               "genre": "Hip-Hop",
               "id": 51594,
               "image_url": "https://s3.amazonaws.com/pool.images/51594.jpg",
               "label": "RCA",
               "modified": 1564405765,
               "release": "Blow My Mind",
               "release_date": "Mon, 29 Jul 2019 00:00:00 GMT",
               "tracks": 2,
               "type": 2
           }
       ],
       "title_results":
       [
           {
               "artist": "Davido x Chris Brown",
               "bpm": 106,
               "content_warning": true,
               "downloaded": 1,
               "duration": 127,
               "explicit": 0,
               "genre": "Urban",
               "id": 348446,
               "label": "RCA",
               "media": "mp4720,mp4360",
               "mix": "PO Quick Edit*",
               "modified": 1569494530,
               "release": "Hits HD (9-30-2019)",
               "release_img": "https://pomed.promoonly.com/issue_imgs/hits_hd_web.jpg",
               "releaseid": 52787,
               "title": "Blow My Mind",
               "titleid": 612582,
               "type": 1
           },
           {
               "artist": "Davido x Chris Brown",
               "bpm": 106,
               "content_warning": true,
               "downloaded": 1,
               "duration": 217,
               "explicit": 0,
               "genre": "Urban",
               "id": 348445,
               "label": "RCA",
               "media": "mp4720,mp4360",
               "mix": "PO Intro Edit*",
               "modified": 1569494530,
               "release": "Hits HD (9-30-2019)",
               "release_img": "https://pomed.promoonly.com/issue_imgs/hits_hd_web.jpg",
               "releaseid": 52787,
               "title": "Blow My Mind",
               "titleid": 612581,
               "type": 1
           },
           {
               "artist": "Davido x Chris Brown",
               "bpm": 110,
               "content_warning": true,
               "downloaded": 0,
               "duration": 126,
               "explicit": 0,
               "genre": "Hip-Hop",
               "id": 348313,
               "label": "RCA",
               "media": "mp3,m4a,wav",
               "mix": "PO Quick Edit",
               "modified": 1569424932,
               "release": "Express Audio DFF September 2019: Week 4",
               "release_img": "https://pomed.promoonly.com/issue_imgs/0919-ExpAud-wk4_web.png",
               "releaseid": 52616,
               "title": "Blow My Mind",
               "titleid": 612501,
               "type": 2
           }
       ]
   }

Examples

1. PHP (using cURL):

   <?php
       $userid = 1;
       $token = "8b26e1e4f3f5e00a888807e605565c47";
   
       $api_url = "https://api.promoonly.com/qsearch/katy+perry";
   
       $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/qsearch/katy+perry",
       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/qsearch/katy+perry"
   result_return = requests.get(api_url, headers=headers)
   
   print(result_return.text)