Promo Only Online Web API

The API endpoint will return all years within a given decade where there are tracks that are a part of a specialty release that the POOL user has access to through a purchase, subscription, or give away. The results from this call can be used to pull the tracks that are available for that given year.

URL: https://api.promoonly.com/specialty/years/[DECADE YYYY]
Header: Authorization: Bearer Base64(userid:token)
Method: GET
Returned: JSON

Example JSON Output

[
    {
        "year": 1961
    },
    {
        "year": 1963
    },
    {
        "year": 1964
    },
    {
        "year": 1965
    },
    {
        "year": 1966
    },
    {
        "year": 1967
    },
    {
        "year": 1968
    },
    {
        "year": 1969
    }
]

Examples

PHP (using cURL):

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

    $specialty_url = "https://api.promoonly.com/specialty/years/1990";

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

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

    $specialty_obj = json_decode($specialty_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/specialty/years/1990",
    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}
specialty_url = "https://api.promoonly.com/specialty/years/1990"
result_return = requests.get(specialty_url, headers=headers)

print(result_return.text)

Listings: Specialty Years by Decade

Specialty Years by Decade Specification

Specialty Years by Decade Workflow

Examples