ListenBrainz

App · 20 actions

Read anyone's public listening history on ListenBrainz, MetaBrainz's open alternative to Last.fm: their listens and what is playing now, top artists, albums and tracks for any period, listening activity, loved tracks, similar listeners and followers, playlists (including the ones ListenBrainz generates), site-wide charts, new releases from the artists they play, and track and artist details from MusicBrainz. A trigger runs a workflow for every new listen. No account or API key required.

Actions

ActionWhat it does
Find similar listenersFind the listeners whose taste is closest to a user's, with how similar each is, most similar first.
Get artist countriesGet the countries the artists a user played come from: how many artists and listens each country accounts for, and its most played artists.
Get artist detailsGet an artist's details from MusicBrainz by their ID: whether a person or group, where they are from, when they started, their tags and genres, and links to their website, socials and streaming pages.
Get followers and followingGet who follows a user on ListenBrainz and who they follow, as two lists of usernames.
Get listen countGet how many listens a user has recorded on ListenBrainz in all.
Get listening activityGet how many listens a user recorded in each day, month or year of a time range, with the total.
Get listening by hourGet how many listens a user recorded in each hour of each weekday (in UTC) over a time range, with totals per weekday and their busiest day and hour.
Get listensGet the tracks a user listened to, newest first: when, the track, artist and album, the player and service, cover art and the MusicBrainz IDs.
Get loved and hated tracksGet the tracks a user marked as loved, or as hated, most recently marked first, with artist, album and cover art.
Get new releasesGet albums, EPs and singles released recently or coming soon, either across MusicBrainz or only from the artists a user listens to.
Get playlistGet a public playlist with every track on it: title, artist, album, length, cover art and MusicBrainz ID.
Get site-wide chartsGet the most played artists, albums or tracks across all of ListenBrainz in a time range, with play counts and cover art.
Get top albumsGet the albums a user played most in a time range, with their artist, cover art and play count, most played first.
Get top artistsGet the artists a user played most in a time range, with how many times each, most played first.
Get top tracksGet the tracks a user played most in a time range, with their artist, album, cover art and play count, most played first.
Get track detailsGet a track's details from MusicBrainz by its ID: artists, length, first release date, album and year, ISRC codes, tags and genres, performer credits and streaming links.
Get what's playing nowSee what a user's player says is playing right now, if anything: the track, artist, album and the service it is playing on.
List a user's playlistsList the public playlists a user made or saved, newest first, with their links.
List playlists made for a userList the playlists ListenBrainz generated for a user, such as Daily Jams, Weekly Jams and Weekly Exploration, newest first.
Search playlistsFind public playlists whose title or description resembles your words, closest match first.

Find similar listeners

Find the listeners whose taste is closest to a user's, with how similar each is, most similar first. No API key required.

Inputs

UsernameusernametextRequired
The ListenBrainz username, as in the profile address listenbrainz.org/user/<name>. Pasting the profile link works too.

Outputs

countnumber
How many similar listeners came back.
usernametext
The ListenBrainz username these results are for.
userslist
Listeners with the most similar taste first.
Example output
{
  "count": 1,
  "username": "rob",
  "users": [
    {
      "profile_url": "https://listenbrainz.org/user/Violet%26Red/",
      "similarity": 0.5212,
      "similarity_percent": 52,
      "username": "Violet&Red"
    }
  ]
}

Get artist countries

Get the countries the artists a user played come from: how many artists and listens each country accounts for, and its most played artists. No API key required.

Inputs

UsernameusernametextRequired
The ListenBrainz username, as in the profile address listenbrainz.org/user/<name>. Pasting the profile link works too.
Time rangetime_rangetext
Which period to count. All time by default. 'Last' ranges are the previous full week, month, quarter, six months or year; ListenBrainz recalculates statistics about once a day.One of: all_time (All time), this_week (This week so far), this_month (This month so far), this_year (This year so far), week (Last week), month (Last month), quarter (Last quarter), half_yearly (Last six months), year (Last year). Default: all_time.

Outputs

countrieslist
Countries the played artists come from, most artists first.
last_updatedtext
When ListenBrainz last recalculated these statistics.
period_endtext
The end of the period counted.
period_starttext
The start of the period counted, as an ISO 8601 UTC time.
rangetext
The time range asked for, such as all_time or week.
range_labeltext
That range in words, such as 'Last week'.
stats_readytrue/false
False when ListenBrainz has no statistics for this range yet, usually because there were no listens in it. The list is then empty.
total_countriesnumber
How many countries are listed.
usernametext
The ListenBrainz username these results are for.
Example output
{
  "countries": [
    {
      "artist_count": 282,
      "country_code": "GBR",
      "listen_count": 68541,
      "top_artists": [
        {
          "artist_mbid": "a8b39181-6939-451e-9641-2db231b73706",
          "artist_name": "Abakus",
          "listen_count": 3809
        },
        {
          "artist_mbid": "9a709693-b4f8-4da9-8cc1-038c911a61be",
          "artist_name": "Bonobo",
          "listen_count": 3536
        }
      ]
    }
  ],
  "last_updated": "2026-09-27T09:51:03Z",
  "period_end": "2026-09-27T00:00:00Z",
  "period_start": "2002-01-01T00:00:00Z",
  "range": "all_time",
  "range_label": "All time",
  "stats_ready": true,
  "total_countries": 1,
  "username": "rob"
}

