Charts: List Available Charts

As POOL users subscribe to more and more packages, they gain access to more and more charts. Charts are comprised of tracks that are constantly updated to reflect what is popular for their corresponding categories. Once an account has access to a chart, all tracks can be downloaded that are in the chart. This API call will return information for all charts that are available to the POOL account.

List Available Charts Specification:

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

List Available Charts Work Flow

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

    Example JSON Output:

    [
        {
            "chart": "Dance/Club",
            "formatid": 89,
            "id": 25119,
            "img": "http://pomed.promoonly.com/issue_imgs/25119_chart.jpg",
            "updated":"2020-04-03"
        },
        {
            "chart": "Latin Top 20",
            "formatid": 89,
            "id": 25114,
            "img": "http://pomed.promoonly.com/issue_imgs/25114_chart.jpg",
            "updated": "2020-04-01"
        },
        {
            "chart": "Urban Top 20",
            "formatid": 89,
            "id": 25109,
            "img": "http://pomed.promoonly.com/issue_imgs/25109_chart.jpg",
            "updated": "2020-04-01"
        },
        {
            "chart": "Mainstream Top 20",
            "formatid": 89,
            "id": 24200,
            "img": "http://pomed.promoonly.com/issue_imgs/24200_chart.jpg",
            "updated": "2020-04-01"
        }
    ]

Examples

  1. PHP (using cURL):

    <?php
        $userid = 1;
        $token = "8b26e1e4f3f5e00a888807e605565c47";
        $charts_url = "https://api.promoonly.com/charts";

        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $charts_url);
        curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: Bearer ".base64_encode($userid.":".$token)));
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

        $charts_result = curl_exec($ch);
        curl_close($ch);

        $sync_obj = json_decode($charts_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/charts",
        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}
    charts_url = "https://api.promoonly.com/charts"
    result_return = requests.get(charts_url, headers=headers)

    print(result_return.text)