Base URL: https://connect.monstercat.com/api
GET Returns tracks paired with their releases. Tracks that are on two releases will be returned twice.
| Param | Description |
|---|---|
| search | Does a text search on track title, artists, and albums |
| playlistId | Will only return tracks on provided playlist |
| albumId | Only returns tracks found on that album |
| isrc | Return track with that ISRC |
| types | Comma separated list of album types. Options: Single, EP, Podcast, Album |
| genres | Comma separated list of album genres. |
| tags | Comma separate list of track tags. |
| sortOn | Field to sort on. Options: title, release (album title), bpm, time (track duration), date (album release date), artists (artistsTitle field) |
| sortDirection | -1 for descending, 1 for ascending. |
GET Returns all tracks - you can use default collection query options.
WARNING
Even though this route is publicly available, it may not be available in future releases. It is advised to fetch releases and their tracks. See below.
GET Returns a track by id.
GET Returns all releases - you can use default collection query options
GET Returns a release by id OR catalog id
GET Returns tracks for a release - you can use default collection query options
GET Returns all artists - you can use default collection query options
GET Returns an artist by id or their vanity URI
GET Returns an artists releases
Requires you to be logged in!
GET Returns your playlists
POST Create a new playlist
{
"name":"New Playlist",
"tracks":[]
}PUT Add a track to a playlist
{
"_id": "56290bf0ddd2cfb810eddae9",
"name": "Valkyrie",
"userId": "55fc1f7d53c399fc274c5054",
"deleted": false,
"public": false,
"tracks": [{"trackId":"5614507cc5df9f40201f85ed","releaseId":"561c5da57fb673586a3d2a98"},{"trackId":"56e0a83280a64c6105fcc8ec","releaseId":"57083d7e85ff0545443034e3","startTime":0}]
}Requires you to be logged in!
PUT Rename playlist or make it public
{
"_id": "5725bc898fcb2ef579fe5f9d",
"name": "New Playlist Name",
"userId": "55fc1f7d53c399fc274c5054",
"deleted": false,
"public": false,
"tracks": []
}DELETE Delete this playlist
GET Returns tracks for a playlist - you can use default collection query options
Requires you to be logged in!
GET Returns information about your account
Requires you to be logged in!
GET Returns information about your current session
Query options are simple URL query string key values.
fields=a,b,c
Specifies the fields you wish to receive by a comma separated string.
WARNING
Some fields are mandatory and will appear anyways.
ids=id1,id2
Specifies specific ids you want to fetch instead of the whole collection.
This parameter is not available on the /catalog/browse route.
skip=100
Specifies the starting point of the collection you wish to fetch.
limit=10
Specifies the number of results you wish to fetch.
WARNING
In the future it may be capped.
fuzzy=field1,value1,field2,value2
Specifies searches with fuzzy matching. This is an AND operation. Use fuzzyOr for OR operations.
The parameter value is a comma separated pair list.
This parameter is not available on the /catalog/browse route.
filters=field1,value1,field2,value2
Specifies searches with exact matching. Case sensitive. This is an AND operation. Use filtersOr for OR operations.
The parameter value is a comma separated pair list.
This parameter is not available on the /catalog/browse route.