Get artist details

Get an artist's details from MusicBrainz by their ID: whether a person or group, where they are from, when they started, their tags and genres, and links to their website, socials and streaming pages. No API key required.

Inputs

Artist IDartist_mbidtextRequired
The artist's MusicBrainz ID, as top artists or a listen returns it. A MusicBrainz or ListenBrainz artist link works too.

Outputs

areatext
Where the artist is from.
artist_mbidtext
The artist's MusicBrainz ID.
begin_yearnumber
The year the artist was born or formed.
linkslist
The artist's websites, social profiles and streaming pages.
listenbrainz_urltext
The artist's page on ListenBrainz.
musicbrainz_urltext
The page for this on MusicBrainz.
nametext
The artist's name.
tagslist
Tags on the artist, most voted first.
typetext
Person, Group, Orchestra and so on.
Example output
{
  "area": "United Kingdom",
  "artist_mbid": "8f6bd1e4-fbe1-4f50-aa9b-94c450ec0f11",
  "begin_year": 1991,
  "links": [
    {
      "type": "official homepage",
      "url": "http://www.portishead.co.uk/"
    },
    {
      "type": "wikidata",
      "url": "https://www.wikidata.org/wiki/Q191352"
    }
  ],
  "listenbrainz_url": "https://listenbrainz.org/artist/8f6bd1e4-fbe1-4f50-aa9b-94c450ec0f11/",
  "musicbrainz_url": "https://musicbrainz.org/artist/8f6bd1e4-fbe1-4f50-aa9b-94c450ec0f11",
  "name": "Portishead",
  "tags": [
    {
      "is_genre": true,
      "tag": "trip hop",
      "votes": 16
    },
    {
      "is_genre": false,
      "tag": "bristol sound",
      "votes": 1
    }
  ],
  "type": "Group"
}

Get followers and following

Get who follows a user on ListenBrainz and who they follow, as two lists of usernames. No API key required.

Inputs

UsernameusernametextRequired
The ListenBrainz username, as in the profile address listenbrainz.org/user/<name>. Pasting the profile link works too.

Outputs

follower_countnumber
How many people follow the user.
followerslist
The usernames of the people who follow the user.
followinglist
The usernames of the people the user follows.
following_countnumber
How many people the user follows.
usernametext
The ListenBrainz username these results are for.
Example output
{
  "follower_count": 2,
  "followers": [
    "ishaanshah",
    "aerozol"
  ],
  "following": [
    "Zas",
    "mr_monkey"
  ],
  "following_count": 2,
  "username": "rob"
}

Get listen count

Get how many listens a user has recorded on ListenBrainz in all. No API key required.

Inputs

UsernameusernametextRequired
The ListenBrainz username, as in the profile address listenbrainz.org/user/<name>. Pasting the profile link works too.

Outputs

listen_countnumber
How many listens the user has recorded in all.
profile_urltext
The user's ListenBrainz profile page.
usernametext
The ListenBrainz username these results are for.
Example output
{
  "listen_count": 220287,
  "profile_url": "https://listenbrainz.org/user/rob/",
  "username": "rob"
}

Get listening activity

Get how many listens a user recorded in each day, month or year of a time range, with the total. A range also covers the period before it, for comparing: last week lists 14 days. No API key required.

Inputs

UsernameusernametextRequired
The ListenBrainz username, as in the profile address listenbrainz.org/user/<name>. Pasting the profile link works too.
Time rangetime_rangetext
Which period to count. All time by default. 'Last' ranges are the previous full week, month, quarter, six months or year; ListenBrainz recalculates statistics about once a day.One of: all_time (All time), this_week (This week so far), this_month (This month so far), this_year (This year so far), week (Last week), month (Last month), quarter (Last quarter), half_yearly (Last six months), year (Last year). Default: all_time.

Outputs

countnumber
How many periods are listed.
last_updatedtext
When ListenBrainz last recalculated these statistics.
period_endtext
The end of the period counted.
period_starttext
The start of the period counted, as an ISO 8601 UTC time.
periodslist
One row per day, month or year, oldest first. A range covers both the current and the previous period, so 'Last week' lists 14 days.
rangetext
The time range asked for, such as all_time or week.
range_labeltext
That range in words, such as 'Last week'.
stats_readytrue/false
False when ListenBrainz has no statistics for this range yet, usually because there were no listens in it. The list is then empty.
total_listensnumber
All the listens in the periods listed.
usernametext
The ListenBrainz username these results are for.
Example output
{
  "count": 2,
  "last_updated": "2026-09-27T09:51:03Z",
  "period_end": "2026-01-01T00:00:00Z",
  "period_start": "2024-01-01T00:00:00Z",
  "periods": [
    {
      "end": "2024-01-31T23:59:59Z",
      "label": "January 2024",
      "listen_count": 2795,
      "start": "2024-01-01T00:00:00Z"
    },
    {
      "end": "2024-02-29T23:59:59Z",
      "label": "February 2024",
      "listen_count": 2087,
      "start": "2024-02-01T00:00:00Z"
    }
  ],
  "range": "year",
  "range_label": "Last year",
  "stats_ready": true,
  "total_listens": 4882,
  "username": "rob"
}

Get listening by hour

