User.getArtists

From MeeMixWiki

Contents 1 Overview 2 Request 3 Response 4 Faults

Overview

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

For events 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 artists based on media library created with lib.create.
required	linkType	mediaType (string based)	see linkType for a list of available options.

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:userGetArtistsRequest>
           <partnerId>1001</partnerId>
           <partnerKey>...</partnerKey>
           <userId>jim</userId>
           <libId>1</libId>
           <linkType>event</linkType>
       </q0:userGetArtistsRequest>
   </soapenv:Body>
</soapenv:Envelope>

Response

Data Types:

• Artist

This operation returns an artist recommendations list.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
 <soapenv:Body>
    <ns1:userGetArtistsResponse xmlns:ns1="http://ws.meemix.com/mxws/">
     <artists>
       <artist>
           <artistId>1532</artistId>
           <libArtistId>1532</libArtistId>
           <artistName>Tool</artistName>
           <links>
               <link>
                   <linkId>1096947</linkId>
                   <linkType>event</linkType>
                   <linkData>http://tickets.meemix.com/ResultsTicket.aspx?evtid=1096947
                   </linkData>
               </link>
           </links>
       </artist>
       <artist>
           <artistId>6599</artistId>
           <libArtistId>6599</libArtistId>
           <artistName>Dream Theater</artistName>
           <links>
               <link>
                   <linkId>1035408</linkId>
                   <linkType>event</linkType>
                   <linkData>http://tickets.meemix.com/ResultsTicket.aspx?evtid=1035408
                   </linkData>
               </link>
           </links>
       </artist>
       <artist>
           <artistId>14691</artistId>
           <libArtistId>14691</libArtistId>
           <artistName>Ring of Fire</artistName>
           <links>
               <link>
                   <linkId>1124683</linkId>
                   <linkType>event</linkType>
                   <linkData>http://tickets.meemix.com/ResultsTicket.aspx?evtid=1124683
                   </linkData>
               </link>
           </links>
       </artist>
       <artist>
           <artistId>18045</artistId>
           <libArtistId>18045</libArtistId>
           <artistName>Fates Warning</artistName>
           <links>
               <link>
                   <linkId>1099076</linkId>
                   <linkType>event</linkType>
                   <linkData>http://tickets.meemix.com/ResultsTicket.aspx?evtid=1099076
                   </linkData>
               </link>
           </links>
       </artist>
       ..
       ..        
   </artists>
  </ns1:userGetArtistsResponse>
 </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.