Getting Started

• Overview
• API URL's
• API Libraries
• Resources
• Open Source Applications

API Methods

• Authentication
  • login
  • logout
• Locker Data
  • accountData
  • createAccount
  • lastUpdate
  • lockerData
  • lockerSearch
  • lockerFileExists
  • lockerStats
• Playlists
  • playlistAdd
  • playlistDelete
  • playlistEdit
  • playlistTrackAdd
  • playlistTrackDelete
  • playlistTrackReorder
• Locker Storage
  • albumArtGet
  • lockerDelete
  • lockerGet
  • lockerPut
  • lockerPlay

lockerStats

Provide various information for a users locker, such as recently played tracks, recently added tracks, etc. lockerStats calls are unique in that they do not require authentication and they do not provide streaming URL's or download URL's.

Parameters

partner_token (required): A valid partner token. See Overview for more information.
user (required): The username / email address of an MP3tunes user to retrieve stats for.
type (required): Specifies the type of data to return. Currently, the only supported type is "track".
filter (required): Specifies the type of statistics to filter the data on and return. Currently supports 'recently_added' and 'recently_played'
count (Optional): Maximum number of results to be returned in a result set between 1 and 50.
output (Optional): Your preferred output format. These include xml, and json.

Example Request (Get recently played tracks):

http://ws.mp3tunes.com/api/v1/lockerStats?output=xml&sid=<sid>&partner_token=9999999999
&type=track&filter=recently_played

Example Response:

  
    
      27767214
      Creation Myth
      9
      140049.27960049
      2660822
      Map Of Africa
      636202
      Map Of Africa
      1244014662

    
    
      27767211
      Dirty Lovin
      8
      194759.87083342
      2660822
      Map Of Africa
      636202
      Map Of Africa
      1244014619
    
    ...