Get how many listens a user recorded in each hour of each weekday (in UTC) over a time range, with totals per weekday and their busiest day and hour. No API key required.

Inputs

UsernameusernametextRequired
The ListenBrainz username, as in the profile address listenbrainz.org/user/<name>. Pasting the profile link works too.
Time rangetime_rangetext
Which period to count. All time by default. 'Last' ranges are the previous full week, month, quarter, six months or year; ListenBrainz recalculates statistics about once a day.One of: all_time (All time), this_week (This week so far), this_month (This month so far), this_year (This year so far), week (Last week), month (Last month), quarter (Last quarter), half_yearly (Last six months), year (Last year). Default: all_time.

Outputs

busiest_daytext
The weekday with the most listens.
busiest_hour_utcnumber
The hour of the day (0 to 23, UTC) with the most listens.
dayslist
Listens per weekday, Monday first.
hourslist
Listens in each hour of each weekday (168 rows, Monday 0:00 first). Hours are UTC.
last_updatedtext
When ListenBrainz last recalculated these statistics.
period_endtext
The end of the period counted.
period_starttext
The start of the period counted, as an ISO 8601 UTC time.
rangetext
The time range asked for, such as all_time or week.
range_labeltext
That range in words, such as 'Last week'.
stats_readytrue/false
False when ListenBrainz has no statistics for this range yet, usually because there were no listens in it. The list is then empty.
total_listensnumber
All the listens counted.
usernametext
The ListenBrainz username these results are for.
Example output
{
  "busiest_day": "Monday",
  "busiest_hour_utc": 14,
  "days": [
    {
      "day": "Monday",
      "listen_count": 3245
    },
    {
      "day": "Tuesday",
      "listen_count": 0
    }
  ],
  "hours": [
    {
      "day": "Monday",
      "hour_utc": 13,
      "listen_count": 1671
    },
    {
      "day": "Monday",
      "hour_utc": 14,
      "listen_count": 1574
    }
  ],
  "last_updated": "2026-09-27T09:51:03Z",
  "period_end": "2026-09-27T00:00:00Z",
  "period_start": "2002-01-01T00:00:00Z",
  "range": "all_time",
  "range_label": "All time",
  "stats_ready": true,
  "total_listens": 3245,
  "username": "rob"
}

Get listens

Get the tracks a user listened to, newest first: when, the track, artist and album, the player and service, cover art and the MusicBrainz IDs. Give a window of time to read a particular day or week. No API key required.

Inputs

UsernameusernametextRequired
The ListenBrainz username, as in the profile address listenbrainz.org/user/<name>. Pasting the profile link works too.
Listened afterlistened_afterdate and time
Only listens after this moment. When it is set, the listens that came right after it are returned, up to How many, so raise that to reach further forward.
Listened beforelistened_beforedate and time
Only listens before this moment. Leave both empty for the most recent listens.
How manycountnumber
How many to return, from 1 to 1,000. 25 by default.From 1 to 1000. Default: 25.

Outputs

countnumber
How many listens came back.
first_listen_attext
When the user's earliest recorded listen was.
latest_listen_attext
When the user's most recent listen of all was, as an ISO 8601 UTC time.
listenslist
The listens, newest first.
usernametext
The ListenBrainz username these results are for.
Example output
{
  "count": 1,
  "first_listen_at": "2006-10-11T20:36:59Z",
  "latest_listen_at": "2026-02-18T11:28:29Z",
  "listens": [
    {
      "album_mbid": "1d98b0bc-5832-49d2-a93e-463032631a2f",
      "album_name": "Profound Mysteries II",
      "artist_mbids": [
        "1c70a3fc-fa3c-4be1-8b55-c3192db8a884"
      ],
      "artist_name": "R\u00f6yksopp",
      "cover_art_url": "https://coverartarchive.org/release/f1418001-7f1e-46af-bfdb-95faeded8841/32916450708-500.jpg",
      "duration_seconds": 402,
      "listened_at": "2026-02-18T11:28:29Z",
      "listened_at_unix": 1771414109,
      "music_service": null,
      "recording_mbid": "30d08f4c-d825-4ae1-b79c-44242cddd7c0",
      "recording_msid": "fd0cad33-ea33-453b-8155-1292379277db",
      "release_mbid": "e96c2e7b-94fd-4fbe-9c44-1a27d8664825",
      "submitted_with": "navidrome",
      "track_name": "Some Resolve",
      "track_url": null
    }
  ],
  "username": "rob"
}

Get loved and hated tracks

Get the tracks a user marked as loved, or as hated, most recently marked first, with artist, album and cover art. No API key required.

Inputs

UsernameusernametextRequired
The ListenBrainz username, as in the profile address listenbrainz.org/user/<name>. Pasting the profile link works too.
Which tracksfeedbacktext
Loved tracks by default.One of: loved (Loved tracks), hated (Hated tracks), both. Default: loved.
How manycountnumber
How many to return, from 1 to 1,000. 25 by default.From 1 to 1000. Default: 25.
Skipoffsetnumber
How many to skip from the start of the list, to read further down it. 0 by default.From 0 to 100000. Default: 0.

Outputs

