Releases

Browse releases

GET /releases

Browse and search releases.

Query String Params

Field	Type	Default	Description
limit?	integer	50	Amount of releases to return (max 50)
offset?	integer	0	Amount of releases to skip
search?	string	N/A	The search terms
sort?	string	-date	Field to sort by. Prefix with - for descending

Response

Field	Type	Description
Releases	object	Object with the results
Releases.Data	array of release objects	The results of the query
Releases.Limit	integer	The limit used
Releases.Offset	integer	The offset used
Releases.Total	integer	The total amount of results for the search

Get a release

GET /catalog/release/{Release.CatalogId}

Query String Params

Field	Type	Default	Description
idType?	string	catalogId	The type of ID used. catalogId or uuid

Response

Field	Type	Description
Release	release object	The release
Tracks	array of track objects	The tracks in the release

Get release cover art

GET https://www.monstercat.com/release/{Release.CatalogId}/cover

This endpoint is not under the usual base url!
Redirects to the original full resolution and quality cover image.
For resizing and different image formats, see CDX

Stream a track

GET /release/{Release.Id}/track-stream/{Track.Id}

Get a streamable MP3 file for the track.

Query String Params

Field	Type	Description
noRedirect	boolean	Respond with the url instead of redirecting

Response

Redirects to the streamable audio file.
If noRedirect is set, the response will just be a plain text url to the file.

Download a track

GET /release/{Release.Id}/track-download/{Track.Id}

Download the audio file of a track. Requires a Gold membership.

Query String Params

Field	Type	Description
noRedirect	boolean	Respond with filename and url instead of redirecting
format	string	The preferred audio file format (mp3_320, flac, wav)

Response

Redirects to the downloadable audio file.
If noRedirect is set, the following response will be given instead:

Field	Type	Description
Filename	string	Filename for the downloaded track
SignedUrl	string	The url the file can be downloaded from

Download an extended mix

GET /file/{File.Id}/open

Download the extended mix for a track. Requires a Gold membership.

Query String Params

Field	Type	Description
download	boolean	Sets appropriate headers to download with filename

Response

Redirects to the downloadable audio file.

Get related releases

GET /related-releases/{Release.Id}

Gets some releases from the same artists.

Response

Field	Type	Description
Data	array of release objects	The results of the query
Limit	integer	The limit used
Offset	integer	The offset used
Total	integer	The total amount of results for the search