API Doc
- Overview
- User Authentication
- Scrobbling
- Radio API
- Playlists
- Downloads
- REST requests
- XML-RPC requests
- Error codes
- Terms of Service
API Methods
- Album
- album.addTags
- album.getBuylinks
- album.getInfo
- album.getShouts
- album.getTags
- album.getTopTags
- album.removeTag
- album.search
- album.share
- Artist
- artist.addTags
- artist.getCorrection
- artist.getEvents
- artist.getInfo
- artist.getPastEvents
- artist.getPodcast
- artist.getShouts
- artist.getSimilar
- artist.getTags
- artist.getTopAlbums
- artist.getTopFans
- artist.getTopTags
- artist.getTopTracks
- artist.removeTag
- artist.search
- artist.share
- artist.shout
- Auth
- Chart
- chart.getHypedArtists
- chart.getHypedTracks
- chart.getLovedTracks
- chart.getTopArtists
- chart.getTopTags
- chart.getTopTracks
- Event
- Geo
- geo.getEvents
- geo.getMetroArtistChart
- geo.getMetroHypeArtistChart
- geo.getMetroHypeTrackChart
- geo.getMetroTrackChart
- geo.getMetroUniqueArtistChart
- geo.getMetroUniqueTrackChart
- geo.getMetroWeeklyChartlist
- geo.getMetros
- geo.getTopArtists
- geo.getTopTracks
- Group
- group.getHype
- group.getMembers
- group.getWeeklyAlbumChart
- group.getWeeklyArtistChart
- group.getWeeklyChartList
- group.getWeeklyTrackChart
- Library
- library.addAlbum
- library.addArtist
- library.addTrack
- library.getAlbums
- library.getArtists
- library.getTracks
- library.removeAlbum
- library.removeArtist
- library.removeScrobble
- library.removeTrack
- Playlist
- Radio
- Tag
- tag.getInfo
- tag.getSimilar
- tag.getTopAlbums
- tag.getTopArtists
- tag.getTopTags
- tag.getTopTracks
- tag.getWeeklyArtistChart
- tag.getWeeklyChartList
- tag.search
- Tasteometer
- Track
- track.addTags
- track.ban
- track.getBuylinks
- track.getCorrection
- track.getFingerprintMetadata
- track.getInfo
- track.getShouts
- track.getSimilar
- track.getTags
- track.getTopFans
- track.getTopTags
- track.love
- track.removeTag
- track.scrobble
- track.search
- track.share
- track.unban
- track.unlove
- track.updateNowPlaying
- User
- user.getArtistTracks
- user.getBannedTracks
- user.getEvents
- user.getFriends
- user.getInfo
- user.getLovedTracks
- user.getNeighbours
- user.getNewReleases
- user.getPastEvents
- user.getPersonalTags
- user.getPlaylists
- user.getRecentStations
- user.getRecentTracks
- user.getRecommendedArtists
- user.getRecommendedEvents
- user.getShouts
- user.getTopAlbums
- user.getTopArtists
- user.getTopTags
- user.getTopTracks
- user.getWeeklyAlbumChart
- user.getWeeklyArtistChart
- user.getWeeklyChartList
- user.getWeeklyTrackChart
- user.shout
- Venue
user.getRecentStations
Get a list of the recent Stations listened to by this user.
Params
user (Required) : The last.fm username to fetch the recent Stations of.limit (Optional) : The number of results to fetch per page. Defaults to 10. Maximum is 25.
page (Optional) : The page number to fetch. Defaults to first page.
api_key (Required) : A Last.fm API key.
api_sig (Required) : A Last.fm method signature. See authentication for more information.
sk (Required) : A session key generated by authenticating a user via the authentication protocol.
Auth
This service requires authentication. Please see our authentication how-to.Sample Response
<recentstations user="joanofarctan" page="1" perPage="10" totalPages="1" total="7">
<station>
<type>artist/similarartists</type>
<name>Cher Radio</name>
<url>lastfm://artist/Cher/similarartists</url>
<resources>
<resource type="artist">
<name>Cher</name>
<url>http://www.last.fm/music/Cher</url>
<image size="small">http://userserve-ak.last.fm/serve/34/285717.jpg</image>
<image size="medium">http://userserve-ak.last.fm/serve/64/285717.jpg</image>
<image size="large">http://userserve-ak.last.fm/serve/126/285717.jpg</image>
</resource>
</resources>
</station>
<station>
<type>globaltags</type>
<name>math rock Tag Radio</name>
<url>lastfm://globaltags/math%20rock</url>
<resources>
<resource type="tag">
<name>math rock</name>
<url>http://www.last.fm/tag/math%20rock</url>
<image size="small"/>
<image size="medium"/>
<image size="large"/>
</resource>
</resources>
</station>
<station>
...
</station>
</recentstations>Errors
- 2 : Invalid service - This service does not exist
- 3 : Invalid Method - No method with that name in this package
- 4 : Authentication Failed - You do not have permissions to access the service
- 5 : Invalid format - This service doesn't exist in that format
- 6 : Invalid parameters - Your request is missing a required parameter
- 7 : Invalid resource specified
- 8 : Operation failed - Something else went wrong
- 9 : Invalid session key - Please re-authenticate
- 10 : Invalid API key - You must be granted a valid key by last.fm
- 11 : Service Offline - This service is temporarily offline. Try again later.
- 13 : Invalid method signature supplied
- 16 : There was a temporary error processing your request. Please try again
- 26 : Suspended API key - Access for your account has been suspended, please contact Last.fm
- 29 : Rate limit exceeded - Your IP has made too many requests in a short period