Downloads: Download History

There are 2 different modes for retrieving download history: paginated (set number of history results per page) and by date (some dates can be blank if no downloads occurred). The 2 different history modes are different API endpoints, this page will overview both modes.

Download History: Paginated Specification

Parameters:

URL: https://api.promoonly.com/download/history/[PAGE_NUMBER]/[MEDIA_TYPE (optional)/[VIEW_MODE (optional)]
Call Type: GET
Header encoding: Base64
Data return format: JSON

Header variables:

userid: integer
token: string

View Mode (Track) Data list returned:

date: Integer (Unix Timestamp)
trackid: Integer
titleid: Integer
releaseid: Integer
downloads: Integer
file_format: String
artist: String
title: String
mix: String
release: String

View Mode (Release) Data list returned:

date: Integer (Unix Timestamp)
releaseid: Integer
downloads: Integer
file_format: String
artist: String
release: String
media_type: Integer

Download History: Paginated Workflow

URL: https://api.promoonly.com/download/history/PAGE_NUMBER/MEDIA_TYPE/VIEW_MODE
Header: Authorization: Bearer Base64(userid:token)
Method: GET
PAGE_NUMBER: Integer page, most recent download history is 1
MEDIA_TYPE (optional): 0 = all downloads, 1 = video downloads, 2 = audio downloads
VIEW_MODE (optional): 1 = tracks, 2 = releases
Returned: JSON

Example JSON Output for PAGE_NUMBER=1, MEDIA_TYPE=0, VIEW_MODE=1:

{
    "Count": 100,
    "Downloads":
    [
        {
            "artist": "Thalia & Mau Y Ricky",
            "date": "1583517351",
            "downloads": 6,
            "file_format": "mp3",
            "media_type": 2,
            "release": "Ya Tu Me Conoces",
            "releaseid": 55515
        },
        {
            "artist": "Sam Fischer",
            "date": "1583517333",
            "downloads": 1,
            "file_format": "mp3",
            "media_type": 2,
            "release": "This City",
            "releaseid": 55514
        },
        {
            "artist": "Mc Ceja",
            "date": "1583515291",
            "downloads": 5,
            "file_format": "mp3",
            "media_type": 2,
            "release": "Mastika",
            "releaseid": 55516
        },
        {
            "artist": "Natti Natasha",
            "date": "1583515267",
            "downloads": 1,
            "file_format": "mp3",
            "media_type": 2,
            "release": "Me Estas Matando",
            "releaseid": 55520
        }
    ]
}

Examples

PHP (using cURL):

<?php
    $userid = 1;
    $token = "8b26e1e4f3f5e00a888807e605565c47";
    $history_url = "https://api.promoonly.com/download/history/1";

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

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

    $history_obj = json_decode($history_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/download/history/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}
history_url = "https://api.promoonly.com/download/history/1"
result_return = requests.get(history_url, headers=headers)

print(result_return.text)

Download History: Date Specification

Parameters:

URL: https://api.promoonly.com/download/history_date/[DATE (YYYY-MM-DD)]/[MEDIA_TYPE (optional)/[VIEW_MODE (optional)]
Call Type: GET
Header encoding: Base64
Data return format: JSON

Header variables:

userid: integer
token: string

View Mode (Track) Data list returned:

date: Integer (Unix Timestamp)
trackid: Integer
titleid: Integer
releaseid: Integer
downloads: Integer
file_format: String
artist: String
title: String
mix: String
release: String

View Mode (Release) Data list returned:

date: Integer (Unix Timestamp)
releaseid: Integer
downloads: Integer
file_format: String
artist: String
release: String
media_type: Integer

Download History: Date Workflow

URL: https://api.promoonly.com/download/history_date/DATE/MEDIA_TYPE/VIEW_MODE
Header: Authorization: Bearer Base64(userid:token)
Method: GET
DATE: YYYY-MM-DD format
MEDIA_TYPE (optional): 0 = all downloads, 1 = video downloads, 2 = audio downloads
VIEW_MODE (optional): 1 = tracks, 2 = releases
Returned: JSON

Example JSON Output for PAGE_NUMBER=1, MEDIA_TYPE=0, VIEW_MODE=1:

{
    "Count": 100,
    "Downloads":
    [
        {
            "artist": "Thalia & Mau Y Ricky",
            "date": "1583517351",
            "downloads": 6,
            "file_format": "mp3",
            "media_type": 2,
            "release": "Ya Tu Me Conoces",
            "releaseid": 55515
        },
        {
            "artist": "Sam Fischer",
            "date": "1583517333",
            "downloads": 1,
            "file_format": "mp3",
            "media_type": 2,
            "release": "This City",
            "releaseid": 55514
        },
        {
            "artist": "Mc Ceja",
            "date": "1583515291",
            "downloads": 5,
            "file_format": "mp3",
            "media_type": 2,
            "release": "Mastika",
            "releaseid": 55516
        },
        {
            "artist": "Natti Natasha",
            "date": "1583515267",
            "downloads": 1,
            "file_format": "mp3",
            "media_type": 2,
            "release": "Me Estas Matando",
            "releaseid": 55520
        }
    ]
}

Examples

PHP (using cURL):

<?php
    $userid = 1;
    $token = "8b26e1e4f3f5e00a888807e605565c47";
    $history_url = "https://api.promoonly.com/download/history_date/2020-04-06";

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

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

    $history_obj = json_decode($history_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/download/history_date/2020-04-06",
    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}
history_url = "https://api.promoonly.com/download/history_date/2020-04-06"
result_return = requests.get(history_url, headers=headers)

print(result_return.text)