Tracks

Get Tracks

GetTracks returns all Tracks specified in the request body. Returns service details which include one or more track elements.

Request:

POST /gettracks/{serviceToken}

Parameter Type Status
ServiceToken String Mandatory
Request Body XML Mandatory

 

Request body

The following are mandatory for a POST request

<tracks
returnalternateversions="true"
returncategoryfacet="true"
returnattributes="true"
returncodes="true"
cuesheetonlycodesandattribute="false"
returnrelatedtracks="true"
returncategories="true"
returninactivetracks="false"
returnrightholders="true"
getmainversionfromalternate="false"
offset="0"
limit="100"
>


returnrightholders 
includes writers and publishers in the response. By default this is set to false.

returnalternateversions includes alternate versions in the response. By default this is set to false.

getmainversionfromalternate always return the main track. By default this is set to false.

returncategoryfacet includes a list of categories with track count in the response. By default this is set to false.

returnattributes includes a list of attributes in the response. By default this is set to false.

returncodes includes a list of codes in the response. By default this is set to false.

cuesheetonlycodesandattribute limit codes and attributes to items flagged for cuesheet only. By default this is set to false.

returncategories includes a list of categories in the response. By default this is set to false.

returnrelatedtracks includes a list of related tracks in the response. By default this is set to false.

returninactivetracks includes a inactive tracks in the response. By default this is set to false.

offset optional, skip a number of results

limit optional, a number of results to return

<track>dfc2bdb69617bc8d</track>
<track>ee1b9ff0e30dd9a8</track>
This element should contain the trackID. 
 </tracks>  
   

Hidden:
  • returntopplaylist, not implemented
  • fulldetail:  deprecated - The “fulldetail” attribute indicates whether to return the full detailed information for each track. This includes alternate versions, related tracks and category associations. By default this is set to false.
     

Successful Response

<responsetracks><tracks>

 

<track tracknumber="003" time="03:32" lengthseconds="212" comment="Mainstream electro pop with pumping half-time beats and female vocal lead." composer="Richard P. Craker (PRS) and Christopher C. Porter (PRS)" publisher="West One Music Limited" name="Shine a Light On Me" albumid="273000000000096e" libraryid="47000000000092" id="9960000000005" keywords="" lyrics="Found you down on your luck again&#xA;Smashing clocks and counting down from ten &#xA;Throwing your arms around the world &#xA;Trying to make it all fit &#xA;I gotta know what it's doing to you&#xA;&#xA;Boy, you know you got your head in your hands &#xA;And you're feeling it bad again &#xA;Don't you know &#xA;Get over, get over the poison &#xA;Leave a little more room for the light &#xA;&#xA;Shine a light&#xA;Shine a light&#xA;Baby, shine a light&#xA;Shine a light, yeah&#xA;&#xA;There's a long way to go again&#xA;Building bridges for the way back home&#xA;Hiding your pain behind your eyes&#xA;Trying to make it all quit&#xA;I gotta know what it's doing to you&#xA;&#xA;Boy, you know you got your head in your hands &#xA;And you're feeling it bad again &#xA;Don't you know &#xA;Get over, get over the poison &#xA;Leave a little more room for the light &#xA;&#xA;Shine a light&#xA;Shine a light&#xA;Baby, shine a light&#xA;Shine a light, yeah&#xA;&#xA;Shine a light, yeah&#xA;&#xA;Shine&#xA;&#xA;Shine a light&#xA;Shine a light&#xA;Baby, shine a light&#xA;Shine a light, yeah&#xA;&#xA;Shine&#xA;" displaytitle="Shine a Light On Me (a)" alternatetitle="" genre="Pop" tempo="" instrumentation="ELECTRONIC, VOCALS, FEMALE, FEMALE" bpm="75" mixout="" frequency="0" bitrate="0" dateingested="2017-08-08 23:37:03" version="Main" status="active" cdcode="WOM 440" albumname="WOM 440 Billboard Pop" libraryname="West One Music" filename="WOM_440_trk003_SHINE_A_LIGHT_ON_ME_(A)_Richard_P._Craker_(PRS)_and_Christopher_C._Porter_(PRS)_West_One_Music_Limi.wav" alternatecount="5">

