Search: Web Search

This endpoint allows you to search POOL for specific content. Media Mode option will allow your search results to be specific media types.

Web Search Specification

Parameters: Header variables:
  1. userid: integer
  2. token: string
JSON list returned:

Web Search Workflow

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

    Example JSON Output

    {
        "message": "Search field results: Keyword search set.",
        "results_found": 3,
        "search_method": "ts",
        "search_results":
        [
            {
                "artist": "Blake Shelton Duet With Gwen Stefani",
                "bpm": 72,
                "content_warning": false,
                "duration": 193,
                "end": "Cold",
                "explicit": 0,
                "genre": "Country",
                "id": 366434,
                "label": "Warner",
                "media": "mp4720,mp4360",
                "mix": "",
                "modified": 1582233739,
                "release": "Country Video March 2020",
                "release_date": "Thu, 20 Feb 2020 00:00:00 GMT",
                "releaseid": 54767,
                "title": "Nobody But You",
                "titleid": 621431,
                "track_order": 1
            },
            {
                "artist": "Blake Shelton Duet With Gwen Stefani",
                "bpm": 72,
                "content_warning": false,
                "duration": 192,
                "end": "Cold",
                "explicit": 0,
                "genre": "Country",
                "id": 364888,
                "label": "Warner",
                "media": "mp4720,mp4360",
                "mix": "Lyric Video",
                "modified": 1581003741,
                "release": "Express Video February 2020: Week 2",
                "release_date": "Thu, 06 Feb 2020 00:00:00 GMT",
                "releaseid": 55154,
                "title": "Nobody But You",
                "titleid": 621949,
                "track_order": 21
            },
            {
                "artist": "Blake Shelton Duet With Gwen Stefani",
                "bpm": 72,
                "content_warning": false,
                "duration": 193,
                "end": "Cold",
                "explicit": 0,
                "genre": "Country",
                "id": 362517,
                "label": "Warner",
                "media": "mp4720,mp4360",
                "mix": "",
                "modified": 1580248929,
                "release": "Express Video February 2020: Week 1",
                "release_date": "Tue, 28 Jan 2020 00:00:00 GMT",
                "releaseid": 54998,
                "title": "Nobody But You",
                "titleid": 621431,
                "track_order": 22
            }
        ]
    }

Examples

  1. PHP (using cURL):

    <?php
        $userid = 1;
        $token = "8b26e1e4f3f5e00a888807e605565c47";

        $api_url = "https://api.promoonly.com/search/web/gwen+stefani/3";

        $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/search/web/gwen+stefani/3",
        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/search/web/gwen+stefani/3"
    result_return = requests.get(api_url, headers=headers)

    print(result_return.text)