Playing via Spotify Playing via YouTube
Skip to YouTube video

Loading player…

Scrobble from Spotify?

Connect your Spotify account to your Last.fm account and scrobble everything you listen to, from any Spotify app on any device or platform.

Connect to Spotify

Dismiss

A new version of Last.fm is available, to keep everything running smoothly, please reload the site.

# track.updateNowPlaying

Used to notify Last.fm that a user has started listening to a track. Parameter names are case sensitive.

# Params

artist (Required) : The artist name.
track (Required) : The track name.
album (Optional) : The album name.
trackNumber (Optional) : The track number of the track on the album.
context (Optional) : Sub-client version (not public, only enabled for certain API keys)
mbid (Optional) : The MusicBrainz Track ID.
duration (Optional) : The length of the track in seconds.
albumArtist (Optional) : The album artist - if this differs from the track artist.
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.
This is a write service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See rest requests for more information.

# Sample Response

<?xml version='1.0' encoding='utf-8'?>
<lfm status="ok">
  <nowplaying>
    <track corrected="0">Test Track</track>
    <artist corrected="0">Test Artist</artist>
    <album corrected="0"></album>
    <albumArtist corrected="0"></albumArtist>
    <ignoredMessage code="0"></ignoredMessage>
  </nowplaying>
</lfm>

# Attributes

  • code : Ignored message codes:
    • 1: Artist was ignored
    • 2: Track was ignored
    • 3: Timestamp was too old
    • 4: Timestamp was too new
    • 5: Daily scrobble limit exceeded
  • corrected : '1', if this track, artist or album name was automatically corrected, '0' otherwise

# Errors

  • 16 : The service is temporarily unavailable, please try again.
  • 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

API Calls