Skip to main content

​
@kreisler/anime-api

A powerful TypeScript library for fetching anime information from various sources. This package provides a comprehensive API for searching, browsing, and retrieving detailed anime data including episodes, characters, videos, and download links.

​
Installation

npm install @kreisler/anime-api

​
Quick Start

import { 
  search, 
  getAnimeInfo, 
  latestAnimeAdded, 
  latestEpisodesAdded 
} from '@kreisler/anime-api';

// Search for anime
const results = await search('naruto');

// Get detailed anime information
const info = await getAnimeInfo('anime/7/naruto', 'Naruto');

// Get latest anime added
const latest = await latestAnimeAdded();

// Get latest episodes
const episodes = await latestEpisodesAdded();

​
Core Features

​
Search Anime

Search for anime by title: 
import { search } from '@kreisler/anime-api';

const results = await search('one piece');

console.log(results);
// [
//   {
//     id: 'anime/1/one-piece',
//     title: 'One Piece',
//     poster: 'data:image/jpeg;base64,...',
//     banner: 'https://...',
//     synopsis: 'Monkey D. Luffy...',
//     debut: '1999',
//     type: 'TV',
//     rating: '4.5',
//     genres: ['Acción', 'Aventura', 'Comedia'],
//     episodes: [ /* episode list */ ]
//   }
// ]
Images are automatically converted to base64 format for easy embedding and caching.

​
Get Anime Information

Retrieve detailed information about a specific anime: 
import { getAnimeInfo } from '@kreisler/anime-api';

const anime = await getAnimeInfo(
  'anime/5226/tokyo-ghoul',
  'Tokyo Ghoul'
);

console.log(anime);
// [
//   {
//     id: 'anime/5226/tokyo-ghoul',
//     title: 'Tokyo Ghoul',
//     poster: 'data:image/jpeg;base64,...',
//     banner: 'https://...',
//     synopsis: 'Ken Kaneki is a college student...',
//     debut: '2014',
//     type: 'TV',
//     rating: '4.8',
//     genres: ['Acción', 'Drama', 'Horror'],
//     episodes: [ /* episode list */ ],
//     moreInfo: [ /* additional info */ ],
//     promoList: [ /* promo videos */ ],
//     charactersList: [ /* character info */ ]
//   }
// ]

​
Browse Anime

import { tv, movies, ova, special } from '@kreisler/anime-api';

// TV Series
const tvAnime = await tv('updated', '1');

// Movies
const movieAnime = await movies('added', '1');

// OVA
const ovaAnime = await ova('updated', '2');

// Specials
const specialAnime = await special('added', '1');

​
Parameters

  • order: 'updated' | 'added' - Sort by last updated or recently added
  • page: string - Page number (starts from ‘1’)
  • state: string - Anime state (‘1’ = airing, ‘2’ = completed)
  • genre: string - Genre name in Spanish (e.g., ‘comedia’, ‘accion’, ‘drama’)

​
Latest Releases

​
Latest Anime Added

Get the most recently added anime: 
import { latestAnimeAdded } from '@kreisler/anime-api';

const latest = await latestAnimeAdded();

console.log(latest);
// [
//   {
//     id: 'anime/12345/new-anime',
//     title: 'New Anime Title',
//     poster: 'data:image/jpeg;base64,...',
//     banner: 'https://...',
//     synopsis: '...',
//     debut: '2024',
//     type: 'TV',
//     rating: '4.5',
//     genres: ['Acción', 'Aventura'],
//     episodes: []
//   }
// ]

​
Latest Episodes

Get the most recently released episodes: 
import { latestEpisodesAdded } from '@kreisler/anime-api';

const episodes = await latestEpisodesAdded();

console.log(episodes);
// [
//   {
//     id: 'ver/episode-id',
//     title: 'Anime Name',
//     poster: 'data:image/jpeg;base64,...',
//     episode: 25,
//     servers: [
//       {
//         server: 'Server Name',
//         title: 'Episode 25',
//         ads: 0,
//         url: 'https://...',
//         allow_mobile: true,
//         code: 'embed_code'
//       }
//     ]
//   }
// ]

​
Episode & Streaming

​
Get Anime Servers

Get available streaming servers for an episode: 
import { getAnimeServers } from '@kreisler/anime-api';

const servers = await getAnimeServers('ver/naruto-1');

console.log(servers);
// [
//   {
//     server: 'Streamtape',
//     title: 'Naruto - Episodio 1',
//     ads: 0,
//     url: 'https://...',
//     allow_mobile: true,
//     code: '<iframe src="...">'
//   },
//   {
//     server: 'Mega',
//     title: 'Naruto - Episodio 1',
//     ads: 0,
//     allow_mobile: true,
//     code: 'embed_code'
//   }
// ]
Get download links for an episode: 
import { downloadLinksByEpsId } from '@kreisler/anime-api';

const links = await downloadLinksByEpsId('episode-id');

console.log(links);
// [
//   {
//     server: 'Mega',
//     url: 'https://mega.nz/...'
//   },
//   {
//     server: 'MediaFire',
//     url: 'https://mediafire.com/...'
//   }
// ]
Download links are scraped from external sources and may become unavailable. Always check if the link is valid before presenting it to users.

​
Character Information

​
Get Anime Characters

Retrieve character information for an anime: 
import { getAnimeCharacters } from '@kreisler/anime-api';

const characters = await getAnimeCharacters('Naruto');

