TvdbClient 4.7.12

.NET 9.0 This package targets .NET 9.0. The package is compatible with this framework or higher. 
dotnet add package TvdbClient --version 4.7.12
                    


                    

                
NuGet\Install-Package TvdbClient -Version 4.7.12
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="TvdbClient" Version="4.7.12" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="TvdbClient" Version="4.7.12" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="TvdbClient" />
                    


                            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 TvdbClient --version 4.7.12
                    


                    

                
#r "nuget: TvdbClient, 4.7.12"
#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 TvdbClient@4.7.12
#: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=TvdbClient&version=4.7.12
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=TvdbClient&version=4.7.12
                    


                            Install as a Cake Tool

TvdbClient

NuGet Downloads Build & Test Built with Fallout License

A C# HttpClient-based API client for TheTVDB v4 API.

This is a thin client AS IS — it does not implement the caching/proxying that TheTVDB recommends. Add your own caching layer if you call the API at volume.

Packages

The client is split into three packages so the API-versioned models can be regenerated independently of the generic client code:

Package What Versioning
TvdbClient Client core: generated clients, auth, DI wiring. Generic SemVer
TvdbClient.Models The generated DTOs (Tvdb.Models). Tracks the TheTVDB API version (Major.Minor)
TvdbClient.Abstractions Generic contracts, configuration, response envelope. Generic SemVer

Installing TvdbClient pulls in the other two.

dotnet add package TvdbClient

Usage

Configuration

Provide your TheTVDB API key (and optional subscriber PIN) via configuration — either appsettings.json or a standalone TvdbClientConfig.json:

{
  "TvdbConfiguration": {
    "BaseUrl": "https://api4.thetvdb.com/v4",
    "ApiKey": "<your-api-key>",
    "Pin": "<optional-subscriber-pin>"
  }
}

Get an API key from TheTVDB's API Key dashboard.

DI registration

using Microsoft.Extensions.DependencyInjection;

builder.Configuration.AddTvdbClient();
builder.Services.AddTvdbClient(builder.Configuration);

Using the clients

Resolve the per-resource client you need. Login/token acquisition and the Authorization header are handled automatically by the registered handler.

using Tvdb.Clients;

var series = serviceProvider.GetRequiredService<ISeriesClient>();
var response = await series.SeriesGetAsync(121361);   // ids are long
var record = response.Data;                            // { data, status } envelope

Building

This project builds with Fallout (a NUKE fork) — the build lives in build/Build.cs and runs through the ./build.ps1 bootstrapper (no global tool required). CI (build.yml) invokes the same targets.

./build.ps1 Test       # run the *.Specs test suite
./build.ps1 Pack       # produce the three NuGet packages in artifacts/packages
./build.ps1 Generate   # regenerate the client + models from TheTVDB's OpenAPI spec

Regenerating the models

Models + clients are generated from TheTVDB's OpenAPI spec via the Fallout Generate target (NSwag under the hood):

./build.ps1 Generate

This downloads the live v4 spec, applies a small overlay (integer-id coercion, inline-enum hoisting), and regenerates TvdbClient.Models + the clients.

Versioning

Major.Minor track the TheTVDB API version; the patch is this library's own release counter. Managed with GitVersion (dotnet-gitversion).

License

MIT

Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  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. 
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
4.7.12 147 7/23/2026
4.7.11 88 7/23/2026
4.7.10 185 1/31/2025
4.7.10-refactoring-change-f... 76 7/21/2025