Preferences: Get Format Filters

POOL users can filter their feed by format. This endpoint returns the formats filters that are currently set for the given POOL user.

Get Format Filters Specification

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

Get Format Filters Workflow

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

    Example JSON Output

    [
        {
            "format": "Mainstream Radio",
            "id": 15,
            "select": 0
        },
        {
            "format": "Rhythm Radio",
            "id": 31,
            "select": 0
        },
        {
            "format": "Urban Radio",
            "id": 16,
            "select": 0
        },
        {
            "format": "Modern Rock Radio",
            "id": 18,
            "select": 0
        },
        {
            "format": "Country Radio",
            "id": 17,
            "select": 0
        },
        {
            "format": "Dance Radio",
            "id": 38,
            "select": 0
        },
        {
            "format": "Mainstream Club",
            "id": 19,
            "select": 0
        },
        {
            "format": "Urban Club",
            "id": 24,
            "select": 0
        }
    ]

Examples

  1. PHP (using cURL):

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

        $api_url = "https://api.promoonly.com/user/format_filters";

        $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/user/format_filters",
        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/user/format_filters"
    result_return = requests.get(api_url, headers=headers)

    print(result_return.text)