<alternatetracks>

<track dateingested=”2012-04-10 09:33:35″ bitrate=”0″ frequency=”48000″ mixout=”N/A” bpm=”" instrumentation=”" tempo=”" genre=”Dance, Pop, Pop: Dance, Showbiz, Showbiz: Glamour/Fashion” displaytitle=”Light All Night (Background)” lyrics=”" id=”a2c07f3XXX8c31b3″ albumid=”b6e3554d117e1b99″ name=”Light All Night (Background)” publisher=”VideoHelper” composer=”Joseph Saba (ASCAP), Stewart Winter (ASCAP)” comment=”Each instrument takes its turn rappin’ on the mic. (That is a technical term.) The heavy beat only drops out three times – for pretty synth arpeggios @:42, for distorted guitars @1:15, and at the end when it’s replaced with hi-hat.” lengthseconds=”133″ time=”02:13″ tracknumber=”054″ filesize=”" version=”FullVersion” lastupdated=”2013-02-11 12:29:18″/>

<track version=”N/A” dateingested=”2012-04-10 09:33:35″ bitrate=”0″ frequency=”48000″ mixout=”N/A” bpm=”" instrumentation=”" tempo=”Medium” genre=”Dance, Pop, Pop: Dance, Showbiz, Showbiz: Glamour/Fashion” displaytitle=”Light All Night (Alternate)” lyrics=”" id=”175fcf38709aace4″ albumid=”b6e355XXXe1b99″ name=”Light All Night (Alternate)” publisher=”VideoHelper” composer=”Joseph Saba (ASCAP), Stewart Winter (ASCAP)” comment=”This version starts with 10 seconds of distorted guitar effects guaranteed to give you a flashback from that one concert you went to when you did those things to those things. Things get minimalist @:43, and there’s another psychedelic guitar freakout @1:37-1:51 before the melody returns abruptly @1:51.” lengthseconds=”141″ time=”02:21″ tracknumber=”055″ filesize=”"version=”FullVersion” lastupdated=”2013-02-11 12:29:18″/>

</alternatetracks>

<categories>
<category id=”9e4d309XXX51779″ name=”Moods”>
<attributes>
<attribute id=”cf83ad1f8XXX1c15″ name=”Carefree”/>
<attribute id=”05965XXX797cda32″ name=”Fun”/>
<attribute id=”77d84XXXdd593d46″ name=”Rowdy”/>
<attribute id=”14eXXX457e82daa4″ name=”Confident”/>
<attribute id=”6e1693XXX8ebaf71″ name=”Swagger”/>
<attribute id=”b3c2827ed9XXX87a” name=”Anticipation”/>
<attribute id=”6543eXXXb6d6af72″ name=”Happy”/>
<attribute id=”ff5dc9cdbdXXX08e” name=”Hi-Energy”/>
</attributes>
</category>

<category id=”0dabXXXe6f7b545″ name=”Scenarios”>
<attributes>
<attribute id=”2b926XXX6c349659″ name=”Commercials”>
<attributes>
<attribute id=”269daXXXf081fb83″ name=”Chick Stuff”>
<attributes>
<attribute id=”fd190fXXX9d342d8″ name=”Silky Hair Sells”/>
</attributes>
</attribute>
<attribute id=”d44decdXXXdabcd0″ name=”Super Awesome Products!”/>
</attributes>
</attribute><attribute id=”86e6XXXbff49ac21″ name=”Movie/TV Cliches”>
</categories>

</track>
</tracks>
</responsetracks>

Error Response:

<responsetracks>

 

<error>

<code>5</code>

<description>Invalid Token</description>

</error>

</responsetracks>

 

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

Please sign in to leave a comment.