countnumber
How many came back.
feedbacktext
Which tracks were asked for: loved, hated or both.
offsetnumber
How many were skipped from the newest.
totalnumber
How many tracks the user has marked that way in all.
trackslist
The tracks, most recently marked first.
usernametext
The ListenBrainz username these results are for.
Example output
{
  "count": 1,
  "feedback": "loved",
  "offset": 0,
  "total": 94,
  "tracks": [
    {
      "album_name": "Solsbury Hill",
      "artist_mbids": [
        "2f548675-008d-4332-876c-108b0c7ab9c5"
      ],
      "artist_name": "Sia",
      "cover_art_url": "https://coverartarchive.org/release/4a9a1827-5423-49be-8370-1e1c529fab34/41190842555-500.jpg",
      "feedback": "loved",
      "given_at": "2025-03-14T17:12:08Z",
      "musicbrainz_url": "https://musicbrainz.org/recording/3b056314-4044-48dc-a28a-a81f307f2013",
      "recording_mbid": "3b056314-4044-48dc-a28a-a81f307f2013",
      "release_mbid": "4a9a1827-5423-49be-8370-1e1c529fab34",
      "track_name": "Solsbury Hill"
    }
  ],
  "username": "rob"
}

Get new releases

Get albums, EPs and singles released recently or coming soon, either across MusicBrainz or only from the artists a user listens to. Each comes with its date, type, cover art and tags. No API key required.

Inputs

Usernameusernametext
Only releases by artists this ListenBrainz user listens to. Leave empty for every new release.
Daysdaysnumber
How many days back (and ahead, for upcoming releases) to look, from 1 to 90. 14 by default.From 1 to 90. Default: 14.
Include releasedinclude_pasttrue/false
Include releases already out. On by default.Default: true.
Include upcominginclude_upcomingtrue/false
Include releases not out yet. On by default.Default: true.
Release typesrelease_typeslist
Only these kinds of release. Leave empty for all.One or more of: Album (Albums), EP (EPs), Single (Singles), Broadcast (Broadcasts), Other (Other releases).
Ordersorttext
Newest release date first by default. 'Artists the user plays most first' needs a username.One of: newest (Newest release date first), oldest (Oldest release date first), artist (Artist name, A to Z), relevance (Artists the user plays most first). Default: newest.
How manylimitnumber
The most releases to return, from 1 to 1,000. 100 by default.From 1 to 1000. Default: 100.

Outputs

countnumber
How many came back.
daysnumber
How many days either side of today were covered.
more_availabletrue/false
True when raising the limit would return more.
releaseslist
The releases.
sorttext
The order the releases are in.
total_matchingnumber
How many releases matched in all.
usernametext
The user whose artists were followed. Empty for site-wide releases.
Example output
{
  "count": 1,
  "days": 30,
  "more_available": true,
  "releases": [
    {
      "album_mbid": "efb25509-dad3-4a3b-a9f1-e81ede4067e3",
      "artist_mbids": [
        "1c70a3fc-fa3c-4be1-8b55-c3192db8a884",
        "d735497b-25f9-4503-8fb5-f50150730c18"
      ],
      "artist_name": "Ane Brun & R\u00f6yksopp",
      "cover_art_url": "https://coverartarchive.org/release/4da8c519-aec3-4f66-9dea-9b8cc95c6dac/46414277352-500.jpg",
      "musicbrainz_url": "https://musicbrainz.org/release/4da8c519-aec3-4f66-9dea-9b8cc95c6dac",
      "release_date": "2026-10-09",
      "release_mbid": "4da8c519-aec3-4f66-9dea-9b8cc95c6dac",
      "release_name": "Eat the Fruit",
      "relevance": 4258,
      "secondary_type": null,
      "tags": [
        "ambient pop",
        "art pop",
        "synth-pop"
      ],
      "type": "Single"
    }
  ],
  "sort": "newest",
  "total_matching": 133,
  "username": "rob"
}

Get playlist

Get a public playlist with every track on it: title, artist, album, length, cover art and MusicBrainz ID. No API key required.

Inputs

PlaylistplaylisttextRequired
The playlist's ID or its ListenBrainz link, from a playlist list or search.

Outputs

algorithmtext
For a generated playlist, which kind it is, such as daily-jams or weekly-exploration. Empty for one a person made.
collaboratorslist
Other users who can edit it.
created_attext
When it was made, as an ISO 8601 UTC time.
created_fortext
Who a generated playlist was made for.
creatortext
Who made it: a username, or troi-bot and listenbrainz for playlists ListenBrainz generated.
descriptiontext
Its description as plain text.
last_modified_attext
When it was last changed.
playlist_mbidtext
The playlist's ID. Pass it to 'Get playlist'.
publictrue/false
Whether anyone can see it.
titletext
The playlist's title.
track_countnumber
How many tracks it holds.
trackslist
Every track, in playlist order.
urltext
The playlist's page on ListenBrainz.
Example output
{
  "algorithm": "weekly-jams",
  "collaborators": [],
  "created_at": "2026-08-23T22:07:21Z",
  "created_for": "rob",
  "creator": "listenbrainz",
  "description": "The ListenBrainz Weekly Jams playlist features songs that you have listened to before, arranged into a comfortable playlist.",
  "last_modified_at": "2026-08-23T22:07:21Z",
  "playlist_mbid": "54cc305b-f68e-4ab8-a2b9-3188727a3b5b",
  "public": true,
  "title": "Weekly Jams for rob, week of 2026-08-24 Mon",
  "track_count": 1,
  "tracks": [
    {
      "added_at": "2026-08-23T22:07:21Z",
      "added_by": "listenbrainz",
      "album_name": "Tomorrow\u2019s Harvest",
      "artist_mbids": [
        "69158f97-4c07-4c4e-baf8-4e4ab1ed666e"
      ],
      "artist_name": "Boards of Canada",
      "cover_art_url": "https://coverartarchive.org/release/d1f52538-291c-45a3-80a1-ac601f84ab87/4293243591-500.jpg",
      "duration_seconds": 222,
      "musicbrainz_url": "https://musicbrainz.org/recording/28b58f86-dc23-4745-ba8d-1964f2c1c23a",
      "position": 1,
      "recording_mbid": "28b58f86-dc23-4745-ba8d-1964f2c1c23a",
      "title": "Cold Earth"
    }
  ],
  "url": "https://listenbrainz.org/playlist/54cc305b-f68e-4ab8-a2b9-3188727a3b5b/"
}

