Player

The player endpoints create temporary JSPF playlists for instant playback from recording or release MBIDs.

POST /player/

Create an instant JSPF playlist from a list of recording MBIDs.

This endpoint accepts a comma-separated list of recording MBIDs as a query parameter, fetches their metadata, and returns a JSPF playlist suitable for immediate playback. All parameters are passed as query string arguments.

The response is a JSON object containing a JSPF playlist with track entries for each valid recording MBID.

Note

We recommend that you do not send more than 50 recording_mbids in one request – our server infrastructure will likely give you a gateway error (502) if you do.

Parameters:

  • recording_mbids (str) – A comma separated list of recording MBIDs (query string).

  • desc (str) – A description for this instant playlist (optional, defaults to “Instant playlist”).

  • name (str) – A name for this instant playlist (optional, defaults to “Instant playlist”).

Status Codes:

  • 200 OK – playlist generated, returns JSPF.

  • 400 Bad Request – recording_mbids parameter is missing or contains an invalid UUID.

Response Headers:
POST /player/release/(release_mbid)/

Create a JSPF playlist from all tracks on a MusicBrainz release.

Given a release MBID, this endpoint looks up the release in MusicBrainz, retrieves all tracks across all media, and returns them as a JSPF playlist. Cover art information is included when available.

Parameters:

  • release_mbid (str) – A valid MusicBrainz release MBID (URL path parameter).

Status Codes:

  • 200 OK – playlist generated, returns JSPF.

  • 400 Bad Request – the provided release_mbid is not a valid UUID.

  • 404 Not Found – the release was not found in the MusicBrainz database.

Response Headers:
GET /player/
GET /player/(path: path)/