Preferences: Get Media Filters

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

Get Media Filters Specification

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

Get Media Filters Workflow

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

    Example JSON Output

    [
        {
            "filter": "Audio",
            "hide": 0,
            "mode": "hide_audio",
            "type": "media"
        },
        {
            "filter": "HD Video",
            "hide": 0,
            "mode": "hide_hd",
            "type": "media"
        },
        {
            "filter": "Specialty",
            "hide": 0,
            "mode": "hide_specialty",
            "type": "media"
        },
        {
            "filter": "Hide Content with a Warning",
            "hide": 0,
            "mode": "hide_content_warn",
            "type": "misc"
        },
        {
            "filter": "Hide Content marked as Explicit",
            "hide": 0,
            "mode": "hide_explicit",
            "type": "misc"
        },
        {
            "filter": "Hide all single releases",
            "hide": 0,
            "mode": "hide_singles",
            "type": "misc"
        },
        {
            "filter": "Show only audio singles",
            "hide": 0,
            "mode": "show_only_singles",
            "type": "misc"
        }
    ]

Examples

  1. PHP (using cURL):

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

        $api_url = "https://api.promoonly.com/user/media_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/media_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/media_filters"
    result_return = requests.get(api_url, headers=headers)

    print(result_return.text)