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 30 days.
- Status Codes
200 OK – fetch succeeded
400 Bad Request – invalid date or number of days passed.
- Response Headers
Content-Type – application/json
- 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
200 OK – success
- Response Headers
Content-Type – application/json
- 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
200 OK – success
400 Bad Request – bad request: some parameters are missing or invalid
500 Internal Server Error – Troi encountered an error
- Response Headers
Content-Type – application/json
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
200 OK – You have data.
400 Bad Request – You did not provide a valid dump ID. See error message for details.
404 Not Found – Dump with given ID does not exist.
- Response Headers
Content-Type – application/json