lockerSearch

Allows for searching a user's locker for specific artist, album or track content. Any combination of an artist, album, or track search can be executed in a single request.

Parameters

sid (required): A valid session id, received from the "login" method.
partner_token (required): A valid partner token. See Overview for more information.
type (required): Type options consist of "artist", "album", or "track". Any combination of comma separated type values can be passed in a single request.
s (required): The URL-encoded string to use in the search.
count (optional): Maximum number of results to be returned in a result set.
set (optional): The result set number to retrieve, note that set numbers are 0 based.
result_data_level (optional): The amount of data to return for each type. Valid values are "min" and "max". Default is "min" which returns only the matching artist, album or track information. If set to "max" artist results will contain album/track data and album results will contain track data.
output (Optional): Your preferred output format. These include xml, and json.

Example Request (searching for artists containing "wave" in the artist name):

http://ws.mp3tunes.com/api/v1/lockerSearch?output=xml&sid=<sid>&partner_token=9999999999
&type=artist&s=wave

Example Response:


  
    artist
    
      1
    
  
  
    
      2905
      Katrina & The Waves
      6317621
      1
      1

Example Request (searching for artists, albums or tracks containing "wave", max of 50 results per set):

http://ws.mp3tunes.com/api/v1/lockerSearch?output=xml&sid=<sid>&partner_token=9999999999
&type=artist,album,track&s=wave&count=50&set=0

Example Response:


  
    artist,album,track
    
      1
      2
      4
    
    0
    50
    1
  
  
    
      2905
      Katrina & The Waves
      6317621
      1
      1
    
  
  
    
      68540
      Permanent Waves
      733
      Rush
      1
      4403605
      
      
      0
    
    
      20968
      Wave
      5620
      Antonio Carlos Jobim
      2
      76175514
      
      
      0
    
  
  
    
      8271292
      Even the Waves
      0
      393020.1875
      Even_the_Waves.mp3
      fad1efc63f6915e6f888b907c00f9066
      6288323
      http://ws.mp3tunes.com/storage/lockerget/fad1efc63f6915e6f888b907c00f9066?sid=[session ID]&partner_token=
      http://ws.mp3tunes.com/storage/lockerplay/fad1efc63f6915e6f888b907c00f9066?sid=[session ID]&partner_token=
      1321138
      Unknown
      
      21
      Chroma Key
    
    
      57913
      Wave
      1
      177035.225
      01 Wave.mp3
      a891bcde3f823884e82868131444001b
      7081409
      http://ws.mp3tunes.com/storage/lockerget/a891bcde3f823884e82868131444001b?sid=[session id]&partner_token=
      http://ws.mp3tunes.com/storage/lockerplay/a891bcde3f823884e82868131444001b?sid=[session id]&partner_token=
      20968
      Wave
      1967
      5620
      Antonio Carlos Jobim
    
    
      310
      Wave
      6
      
      06 Wave.mp3
      c51c72a04bea699e65af21342a67aa52
      6394810
      http://ws.mp3tunes.com/storage/lockerget/c51c72a04bea699e65af21342a67aa52?sid=[session ID]&partner_token=
      http://ws.mp3tunes.com/storage/lockerplay/c51c72a04bea699e65af21342a67aa52?sid=[session ID]&partner_token=
      43
      Soft & Mellow
      1978
      31
      Herb Ellis