MangaUpdates 1.0.0.1

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher. .NET Framework 4.8 This package targets .NET Framework 4.8. The package is compatible with this framework or higher. 
dotnet add package MangaUpdates --version 1.0.0.1
                    


                    

                
NuGet\Install-Package MangaUpdates -Version 1.0.0.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="MangaUpdates" Version="1.0.0.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="MangaUpdates" Version="1.0.0.1" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="MangaUpdates" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add MangaUpdates --version 1.0.0.1
                    


                    

                
#r "nuget: MangaUpdates, 1.0.0.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package MangaUpdates@1.0.0.1
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=MangaUpdates&version=1.0.0.1
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=MangaUpdates&version=1.0.0.1
                    


                            Install as a Cake Tool

MangaUpdates.NET

CI NuGet

A type-safe C# client for the MangaUpdates API, built on Refit and System.Text.Json.

This SDK is hand-maintained and kept in sync with the MangaUpdates OpenAPI specification manually — updates are applied directly to the interface and model source.

  • API version: 1.0.0
  • SDK version: 1.0.0.1 (tracks the API version; the 4th revision component denotes client-only changes)
  • Source specification: api/openapi-1.0.0.yaml (one file per API version, kept as history)

Most API functions are public and do not require an account. User-based functions require a bearer token; account registration must be done through the MangaUpdates website.

Installation

dotnet add package MangaUpdates

Multi-targets net10.0 and net48 (classic .NET Framework).

Usage

The clients are registered through dependency injection. Each API tag (Series, Members, Releases, …) is exposed as its own Refit interface under the MangaUpdates.Api namespace.

using MangaUpdates.Api;
using MangaUpdates.Client;
using Microsoft.Extensions.DependencyInjection;

var services = new ServiceCollection();

// Unauthenticated (public endpoints only):
services.AddMangaUpdates();

// Or with a bearer token for user-based endpoints:
services.AddMangaUpdates("your-access-token");

// Or configure fully:
services.AddMangaUpdates(options =>
{
    options.AccessToken = "your-access-token";
    options.BaseUrl = "https://api.mangaupdates.com/v1"; // default
    options.MaxRetryAttempts = 3;                        // default; 0 disables retry
});

var provider = services.BuildServiceProvider();

Then inject or resolve the interface you need:

var series = provider.GetRequiredService<ISeriesApi>();

var result = await series.RetrieveSeries(id: 12345);
Console.WriteLine(result.Title);

Every operation is asynchronous and returns the deserialized model directly (Task<T>). Pass a CancellationToken as the last argument to any call.

Configuration (MangaUpdatesOptions)

Option Default Description
BaseUrl https://api.mangaupdates.com/v1 API base address.
AccessToken null Bearer token; added automatically to every request when set.
MaxRetryAttempts 3 Automatic retries for transient failures (5xx, 408, 429, network errors). Set to 0 to disable.
RetryBaseDelay 1s Base delay for the exponential backoff (with jitter).

How it works

  • MangaUpdates.Api — one Refit interface per API tag (ISeriesApi, IMembersApi, …).
  • MangaUpdates.Model — request/response DTOs annotated with System.Text.Json attributes.
  • MangaUpdates.Client — DI registration (AddMangaUpdates), the bearer-token and Polly retry handlers, the shared serializer options, and the EnumMember-aware enum converter.

Errors surface as Refit's Refit.ApiException. Advanced users who do not use dependency injection can construct an interface manually with RestService.For<ISeriesApi>(...), supplying new SystemTextJsonContentSerializer(MangaUpdatesJson.Options).

Acceptable Use

Per the MangaUpdates API terms: credit MangaUpdates when using their data, space out requests, cache where possible, and do not use the data to deceive users, perform illegal actions, create spam, or damage the database.

License

MIT. See LICENSE.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Framework net48 is compatible.  net481 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0.1 72 8/11/2026
1.0.0 112 7/14/2026
0.1.0 288 8/27/2023

Refit 15; multi-targets net10.0 and net48. Same MangaUpdates API surface (1.0.0).