Listings: Specialty Series

This endpoint uses the series ID pulled from Specialty Series List to return all of the relevent specialty releases that a user has access to that fall under the given category. Below is a list of specialty series and their corresponding IDs.

  1. All Time Party Classics
  2. Alternative Dance
  3. Alternative Rock
  4. Best of 80's
  5. Best of 90's
  6. Best of 00's
  7. Best of 10's
  8. Christmas
  9. Best ofCountry
  10. Dance
  11. EDM
  12. Hair Bands
  13. Intro Edits
  14. Island Sounds
  15. Kid's Pop
  16. Love Songs
  17. New Year's Eve
  18. Old Skool
  19. Reggaeton
  20. Rink Essentials
  21. Spooky Videos
  22. Summer Jams
  23. Tropical Latin
  24. Urban Mix

Specialty Series Specification

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

Specialty Series Workflow

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

    Example JSON Output

    [
        {
            "downloaded": 1,
            "id": 2259,
            "modified": 1462292874,
            "release": "Alternative Dance 80-83 Vol. 1",
            "release_date": "2012-07-24",
            "release_image": "https://pomed.promoonly.com/issue_imgs/ALTDANCE_80-83_500.png",
            "tracks": 39
        },
        {
            "downloaded": 0,
            "id": 3860,
            "modified": 1462292816,
            "release": "Alternative Dance 87-89 Vol. 2",
            "release_date": "2012-07-26",
            "release_image": "https://pomed.promoonly.com/issue_imgs/ALTDANCE_87-89V2_500.png",
            "tracks": 41
        },
        {
            "downloaded": 40,
            "id": 48434,
            "modified": 1574366550,
            "release": "Best Of Alternative Dance Vol. 1",
            "release_date": "2019-12-02",
            "release_image": "https://pomed.promoonly.com/issue_imgs/Alt_Dance_V1_600.png",
            "tracks": 40
        }
    ]

Examples

  1. PHP (using cURL):

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

        $specialty_url = "https://api.promoonly.com/specialty/series/2";

        $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);
    ?>

  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/specialty/series/2",
        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}
    specialty_url = "https://api.promoonly.com/specialty/series/2"
    result_return = requests.get(specialty_url, headers=headers)

    print(result_return.text)