MonstercatNet

MonstercatNet is a .NET wrapper around the API that drives monstercat.com written in C#.

Supported Platforms

Since this library relies on refit for setting up the API endpoints, there are limitations. You can find the limitations here.

Installation

You can find the latest nuget package here.

Changelog

See here

Usage

creating the api client

usingSoftThorn.MonstercatNet;varhttpClient=newHttpClient().UseMonstercatApiV2();varclient=MonstercatApi.Create(httpClient);

creating the cdn client

usingSoftThorn.MonstercatNet;varhttpClient=newHttpClient().UseMonstercatCdn();varclient=MonstercatCdn.Create(httpClient);

NOTE: The HttpClient for the CDN should be a different instance than the one for the API, as they use a different BaseAddress.

signing in

usingSoftThorn.MonstercatNet;varcredentials=newApiCredentials(){Email="",// your account e-mailPassword=""// your password};awaitclient.Login(credentials);

searching for music

usingSoftThorn.MonstercatNet;vartracks=awaitclient.SearchTracks(newTrackSearchRequest(){Limit=1,Skip=0,Creatorfriendly=true,Genres=new[]{"Drumstep"},ReleaseTypes=new[]{"Album"},Tags=new[]{"Uncaged","Energetic"},});

getting albumns, EPs and singles (releases)

usingSoftThorn.MonstercatNet;varreleases=awaitclient.GetReleases(newReleaseBrowseRequest(){Limit=1,Skip=0});

getting release details

usingSoftThorn.MonstercatNet;varrelease=awaitclient.GetRelease("the release catalogId which looks like this MCRLX001-8");

getting release cover

usingSoftThorn.MonstercatNet;varcdn=MonstercatCdn.Create(newHttpClient(newHttpLoggingHandler()).UseMonstercatCdn());varbuilder=ReleaseCoverArtBuilder.Create().ForRelease(newTrackRelease(){CatalogId="the release catalog Id which looks like this 2FMCS1347"};);varreleaseCoverBytes=awaitcdn.GetReleaseCoverAsByteArray(builder);varreleaseCoverStream=awaitcdn.GetReleaseCoverAsStream(builder);

Endpoints

The currently implemented and supported endpoints can be found here

Versions

See here

Contributing

See here

---

A special thanks goes out to defvs who with many others documented the unofficial API.