Promo Only Online Web API

This is one of four ways to display POOL distribution paginated by date. This view will show all available genres arranged in order by date, in a paginated view. The default view will show 15 dates in descending order (most recent dates displayed first).

URL: https://api.promoonly.com/genres/date/[PAGE_NUMBER]/[START_DATE (optional)]/[FORMAT_ID (optional)/[COUNT (optional)]
Header: Authorization: Bearer Base64(userid:token)
Method: GET
Returned: JSON

Example JSON Output

[
    {
        "date": "2020-04-08",
        "genres":
        [
            {
                "date": "2020-04-08",
                "downloads": 0,
                "genre": "Alternative",
                "tracks": 1
            },
            {
                "date": "2020-04-08",
                "downloads": 0,
                "genre": "AlternRock",
                "tracks": 5
            },
            {
                "date": "2020-04-08",
                "downloads": 0,
                "genre": "Country",
                "tracks": 10
            },
            {
                "date": "2020-04-08",
                "downloads": 0,
                "genre": "Dance",
                "tracks": 19
            }
        ],
        "ts": 1586304000
    },
    {
        "date": "2020-04-07",
        "genres":
        [
            {
                "date": "2020-04-07",
                "downloads": 6,
                "genre": "Alternative",
                "tracks": 9
            },
            {
                "date": "2020-04-07",
                "downloads": 4,
                "genre": "Country",
                "tracks": 8
            },
            {
                "date": "2020-04-07",
                "downloads": 0,
                "genre": "Dance",
                "tracks": 8
            }
        ],
        "ts": 1586217600
    }
]

Examples

PHP (using cURL):

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

    $date_genres_url = "https://api.promoonly.com/genres/date/1";

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

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

    $date_genres_obj = json_decode($date_genres_result);
?>
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/genres/date/1",
    headers: { "Authorization": auth_str },
    dataType: "json",
    success: function (data)
    {
        console.log(data);
    }
});
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}
date_genres_url = "https://api.promoonly.com/genres/date/1"
result_return = requests.get(date_genres_url, headers=headers)

print(result_return.text)

Listings: View Genres by Date - Paginated

View Genres by Date - Paginated Specification

View Genres by Date - Paginated Workflow

Examples