scrobble

http://your-server/rest/scrobble Since 1.5.0

Registers the local playback of one or more media files. Typically used when playing media that is cached on the client. This operation includes the following:

• “Scrobbles” the media files on last.fm if the user has configured his/her last.fm credentials on the server.
• Updates the play count and last played timestamp for the media files. (Since 1.11.0)
• Makes the media files appear in the “Now playing” page in the web app, and appear in the list of songs returned by getNowPlaying (Since 1.11.0)

Since 1.8.0 you may specify multiple id (and optionally time) parameters to scrobble multiple files.

Parameters

Example

Result

An empty subsonic-response element on success.

• Example:
• OpenSubsonic
• Subsonic

{
  "subsonic-response": {
    "status": "ok",
    "version": "1.16.1",
    "type": "AwesomeServerName",
    "serverVersion": "0.1.3 (tag)",
    "openSubsonic": true
  }
}

{
  "subsonic-response": {
    "status": "ok",
    "version": "1.16.1"
  }
}

If any id is invalid the result is an empty subsonic-response with error code 70 “The requested data was not found”. Note that in this case the whole request has failed and no scrobbling should be performed for those id which are valid.

• OpenSubsonic

{
  "subsonic-response": {
    "status": "failed",
    "version": "1.16.1",
    "type": "AwesomeServerName",
    "serverVersion": "0.1.3 (tag)",
    "openSubsonic": true,
    "error": {
      "code": 70,
      "message": "The requested data was not found.",
      "helpUrl": "https://example.org/scrobble"
    }
  }
}