Get site-wide charts

Get the most played artists, albums or tracks across all of ListenBrainz in a time range, with play counts and cover art. No API key required.

Inputs

Chartcharttext
What to rank. Artists by default.One of: artists, albums, tracks. Default: artists.
Time rangetime_rangetext
Which period to count. All time by default. 'Last' ranges are the previous full week, month, quarter, six months or year; ListenBrainz recalculates statistics about once a day.One of: all_time (All time), this_week (This week so far), this_month (This month so far), this_year (This year so far), week (Last week), month (Last month), quarter (Last quarter), half_yearly (Last six months), year (Last year). Default: all_time.
How manycountnumber
How many to return, from 1 to 1,000. 25 by default.From 1 to 1000. Default: 25.
Skipoffsetnumber
How many to skip from the start of the list, to read further down it. 0 by default.From 0 to 100000. Default: 0.

Outputs

charttext
What is ranked: artists, albums or tracks.
countnumber
How many came back.
entrieslist
Most played first.
last_updatedtext
When ListenBrainz last recalculated these statistics.
offsetnumber
How many places were skipped from the top.
period_endtext
The end of the period counted.
period_starttext
The start of the period counted, as an ISO 8601 UTC time.
rangetext
The time range asked for, such as all_time or week.
range_labeltext
That range in words, such as 'Last week'.
stats_readytrue/false
False when ListenBrainz has no statistics for this range yet, usually because there were no listens in it. The list is then empty.
total_entriesnumber
How many different entries were played in the range.
Example output
{
  "chart": "tracks",
  "count": 1,
  "entries": [
    {
      "album_name": "ARIRANG",
      "artist_mbids": [
        "0d79fe8e-ba27-4859-bb8c-2f255f346853"
      ],
      "artist_name": "BTS",
      "cover_art_url": "https://coverartarchive.org/release/20af35dd-dda2-47de-8ea5-78211c0dfe9c/44649396012-500.jpg",
      "listen_count": 181789,
      "mbid": "6f33dc05-cdc0-4a2f-8039-e8fed082eec6",
      "musicbrainz_url": "https://musicbrainz.org/recording/6f33dc05-cdc0-4a2f-8039-e8fed082eec6",
      "name": "SWIM",
      "rank": 1
    }
  ],
  "last_updated": "2026-10-19T22:58:38Z",
  "offset": 0,
  "period_end": "2026-10-19T00:00:00Z",
  "period_start": "2026-10-12T00:00:00Z",
  "range": "week",
  "range_label": "Last week",
  "stats_ready": true,
  "total_entries": 2928100
}

Get top albums

Get the albums a user played most in a time range, with their artist, cover art and play count, most played first. No API key required.

Inputs

UsernameusernametextRequired
The ListenBrainz username, as in the profile address listenbrainz.org/user/<name>. Pasting the profile link works too.
Time rangetime_rangetext
Which period to count. All time by default. 'Last' ranges are the previous full week, month, quarter, six months or year; ListenBrainz recalculates statistics about once a day.One of: all_time (All time), this_week (This week so far), this_month (This month so far), this_year (This year so far), week (Last week), month (Last month), quarter (Last quarter), half_yearly (Last six months), year (Last year). Default: all_time.
How manycountnumber
How many to return, from 1 to 1,000. 25 by default.From 1 to 1000. Default: 25.
Skipoffsetnumber
How many to skip from the start of the list, to read further down it. 0 by default.From 0 to 100000. Default: 0.

Outputs

