{"id":27313389,"url":"https://github.com/insire/monstercatnet","last_synced_at":"2025-04-12T06:54:44.406Z","repository":{"id":38009482,"uuid":"297021417","full_name":"Insire/MonstercatNet","owner":"Insire","description":"MonstercatNet is a .NET wrapper around the API that drives monstercat.com written in C#","archived":false,"fork":false,"pushed_at":"2025-03-15T09:49:39.000Z","size":288,"stargazers_count":4,"open_issues_count":2,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-12T06:54:39.276Z","etag":null,"topics":["api","hacktoberfest","monstercat","monstercat-api","wrapper-library"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Insire.png","metadata":{"files":{"readme":"readme.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-09-20T07:06:17.000Z","updated_at":"2024-05-26T12:37:57.000Z","dependencies_parsed_at":"2023-12-11T23:01:00.374Z","dependency_job_id":"24e0ef4c-c223-480e-8fc0-05d86d66d2ef","html_url":"https://github.com/Insire/MonstercatNet","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Insire%2FMonstercatNet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Insire%2FMonstercatNet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Insire%2FMonstercatNet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Insire%2FMonstercatNet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Insire","download_url":"https://codeload.github.com/Insire/MonstercatNet/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248530585,"owners_count":21119595,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","hacktoberfest","monstercat","monstercat-api","wrapper-library"],"created_at":"2025-04-12T06:54:43.589Z","updated_at":"2025-04-12T06:54:44.398Z","avatar_url":"https://github.com/Insire.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MonstercatNet\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/Insire/MonstercatNet/blob/master/LICENSE.md)\n[![NuGet](https://img.shields.io/nuget/v/MonstercatNet)](https://www.nuget.org/packages/MonstercatNet/)\n[![Build status](https://dev.azure.com/SoftThorn/MonstercatNet/_apis/build/status/MonstercatNet-CD)](https://dev.azure.com/SoftThorn/MonstercatNet/_build/latest?definitionId=3)\n[![CodeFactor](https://www.codefactor.io/repository/github/insire/monstercatnet/badge)](https://www.codefactor.io/repository/github/insire/monstercatnet)\n[![codecov](https://codecov.io/gh/Insire/MonstercatNet/branch/master/graph/badge.svg)](https://codecov.io/gh/Insire/MonstercatNet)\n\nMonstercatNet is a .NET wrapper around the API that drives [monstercat.com](https://www.monstercat.com/) written in C#.\n\n## Supported Platforms\n\nSince this library relies on [refit](https://github.com/reactiveui/refit) for setting up the API endpoints, there are limitations. You can find the limitations [here](https://github.com/reactiveui/refit#where-does-this-work).\n\n## Installation\n\nYou can find the latest nuget package [here](https://www.nuget.org/packages/MonstercatNet/).\n\n## Changelog\n\nSee [here](CHANGELOG.md)\n\n## Usage\n\n### creating the api client\n\n```cs\nusing SoftThorn.MonstercatNet;\n\nvar httpClient  = new HttpClient().UseMonstercatApiV2();\nvar client = MonstercatApi.Create(httpClient);\n```\n\n### creating the cdn client\n\n```cs\nusing SoftThorn.MonstercatNet;\n\nvar httpClient  = new HttpClient().UseMonstercatCdn();\nvar client = MonstercatCdn.Create(httpClient);\n```\n\n**NOTE:** The ``HttpClient`` for the CDN should be a different instance than the one for the API, as they use a different BaseAddress.\n\n### signing in\n\n```cs\nusing SoftThorn.MonstercatNet;\n\nvar credentials = new ApiCredentials()\n{\n    Email = \"\", // your account e-mail\n    Password = \"\" // your password\n};\n\nawait client.Login(credentials);\n```\n\n### searching for music\n\n```cs\nusing SoftThorn.MonstercatNet;\n\nvar tracks = await client.SearchTracks(new TrackSearchRequest()\n{\n    Limit = 1,\n    Skip = 0,\n    Creatorfriendly = true,\n    Genres = new[] { \"Drumstep\" },\n    ReleaseTypes = new[] { \"Album\" },\n    Tags = new[] { \"Uncaged\", \"Energetic\" },\n});\n```\n\n### getting albumns, EPs and singles (releases)\n\n```cs\nusing SoftThorn.MonstercatNet;\n\nvar releases = await client.GetReleases(new ReleaseBrowseRequest()\n{\n    Limit = 1,\n    Skip = 0\n});\n```\n\n### getting release details\n\n```cs\nusing SoftThorn.MonstercatNet;\n\nvar release = await client.GetRelease(\"the release catalogId which looks like this MCRLX001-8\");\n```\n\n### getting release cover\n\n```cs\nusing SoftThorn.MonstercatNet;\n\nvar cdn = MonstercatCdn.Create(new HttpClient(new HttpLoggingHandler()).UseMonstercatCdn());\n\nvar builder = ReleaseCoverArtBuilder\n    .Create()\n    .ForRelease(new TrackRelease() { CatalogId = \"the release catalog Id which looks like this 2FMCS1347\" };);\n\nvar releaseCoverBytes = await cdn.GetReleaseCoverAsByteArray(builder);\nvar releaseCoverStream = await cdn.GetReleaseCoverAsStream(builder);\n```\n\n## Endpoints\n\nThe currently implemented and supported endpoints can be found [here](endpoints.md)\n\n## Versions\n\nSee [here](versioning.md)\n\n## Contributing\n\nSee [here](CONTRIBUTING.md)\n\n----\nA special thanks goes out to [defvs](https://github.com/defvs/connect-v2-docs) who with many others documented the unofficial API.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finsire%2Fmonstercatnet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finsire%2Fmonstercatnet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finsire%2Fmonstercatnet/lists"}