User.getTracks

From MeeMixWiki

Contents 1 Overview 2 Request 3 Response 4 Faults

Overview

Get personalized track recommendations for the user, based on their profile.

For ringtones, videos or any other links recommendations, use the linkType parameter.

Request

Parameters:

Required	Name	Type	Description
required	partnerId	string	your assigned partner ID.
required	partnerKey	string	your assigned 32-character partner key.
required	userId	string	unique user ID.
optional	libId	string	search the track on media library created with lib.create.
required	linkType	String	see linkType.

SOAP request example:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
   xmlns:q0="http://ws.meemix.com/mxws/" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
   xmlns:xsi="http://www.w3.org/2001/XMLSchemainstance">
   <soapenv:Body>
       <q0:userGetTracksRequest>
           <partnerId>1001</partnerId>
           <partnerKey>...</partnerKey>
           <userId>jim</userId>
           <libId>1</libId>
           <linkType>ringtone</linkType>
       </q0:userGetTracksRequest>
   </soapenv:Body>
</soapenv:Envelope>

Response

Data Types:

• Track

This operation returns a track recommendations list.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soapenv:Body>
       <userGetTracksResponse xmlns:ns1="http://ws.meemix.com/mxws/">
          <tracks>
       <track>
           <trackId>1439704</trackId>
           <libTrackId>1439704</libTrackId>
           <trackName>Almost Lover</trackName>
           <duration>269</duration>
           <artist>
               <artistId>28397</artistId>
               <libArtistId>28397</libArtistId>
               <artistName>A Fine Frenzy</artistName>
               <links xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                   xsi:nil="1" />
           </artist>
           <album>
               <albumId>94765</albumId>
               <albumName>One Cell In the Sea</albumName>
           </album>
           <links>
               <link>
                   <linkId>411509</linkId>
                   <linkType>video</linkType>
                   <linkData>http://www.youtube.com/v/EDEEzS7OV2k&f=videos&app=youtube_gdata
                   </linkData>
               </link>
               <link>
                   <linkId>517916</linkId>
                   <linkType>ringtone</linkType>
                   <linkData>http://offers.thumbplay.com/offers/Open_Artist_6817/atb3ringtones?thptitle=Almost+Lover&selectedContent=517916&thpartist=A+Fine+Frenzy
                   </linkData>
               </link>
           </links>
       </track>
       <track>
           <trackId>581581</trackId>
           <libTrackId>581581</libTrackId>
           <trackName>Suzanne</trackName>
           <duration>258</duration>
           <artist>
               <artistId>2527</artistId>
               <libArtistId>2527</libArtistId>
               <artistName>Leonard Cohen</artistName>
               <links>
                   <link>
                       <linkId>1111792</linkId>
                       <linkType>event</linkType>
                       <linkData>http://tickets.meemix.com/ResultsTicket.aspx?evtid=1111792
                       </linkData>
                   </link>
               </links>
           </artist>
           <album>
               <albumId>38722</albumId>
               <albumName>Cohen Live</albumName>
           </album>
           <links>
               <link>
                   <linkId>553473</linkId>
                   <linkType>ringtone</linkType>
                   <linkData>http://offers.thumbplay.com/offers/Open_Artist_6817/atb3ringtones?thptitle=Suzanne&selectedContent=553473&thpartist=Leonard+Cohen
                   </linkData>
               </link>
               <link>
                   <linkId>327741</linkId>
                   <linkType>video</linkType>
                   <linkData>http://www.youtube.com/v/30egIKHT-pM&f=videos&app=youtube_gdata
                   </linkData>
               </link>
           </links>
       </track>
       <track>
           <trackId>16593</trackId>
           <libTrackId>16593</libTrackId>
           <trackName>Enterlude</trackName>
           <duration>50</duration>
           <artist>
               <artistId>720</artistId>
               <libArtistId>720</libArtistId>
               <artistName>The Killers</artistName>
               <links>
                   <link>
                       <linkId>1103825</linkId>
                       <linkType>event</linkType>
                       <linkData>http://tickets.meemix.com/ResultsTicket.aspx?evtid=1103825
                       </linkData>
                   </link>
               </links>
           </artist>
           <album>
               <albumId>1271</albumId>
               <albumName>Sam's Town</albumName>
           </album>
           <links>
               <link>
                   <linkId>221536</linkId>
                   <linkType>video</linkType>
                   <linkData>http://www.youtube.com/v/oC3bb4bZ79I&f=videos&app=youtube_gdata
                   </linkData>
               </link>
               <link>
                   <linkId>517843</linkId>
                   <linkType>ringtone</linkType>
                   <linkData>http://offers.thumbplay.com/offers/Open_Artist_6817/atb3ringtones?thptitle=Enterlude&selectedContent=517843&thpartist=The+Killers
                   </linkData>
               </link>
           </links>
       </track>
       ..
       ..
       ..        
   </tracks>
       </userGetTracksResponse>
   </soapenv:Body>
</soapenv:Envelope>

Faults

Code	Description
1	Invalid partner ID
2	Invalid partner key
4	Invalid user ID
15	Internal server error

For a full faults list and example of soapFault please visit the Faults page.