HELP CENTER
Learn the API request choreography to access the /KARAOKE Master List
The Master List is a list of karaoke recordings that are known to be cleared for use in your application(s) at the time the Master List is downloaded. The Master List is updated every hour with the idea you'll add or remove karaoke recordings from your offering accordingly.

Accessing the Master List is a two-part process.
Using your unique API key, you'll request a temporary signed URL link to the Master List. Here, we've used the public sandbox key; feel free to give it a try.

[
    {
        "ca": null,
        "qs": [],
        "url": "https://sandbox-api.karaoke.crossclear.com/api/v1/apps/repertoire/download",
        "data": null,
        "gzip": true,
        "method": "get",
        "headers": [
            {
                "name": "Authorization",
                "value": "Bearer zRlxOX0v811PBWbQ8aaXtC0AT38Hxxi5audX30Zi7/E9cCIllClGctsFMdsFg4Zun1LG6ef2w21QQgIMQ9XpwgNTYTQa94fPLvMqELLKa0ACCf9tcuYy5ukP6FYBDtOQMte2u5baBjug6yhGM2+kV50xfl85ozRu"
            }
        ],
        "timeout": null,
        "authPass": null,
        "authUser": null,
        "bodyType": "raw",
        "contentType": "application/json",
        "shareCookies": false,
        "parseResponse": true,
        "followRedirect": true,
        "useQuerystring": false,
        "followAllRedirects": false,
        "rejectUnauthorized": true
    }
]
Using the signed URL provided back from Step 1, download the Master List.

[
    {
        "ca": null,
        "qs": [],
        "url": "https://cross-karaoke-dev.s3.amazonaws.com/sandbox/repertoire/78729452-1bb6-5415-ab59-41310f652b74/2019-09-30--18-07-00/repertoire.json?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJJCLPN5AVSP3YQGQ%2F20200604%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20200604T233752Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=dcb792b0f275fb8581c28a85ecd876de34d324b8461f0a67cfb1521e9f176963",
        "data": null,
        "gzip": true,
        "method": "get",
        "headers": [],
        "timeout": null,
        "authPass": null,
        "authUser": null,
        "bodyType": "raw",
        "contentType": "text/plain",
        "shareCookies": false,
        "parseResponse": false,
        "followRedirect": true,
        "useQuerystring": false,
        "followAllRedirects": false,
        "rejectUnauthorized": true
    }
]
The Master List will be a JSON file in Newline Delimited format (http://ndjson.org), and will be an array of collections, each representing one Mix of a recording. There are up to three mixes available for each recording:

a) Performance - This is the standard karaoke mix with no lead vocals, but includes background vocals.

b) Full Stereo - This mix includes the music and lead vocals; typically used for demonstration.

c) Instrumental - This mix is music only (no lead or background vocals).

{"cross_id":"CCMR-454838-MQRV","name":"I Love To Tell The Story","year":null,"in_style_of":"Traditional","mix_type":"Performance","studio_recording_ids":{"isrc":"US-K4W-07-28662","stingray_id":"10183-PM"},"studio_mix_group_ids":{"stingray_group_id":"10183"}}
The cross_id is a Mix level identification that should be stored in your system for potential coordination and communication between your system and ours. An example would be sending transactions for royalty accounting report generation.

The studio_recording_ids and studio_mix_group_ids should be used to map mixes of the same recording together and to map your system to the actual karaoke file stored on your server.
For more detailed information review the API Documentation:
https://developers.crossclear.com/