albumslist
Most played first.
countnumber
How many came back.
last_updatedtext
When ListenBrainz last recalculated these statistics.
offsetnumber
How many places were skipped from the top.
period_endtext
The end of the period counted.
period_starttext
The start of the period counted, as an ISO 8601 UTC time.
rangetext
The time range asked for, such as all_time or week.
range_labeltext
That range in words, such as 'Last week'.
stats_readytrue/false
False when ListenBrainz has no statistics for this range yet, usually because there were no listens in it. The list is then empty.
total_albumsnumber
How many different albums were played in the range.
usernametext
The ListenBrainz username these results are for.
Example output
{
  "albums": [
    {
      "album_mbid": "9470253b-7102-398b-bda0-f010e92c9955",
      "album_name": "Filling Up the City Skies",
      "artist_mbids": [
        "3a07764c-7cc5-42e9-8205-3de7532f4771"
      ],
      "artist_name": "Pretty Lights",
      "cover_art_url": "https://coverartarchive.org/release/dda07cd4-efaa-400a-8151-08c29729604a/23255889740-500.jpg",
      "listen_count": 1699,
      "listenbrainz_url": "https://listenbrainz.org/album/9470253b-7102-398b-bda0-f010e92c9955/",
      "rank": 1,
      "release_mbid": "dda07cd4-efaa-400a-8151-08c29729604a"
    }
  ],
  "count": 1,
  "last_updated": "2026-09-27T09:51:03Z",
  "offset": 0,
  "period_end": "2026-09-27T00:00:00Z",
  "period_start": "2002-01-01T00:00:00Z",
  "range": "all_time",
  "range_label": "All time",
  "stats_ready": true,
  "total_albums": 12595,
  "username": "rob"
}

Get top artists

Get the artists a user played most in a time range, with how many times each, most played first. An empty list with 'Stats ready' false means no listens were counted in that range. No API key required.

Inputs

UsernameusernametextRequired
The ListenBrainz username, as in the profile address listenbrainz.org/user/<name>. Pasting the profile link works too.
Time rangetime_rangetext
Which period to count. All time by default. 'Last' ranges are the previous full week, month, quarter, six months or year; ListenBrainz recalculates statistics about once a day.One of: all_time (All time), this_week (This week so far), this_month (This month so far), this_year (This year so far), week (Last week), month (Last month), quarter (Last quarter), half_yearly (Last six months), year (Last year). Default: all_time.
How manycountnumber
How many to return, from 1 to 1,000. 25 by default.From 1 to 1000. Default: 25.
Skipoffsetnumber
How many to skip from the start of the list, to read further down it. 0 by default.From 0 to 100000. Default: 0.

Outputs

artistslist
Most played first.
countnumber
How many came back.
last_updatedtext
When ListenBrainz last recalculated these statistics.
offsetnumber
How many places were skipped from the top.
period_endtext
The end of the period counted.
period_starttext
The start of the period counted, as an ISO 8601 UTC time.
rangetext
The time range asked for, such as all_time or week.
range_labeltext
That range in words, such as 'Last week'.
stats_readytrue/false
False when ListenBrainz has no statistics for this range yet, usually because there were no listens in it. The list is then empty.
total_artistsnumber
How many different artists were played in the range.
usernametext
The ListenBrainz username these results are for.
Example output
{
  "artists": [
    {
      "artist_mbid": "c24b47a1-2f52-44f3-a3c6-374dca844731",
      "artist_name": "Wax Tailor",
      "listen_count": 4298,
      "listenbrainz_url": "https://listenbrainz.org/artist/c24b47a1-2f52-44f3-a3c6-374dca844731/",
      "rank": 1
    },
    {
      "artist_mbid": "1c70a3fc-fa3c-4be1-8b55-c3192db8a884",
      "artist_name": "R\u00f6yksopp",
      "listen_count": 4249,
      "listenbrainz_url": "https://listenbrainz.org/artist/1c70a3fc-fa3c-4be1-8b55-c3192db8a884/",
      "rank": 2
    }
  ],
  "count": 2,
  "last_updated": "2026-09-27T09:51:03Z",
  "offset": 0,
  "period_end": "2026-09-27T00:00:00Z",
  "period_start": "2002-01-01T00:00:00Z",
  "range": "all_time",
  "range_label": "All time",
  "stats_ready": true,
  "total_artists": 8629,
  "username": "rob"
}

Get top tracks

Get the tracks a user played most in a time range, with their artist, album, cover art and play count, most played first. No API key required.

Inputs

UsernameusernametextRequired
The ListenBrainz username, as in the profile address listenbrainz.org/user/<name>. Pasting the profile link works too.
Time rangetime_rangetext
Which period to count. All time by default. 'Last' ranges are the previous full week, month, quarter, six months or year; ListenBrainz recalculates statistics about once a day.One of: all_time (All time), this_week (This week so far), this_month (This month so far), this_year (This year so far), week (Last week), month (Last month), quarter (Last quarter), half_yearly (Last six months), year (Last year). Default: all_time.
How manycountnumber
How many to return, from 1 to 1,000. 25 by default.From 1 to 1000. Default: 25.
Skipoffsetnumber
How many to skip from the start of the list, to read further down it. 0 by default.From 0 to 100000. Default: 0.

Outputs

