Miscellaneous

Various ListenBrainz API endpoints that are not documented elsewhere.

Explore API

These API endpoints allow fetching fresh releases and cover art details for a given color.

GET /1/explore/fresh-releases/

This endpoint fetches upcoming and recently released (fresh) releases and returns a list of:

{
    "artist_credit_name": "Röyksopp",
    "artist_mbids": [
      "1c70a3fc-fa3c-4be1-8b55-c3192db8a884"
    ],
    "release_date": "2022-04-29",
    "release_group_mbid": "4f1c579a-8a9c-4f96-92ae-befcdf3e0d32",
    "release_group_primary_type": "Album",
    "release_mbid": "1f1db316-8361-4a40-9633-550b259642f5",
    "release_name": "Profound Mysteries"
}
Parameters:

  • release_date – Fresh releases will be shown around this pivot date. Must be in YYYY-MM-DD format

  • days – The number of days of fresh releases to show. Max 90 days.

  • sort – The sort order of the results. Must be one of “release_date”, “artist_credit_name” or “release_name”. Default “release_date”.

  • past – Whether to show releases in the past. Default True.

  • future – Whether to show releases in the future. Default True.

Status Codes:
Response Headers:
GET /1/explore/color/(color)

Fetch a list of releases that have cover art that has a predominant color that is close to the given color.

{
    "payload": {
        "releases" : [
            {
              "artist_name": "Letherette",
              "color": [ 250, 90, 192 ],
              "dist": 109.973,
              "release_mbid": "00a109da-400c-4350-9751-6e6f25e89073",
              "caa_id": 34897349734,
              "release_name": "EP5",
              "recordings": "< array of listen formatted metadata >",
              },
            ". . ."
        ]
    }
}
Status Codes:
Response Headers:
GET /1/explore/lb-radio

Generate a playlist with LB Radio.

Parameters:

  • prompt – The LB Radio prompt from which to generate playlists.

  • mode – The mode that LB radio should use. Must be easy, medium or hard.

{
    "payload": {
        "jspf" : <JSPF playlist here>,
        "feedback": [ <user feedback items> ]
    }
}
Status Codes:
Response Headers:

Status API

GET /1/status/get-dump-info

Get information about ListenBrainz data dumps. You need to pass the id parameter in a GET request to get data about that particular dump.

Example response:

{
    "id": 1,
    "timestamp": "20190625-165900"
}
Query Parameters:

  • id – Integer specifying the ID of the dump, if not provided, the endpoint returns information about the latest data dump.

Status Codes:
Response Headers: