AniList.NET

A simple .NET API wrapper for AniList!

This project is designed to bring you a simpler way to access and interact with the AniList API. For more information about the API itself, visit AniList APIv2 docs.

⚒️ Usage

Install the library in your project.

• .NET CLI: dotnet add package AniListNet
• Package Manager CLI: Install-Package AniListNet

using AniListNet;
using AniListNet.Objects;
using AniListNet.Parameters;

// a simple class that fulfils all your needs
var client = new AniClient();

// easy authentication with AniList
var isAuthenticated = await client.TryAuthenticateAsync("<AUTH_TOKEN>");
if (!isAuthenticated)
  throw new Exception("Unable to authenticate with AniList!");

var results = await client.SearchMediaAsync(new SearchMediaFilter
{
   Query = "one piece", // the term to search for
   Type = MediaType.Anime, // filters search results to anime only
   Sort = MediaSort.Popularity, // sorts them by popularity
   Format = new Dictionary<MediaFormat, bool>
   {
      { MediaFormat.TV, true }, // set to only search for TV shows and movies
      { MediaFormat.Movie, true },
      { MediaFormat.TVShort, false } // set to not show TV shorts
   }
});

foreach (var result in results.Data) // prints all results into console
   Console.WriteLine(result.Title.EnglishTitle);

For more examples for using this library, visit the usages wiki or check out the unit tests.

⚙️ Features

Note: This library does not fully implement the API, so some features might be missing.

• Authenticate and login with AniList!
• Search for anime, manga, staff, studio and users! With filter support.
• Get intricate details about any anime or manga like relations, characters, staff, studios, and more!
• Get intricate details about any character or staff like which anime and manga they appeared in or worked on!
• Get user details like followers, entries, collections, and favorites!
• Update a user's followings, entries and favorites easily!

See more features by visiting the features wiki.

🔨 Todo

• Add query functions for notification data
• Add query/mutations functions for user activities
• Use same naming conventions for object data (target v2)
• Use generics instead of arrays (target v2)