Skip to content
Last.fm is disabling API Keys for non-paid accounts December 1st.Learn More

Get dashboard

GET
/api/dashboard
curl --request GET \
--url https://example.com/api/dashboard

Data for the default public dashboard, if it is enabled

Success

Media typeapplication/json
object
scrobbles

Total count of successfuly scrobbed Plays from all components for a user

integer
>= -9007199254740991 <= 9007199254740991
plays

Total count of discovered Plays from all components for a user

integer
>= -9007199254740991 <= 9007199254740991
listened

Total number of seconds for all discovered Plays for all components for a user. Uses listenedFor on a Play if present, otherwise duration

number
sources

Data about all source type components for a User: count is the total number of components, types is an array of unique component types

object
count
required
integer
>= -9007199254740991 <= 9007199254740991
types
Array
clients

Data about all client type components for a User: count is the total number of components, types is an array of unique component types

object
count
required
integer
>= -9007199254740991 <= 9007199254740991
types
Array
recent

A list of unique, recently scrobbled Plays (distinct PlayData, rather than the same Discovered Play sent to many clients)

Array<object>
Dashboard Play
object
data
required
object
track
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
artists
Array<object>
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
albumArtists
Array<object>
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
album
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
duration

The length of the track, in seconds

number
listenedFor

Number of seconds the track was listened to

number
repeat

Play was detected as a repeat of the previous play

boolean
meta
required

source is the type of the component the Play came from (spotify, jellyfin…), never its name

object
source

Type of Source that discovered this play

string
musicService

If applicable, the name of the Service providing the track (Spotify, Tidal, etc…)

string
url
object
web

The URL where this track can be found for the service it was created from. IE Spotify Source = url to spotify track, Maloja Client = url to specific scrobble

string
origin

The URL where this play was originally played. IE Frank Sinatra - My way FROM youtube.com = URL pointing to specific video

string
nowPlaying
Any of:
Dashboard Play
object
data
required
object
track
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
artists
Array<object>
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
albumArtists
Array<object>
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
album
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
duration

The length of the track, in seconds

number
listenedFor

Number of seconds the track was listened to

number
repeat

Play was detected as a repeat of the previous play

boolean
meta
required

source is the type of the component the Play came from (spotify, jellyfin…), never its name

object
source

Type of Source that discovered this play

string
musicService

If applicable, the name of the Service providing the track (Spotify, Tidal, etc…)

string
url
object
web

The URL where this track can be found for the service it was created from. IE Spotify Source = url to spotify track, Maloja Client = url to specific scrobble

string
origin

The URL where this play was originally played. IE Frank Sinatra - My way FROM youtube.com = URL pointing to specific video

string

Example

{
"recent": [
{
"data": {
"track": {
"metadata": [
{
"name": "musicbrainz",
"idType": "recording"
}
]
},
"artists": [
{
"metadata": [
{
"name": "musicbrainz",
"idType": "recording"
}
]
}
],
"albumArtists": [
{
"metadata": [
{
"name": "musicbrainz",
"idType": "recording"
}
]
}
],
"album": {
"metadata": [
{
"name": "musicbrainz",
"idType": "recording"
}
]
}
}
}
],
"nowPlaying": {
"data": {
"track": {
"metadata": [
{
"name": "musicbrainz",
"idType": "recording"
}
]
},
"artists": [
{
"metadata": [
{
"name": "musicbrainz",
"idType": "recording"
}
]
}
],
"albumArtists": [
{
"metadata": [
{
"name": "musicbrainz",
"idType": "recording"
}
]
}
],
"album": {
"metadata": [
{
"name": "musicbrainz",
"idType": "recording"
}
]
}
}
}
}