Get dashboard
const url = 'https://example.com/api/dashboard';const options = {method: 'GET'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://example.com/api/dashboardData for the default public dashboard, if it is enabled
Responses
Section titled “Responses”Success
object
Total count of successfuly scrobbed Plays from all components for a user
Total count of discovered Plays from all components for a user
Total number of seconds for all discovered Plays for all components for a user. Uses listenedFor on a Play if present, otherwise duration
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
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
A list of unique, recently scrobbled Plays (distinct PlayData, rather than the same Discovered Play sent to many clients)
object
object
object
object
object
object
object
object
object
object
object
object
object
object
The length of the track, in seconds
Number of seconds the track was listened to
Play was detected as a repeat of the previous play
source is the type of the component the Play came from (spotify, jellyfin…), never its name
object
Type of Source that discovered this play
If applicable, the name of the Service providing the track (Spotify, Tidal, etc…)
object
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
The URL where this play was originally played. IE Frank Sinatra - My way FROM youtube.com = URL pointing to specific video
object
object
object
object
object
object
object
object
object
object
object
object
object
object
The length of the track, in seconds
Number of seconds the track was listened to
Play was detected as a repeat of the previous play
source is the type of the component the Play came from (spotify, jellyfin…), never its name
object
Type of Source that discovered this play
If applicable, the name of the Service providing the track (Spotify, Tidal, etc…)
object
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
The URL where this play was originally played. IE Frank Sinatra - My way FROM youtube.com = URL pointing to specific video
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" } ] } } }}