countnumber
How many came back.
last_updatedtext
When ListenBrainz last recalculated these statistics.
offsetnumber
How many places were skipped from the top.
period_endtext
The end of the period counted.
period_starttext
The start of the period counted, as an ISO 8601 UTC time.
rangetext
The time range asked for, such as all_time or week.
range_labeltext
That range in words, such as 'Last week'.
stats_readytrue/false
False when ListenBrainz has no statistics for this range yet, usually because there were no listens in it. The list is then empty.
total_tracksnumber
How many different tracks were played in the range.
trackslist
Most played first.
usernametext
The ListenBrainz username these results are for.
Example output
{
  "count": 1,
  "last_updated": "2026-09-27T09:51:03Z",
  "offset": 0,
  "period_end": "2026-09-27T00:00:00Z",
  "period_start": "2002-01-01T00:00:00Z",
  "range": "all_time",
  "range_label": "All time",
  "stats_ready": true,
  "total_tracks": 33900,
  "tracks": [
    {
      "album_name": "Maps From the Wilderness",
      "artist_mbids": [
        "3fa17b15-b8d1-46c4-a0e3-6e0f2a064a1d"
      ],
      "artist_name": "TM Juke",
      "cover_art_url": "https://coverartarchive.org/release/d3654b5e-160f-4a96-bacf-aea5242a2df0/3246868285-500.jpg",
      "listen_count": 243,
      "musicbrainz_url": "https://musicbrainz.org/recording/586a6fc2-804e-4e60-a115-217d8ae9e90d",
      "rank": 1,
      "recording_mbid": "586a6fc2-804e-4e60-a115-217d8ae9e90d",
      "release_mbid": "d3654b5e-160f-4a96-bacf-aea5242a2df0",
      "track_name": "Just for a Day (Sunday)"
    }
  ],
  "username": "rob"
}

Get track details

Get a track's details from MusicBrainz by its ID: artists, length, first release date, album and year, ISRC codes, tags and genres, performer credits and streaming links. No API key required.

Inputs

Track IDrecording_mbidtextRequired
The track's MusicBrainz recording ID, as a listen, top tracks list or playlist returns it. A MusicBrainz link works too.

Outputs

album_artist_nametext
That album's artist.
album_mbidtext
The MusicBrainz release group ID: the album across all its editions.
album_nametext
The album (release) ListenBrainz links the track to.
album_tagslist
Tags on its album.
artist_nametext
The artist as credited.
artist_tagslist
Tags on its artists.
artistslist
Each credited artist.
cover_art_urltext
A 500 pixel cover image from the Cover Art Archive. Empty when there is none.
creditslist
Performers and their roles.
first_release_datetext
When the track was first released, YYYY-MM-DD.
isrcslist
The track's ISRC codes.
length_secondsnumber
How long the track is.
linkslist
Where to stream or buy the track.
musicbrainz_urltext
The page for this on MusicBrainz.
recording_mbidtext
The track's MusicBrainz recording ID.
release_mbidtext
The MusicBrainz ID of the release (the edition of the album).
release_yearnumber
The year that album came out.
tagslist
Tags on the track, most voted first.
track_nametext
The track's title.
Example output
{
  "album_artist_name": "R\u00f6yksopp",
  "album_mbid": "1d98b0bc-5832-49d2-a93e-463032631a2f",
  "album_name": "Profound Mysteries II",
  "album_tags": [
    {
      "is_genre": true,
      "tag": "synth-pop",
      "votes": 1
    }
  ],
  "artist_name": "R\u00f6yksopp",
  "artist_tags": [
    {
      "is_genre": true,
      "tag": "electronic",
      "votes": 12
    }
  ],
  "artists": [
    {
      "area": "Norway",
      "artist_mbid": "1c70a3fc-fa3c-4be1-8b55-c3192db8a884",
      "begin_year": 1998,
      "join_phrase": "",
      "name": "R\u00f6yksopp",
      "type": "Group"
    }
  ],
  "cover_art_url": "https://coverartarchive.org/release/f1418001-7f1e-46af-bfdb-95faeded8841/32916450708-500.jpg",
  "credits": [
    {
      "artist_mbid": "8695150e-aa0f-4330-ae02-dccf51dd1fe1",
      "artist_name": "Kato \u00c5dland",
      "instrument": "bass guitar",
      "role": "instrument"
    }
  ],
  "first_release_date": "2022-08-19",
  "isrcs": [
    "GBW232100119"
  ],
  "length_seconds": 402,
  "links": [
    {
      "type": "streaming",
      "url": "https://tidal.com/track/243062918"
    }
  ],
  "musicbrainz_url": "https://musicbrainz.org/recording/30d08f4c-d825-4ae1-b79c-44242cddd7c0",
  "recording_mbid": "30d08f4c-d825-4ae1-b79c-44242cddd7c0",
  "release_mbid": "f1418001-7f1e-46af-bfdb-95faeded8841",
  "release_year": 2022,
  "tags": [
    {
      "is_genre": true,
      "tag": "electronic",
      "votes": 2
    }
  ],
  "track_name": "Some Resolve"
}

Get what's playing now

See what a user's player says is playing right now, if anything: the track, artist, album and the service it is playing on. 'Is playing' is false when nothing is. No API key required.

Inputs

UsernameusernametextRequired
The ListenBrainz username, as in the profile address listenbrainz.org/user/<name>. Pasting the profile link works too.

Outputs

