A simple, typed client to fetch anime, manga, character, staff and user data from AniList.
✨ Showcase: Check here to see which projects use this package!
- Zero dependencies — uses the native
fetchAPI - Universal — Node.js ≥ 20, Bun, Deno and modern browsers
- Dual format — ships ESM + CJS with full TypeScript declarations
- Reliable — Built-in caching, Rate-limit protections, automatic retries & request deduplication!
The full API reference, usage guide, and configuration examples are available on our official documentation website!
👉 View the full documentation here
# npm
npm install ani-client
# pnpm
pnpm add ani-client
# yarn
yarn add ani-client
# bun
bun add ani-clientimport { AniListClient, MediaType } from "ani-client";
const client = new AniListClient();
// Get an anime by ID
const cowboyBebop = await client.getMedia(1);
console.log(cowboyBebop.title.romaji); // "Cowboy Bebop"
// Search for anime
const results = await client.searchMedia({
query: "Naruto",
type: MediaType.ANIME,
perPage: 5,
});
console.log(results.results.map((m) => m.title.english));See CONTRIBUTING.md for development setup, coding standards, and how to submit changes.
MIT © gonzyui