Releases

Checking ONE Release: Endpoint /release

Getting a single release: GET /catalog/release/[catalogId]

Options

Probably field filtering

Result

• related: numeric array containing related releases
• release: the requested release object
  • see Release object
• tracks: numeric array with all the tracks in the requested release
  • see Track object

Getting coverart: GET /release/[releaseId]/cover

Returns cover for the release provided. Currently a 307 Redirect to AWS.

Options

• image_width: Final size of the cover file
• fallbackUrl: will redirect to this URL if cover fails to load

Streaming track from the API: GET /release/[releaseId]/track-stream/[trackId]

Returns an MP3 file for streaming the track.

Downloading whole release as a .zip: GET /release/[releaseId]/download

Options

• format: can be mp3_320, flac, wav. There is backward compatibility with old mp3 bitrates which redirects to mp3_320.

Downloading a track individually with Gold: GET /release/[releaseId]/track-download/[trackId]

Options

• format: can be mp3_320, flac, wav. There is backward compatibility with old mp3 bitrates which redirects to mp3_320.

---

Listing all Releases: /releases

Browsing releases: GET /releases

Options

• limit & skip

Result

• results: numeric array containing Release objects
• total: Total number of releases in the database
• limit / skip: you should start knowing those.