album_nametext
Its album.
artist_mbidslist
The MusicBrainz IDs of every credited artist. Pass one to 'Get artist details'.
artist_nametext
Its artist.
cover_art_urltext
A 500 pixel cover image from the Cover Art Archive. Empty when there is none.
duration_secondsnumber
How long the track is.
is_playingtrue/false
True when the user's player reports a track playing right now.
music_servicetext
Where it was played, such as Spotify, when known.
recording_mbidtext
The track's MusicBrainz recording ID. Pass it to 'Get track details'. Empty when ListenBrainz could not match the track to MusicBrainz.
release_mbidtext
The MusicBrainz ID of the release (the edition of the album).
submitted_withtext
The app that sent the listen to ListenBrainz, such as Web Scrobbler.
summarytext
One line saying what is playing, or that nothing is.
track_nametext
The track playing. Empty when nothing is.
track_urltext
A link to the track on the service it was played on.
usernametext
The ListenBrainz username these results are for.
Example output
{
  "album_name": "ARIRANG",
  "artist_mbids": [],
  "artist_name": "BTS",
  "cover_art_url": null,
  "duration_seconds": 227,
  "is_playing": true,
  "music_service": "Spotify",
  "recording_mbid": null,
  "release_mbid": null,
  "submitted_with": "Web Scrobbler",
  "summary": "Ateeteeee is listening to Into the Sun by BTS",
  "track_name": "Into the Sun",
  "track_url": "https://open.spotify.com/track/1ZNolq7VI7efGlh2hb2VVr",
  "username": "Ateeteeee"
}

List a user's playlists

List the public playlists a user made or saved, newest first, with their links. Use 'Get playlist' for the tracks. No API key required.

Inputs

UsernameusernametextRequired
The ListenBrainz username, as in the profile address listenbrainz.org/user/<name>. Pasting the profile link works too.
How manycountnumber
How many playlists to return, from 1 to 100. 25 by default.From 1 to 100. Default: 25.
Skipoffsetnumber
How many to skip from the start of the list, to read further down it. 0 by default.From 0 to 100000. Default: 0.

Outputs

countnumber
How many came back.
offsetnumber
How many were skipped from the newest.
playlistslist
The playlists, newest first.
totalnumber
How many playlists there are in all.
usernametext
The ListenBrainz username these results are for.
Example output
{
  "count": 1,
  "offset": 0,
  "playlists": [
    {
      "algorithm": "weekly-jams",
      "collaborators": [],
      "created_at": "2026-08-23T22:07:21Z",
      "created_for": "rob",
      "creator": "listenbrainz",
      "description": "The ListenBrainz Weekly Jams playlist features songs that you have listened to before, arranged into a comfortable playlist.",
      "last_modified_at": "2026-08-23T22:07:21Z",
      "playlist_mbid": "54cc305b-f68e-4ab8-a2b9-3188727a3b5b",
      "public": true,
      "title": "Weekly Jams for rob, week of 2026-08-24 Mon",
      "url": "https://listenbrainz.org/playlist/54cc305b-f68e-4ab8-a2b9-3188727a3b5b/"
    }
  ],
  "total": 46,
  "username": "rob"
}

List playlists made for a user

List the playlists ListenBrainz generated for a user, such as Daily Jams, Weekly Jams and Weekly Exploration, newest first. Older ones are replaced as new ones are made. No API key required.

Inputs

UsernameusernametextRequired
The ListenBrainz username, as in the profile address listenbrainz.org/user/<name>. Pasting the profile link works too.
How manycountnumber
How many playlists to return, from 1 to 100. 25 by default.From 1 to 100. Default: 25.
Skipoffsetnumber
How many to skip from the start of the list, to read further down it. 0 by default.From 0 to 100000. Default: 0.

Outputs

countnumber
How many came back.
offsetnumber
How many were skipped from the newest.
playlistslist
The playlists, newest first.
totalnumber
How many playlists there are in all.
usernametext
The ListenBrainz username these results are for.
Example output
{
  "count": 1,
  "offset": 0,
  "playlists": [
    {
      "algorithm": "weekly-jams",
      "collaborators": [],
      "created_at": "2026-08-23T22:07:21Z",
      "created_for": "rob",
      "creator": "listenbrainz",
      "description": "The ListenBrainz Weekly Jams playlist features songs that you have listened to before, arranged into a comfortable playlist.",
      "last_modified_at": "2026-08-23T22:07:21Z",
      "playlist_mbid": "54cc305b-f68e-4ab8-a2b9-3188727a3b5b",
      "public": true,
      "title": "Weekly Jams for rob, week of 2026-08-24 Mon",
      "url": "https://listenbrainz.org/playlist/54cc305b-f68e-4ab8-a2b9-3188727a3b5b/"
    }
  ],
  "total": 46,
  "username": "rob"
}

Search playlists

Find public playlists whose title or description resembles your words, closest match first. No API key required.

Inputs

Search forquerytextRequired
Words from a playlist's title or description, at least 3 characters.
How manycountnumber
How many playlists to return, from 1 to 100. 25 by default.From 1 to 100. Default: 25.
Skipoffsetnumber
How many to skip from the start of the list, to read further down it. 0 by default.From 0 to 100000. Default: 0.

Outputs

countnumber
How many came back.
offsetnumber
How many were skipped from the newest.
playlistslist
The playlists, newest first.
querytext
The words searched for.
totalnumber
How many playlists there are in all.
Example output
{
  "count": 1,
  "offset": 0,
  "playlists": [
    {
      "algorithm": null,
      "collaborators": [],
      "created_at": "2024-08-10T09:44:39Z",
      "created_for": null,
      "creator": "protodeniz",
      "description": null,
      "last_modified_at": "2024-08-10T09:44:39Z",
      "playlist_mbid": "510205aa-6480-4624-928c-43532d3baf80",
      "public": true,
      "title": "Jazz",
      "url": "https://listenbrainz.org/playlist/510205aa-6480-4624-928c-43532d3baf80/"
    }
  ],
  "query": "jazz",
  "total": 565
}

On this page