console.log(characters);
// [
//   {
//     character: {
//       id: 17,
//       name: 'Naruto Uzumaki',
//       image: 'https://cdn.myanimelist.net/...',
//       role: 'Main'
//     }
//   },
//   {
//     character: {
//       id: 145,
//       name: 'Sasuke Uchiha',
//       image: 'https://cdn.myanimelist.net/...',
//       role: 'Main'
//     }
//   }
// ]

​
Get Promo Videos

Get promotional videos for an anime: 
import { getAnimeVideoPromo } from '@kreisler/anime-api';

const promos = await getAnimeVideoPromo('Tokyo Ghoul');

console.log(promos);
// [
//   {
//     title: 'Tokyo Ghoul PV',
//     previewImage: 'https://...',
//     videoURL: 'https://youtube.com/...'
//   }
// ]

​
Data Structures

​
Anime Object

interface Anime {
  id: string | null;
  title: string | null;
  poster: string | null;        // Base64 encoded image
  banner: string | null;
  synopsis: string | null;
  debut: string | null;
  type: string | null;
  rating: string | null;
  genres: string[] | null;
  episodes: AnimeEpisode[] | null;
}

​
Episode Object

interface AnimeEpisode {
  episode?: string;
  id?: string;
  imagePreview?: string;
  nextEpisodeDate?: string;
}

​
Server Object

interface IServersData {
  server: string;           // Server name
  title: string;            // Episode title
  ads: number;              // Number of ads
  url?: string;             // Direct URL
  allow_mobile: boolean;    // Mobile support
  code: string;             // Embed code
}

​
Filter Options

interface IFlvFiltros {
  'genre[]': 'comedia' | 'accion' | 'drama' | /* ... */;
  'year[]': number;
  'type[]': 'tv' | 'movie' | 'ova' | 'special';
  'status[]': number;       // 1: airing, 2: completed
  order: 'updated' | 'added';
  page: string;
}

​
Complete Example

import {
  search,
  getAnimeInfo,
  getAnimeServers,
  downloadLinksByEpsId,
  latestAnimeAdded
} from '@kreisler/anime-api';

async function animeApp() {
  // Search for anime
  const searchResults = await search('demon slayer');
  console.log('Found:', searchResults.length, 'results');
  
  // Get first result
  const anime = searchResults[0];
  console.log('Anime:', anime.title);
  
  // Get detailed information
  const [details] = await getAnimeInfo(anime.id, anime.title);
  console.log('Episodes:', details.episodes.length);
  
  // Get first episode servers
  const firstEpisode = details.episodes[1]; // Skip index 0 (metadata)
  const servers = await getAnimeServers(firstEpisode.id);
  console.log('Available servers:', servers.length);
  
  // Get download links
  const downloads = await downloadLinksByEpsId(firstEpisode.id);
  console.log('Download options:', downloads.length);
  
  // Get latest anime
  const latest = await latestAnimeAdded();
  console.log('Latest anime:', latest[0].title);
}

animeApp();

​
Express Server Example

The package includes Express server setup: 
import express from 'express';
import { search, getAnimeInfo } from '@kreisler/anime-api';

const app = express();

app.get('/api/search', async (req, res) => {
  const query = req.query.q as string;
  const results = await search(query);
  res.json(results);
});

app.get('/api/anime/:id', async (req, res) => {
  const id = req.params.id;
  const title = req.query.title as string;
  const info = await getAnimeInfo(id, title);
  res.json(info);
});

app.listen(3000, () => {
  console.log('API running on http://localhost:3000');
});

​
Dependencies

This package depends on:
  • cheerio - HTML parsing and scraping
  • cheerio-tableparser - Table data extraction
  • cloudscraper - Bypass Cloudflare protection
  • express - Web server framework (optional)
  • image-to-base64 - Image conversion
  • body-parser - Request body parsing
  • cors - Cross-origin resource sharing
  • helmet - Security headers

​
API Reference

​
Main Functions

FunctionParametersReturnsDescription
search(query)stringPromise<Anime[]>Search anime by title
getAnimeInfo(id, title)string, stringPromise<Anime[]>Get detailed anime info
latestAnimeAdded()-Promise<Anime[]>Get latest anime
latestEpisodesAdded()-Promise<Episode[]>Get latest episodes
getAnimeServers(id)stringPromise<IServersData[]>Get streaming servers
downloadLinksByEpsId(id)stringPromise<IDownloadLinksByEpsId[]>Get download links
getAnimeCharacters(title)stringPromise<Character[]>Get character list
getAnimeVideoPromo(title)stringPromise<Promo[]>Get promo videos
tv(order, page)string, stringPromise<Anime[]>Browse TV anime
movies(order, page)string, stringPromise<Anime[]>Browse movies
ova(order, page)string, stringPromise<Anime[]>Browse OVAs
special(order, page)string, stringPromise<Anime[]>Browse specials
animeByState(state, order, page)string, string, stringPromise<Anime[]>Browse by state
animeByGenres(genre, order, page)string, string, stringPromise<Anime[]>Browse by genre

​
Rate Limiting

The package uses cloudscraper to handle requests. Be mindful of rate limits when making multiple concurrent requests. Consider implementing:
  • Request queuing
  • Caching frequently accessed data
  • Exponential backoff for retries

​
TypeScript Support

Fully typed with comprehensive interfaces: 
import type {
  IFlvFiltros,
  IServersData,
  IDownloadLinksByEpsId
} from '@kreisler/anime-api';

​
License

MIT

Build docs developers (and LLMs) love

Get started for freeTalk to us