shishantbiswas/AniKotoAPI
1
0
Fork 0
mirror of https://github.com/Shineii86/AniKotoAPI.git synced 2026-10-22 10:55:10 +00:00
Code Issues Packages Projects Releases Wiki Activity
11 Commits 1 Branch 24 Tags
afc5be3864ec521491d3f8d3bd18fef2d5d1eeef
T
Clone
Open with VS Code Open with VSCodium Open with Intellij IDEA
Download ZIP Download TAR.GZ Download BUNDLE

README.md

Stars Forks Issues Pull Requests Last Commit License

Node.js Express Cheerio Vercel License Version Endpoints Anime Database

A complete RESTful API scraping real-time anime data from anikototv.to
Search, browse, filter, watch — every endpoint returns live data with 5-minute smart caching.
Built for building anime websites, apps, and bots.

Table of Contents • Features • API Docs • Quick Start • Deployment • Contributing

📖 Table of Contents

🌸 Overview

AniKatoAPI is a serverless anime data API that scrapes and serves real-time information from anikototv.to — including anime details, episode lists, streaming servers, search, filtering, rankings, and more — all through a clean REST API with zero database setup.

💡 No database, no auth, no complex setup. Just deploy to Vercel and you have a production API.

Why AniKatoAPI?

  • 🎬 24 Endpoints — Complete coverage of anikototv.to data
  • 🔍 Full-Text Search — Search anime by keyword with suggestions
  • 📺 Episode Lists — AJAX-loaded episode data with server info
  • 🎯 Smart Filtering — Genre, type, status, rating, sort, season, year
  • 🏆 Rankings — Top 10 (day/week/month), trending, most popular
  • 🎲 Random Anime — Random anime discovery endpoint
  • ⚡ Smart Caching — 5-minute TTL reduces source site load
  • 🔒 CORS Enabled — Works from any frontend, no proxy needed
  • 🚀 Zero-Config Deploy — One click to Vercel, or run standalone with Express
  • 📊 Live Data — Every response is fresh from the actual website

How It Works

flowchart TD
    A["🌐 Client Request<br/>(Browser / App / curl)"] --> B["🛡️ Vercel Edge / Express Server<br/>CORS · Security Headers"]
    B --> C{"💾 Cache Check<br/>(In-Memory Map)"}
    C -- HIT --> D["⚡ Return Cached Response<br/>~200ms"]
    C -- MISS --> E["🔍 Cheerio Scraper"]

    E --> E1["Home Page"]
    E --> E2["Search Results"]
    E --> E3["Watch Pages"]
    E --> E4["AJAX Endpoints"]
    E --> E5["Filter Pages"]

    E1 & E2 & E3 & E4 & E5 --> F["Axios HTTP Fetch<br/>Custom Headers · 15s Timeout"]
    F --> G["Parse HTML<br/>Cheerio Selectors"]
    G --> H["Cache + Respond<br/>JSON"]

    style A fill:#1e1e2e,stroke:#a78bfa,color:#f1f5f9
    style B fill:#1e1e2e,stroke:#6366f1,color:#f1f5f9
    style C fill:#1e1e2e,stroke:#f43f8e,color:#f1f5f9
    style D fill:#1e1e2e,stroke:#22c55e,color:#f1f5f9
    style E fill:#1e1e2e,stroke:#a855f7,color:#f1f5f9
    style F fill:#1e1e2e,stroke:#eab308,color:#f1f5f9
    style G fill:#1e1e2e,stroke:#06b6d4,color:#f1f5f9
    style H fill:#1e1e2e,stroke:#22c55e,color:#f1f5f9

✨ Features

⚡ Core

  • Real-time scraping from anikototv.to

  • Smart caching with 5-minute TTL

  • 24 RESTful endpoints covering all data

  • AJAX episode loading for accurate data

  • Mapper API integration for extra servers

  • Graceful error handling per endpoint

🔍 Data

  • Keyword search with pagination (/api/search)

  • Search suggestions for autocomplete (/api/search/suggest)

  • Advanced filtering — genre, type, status, rating, sort, season, year

  • AZ List alphabetical browsing (/api/az-list/:letter)

  • Random anime discovery (/api/random)

  • Top 10 rankings day/week/month (/api/top-ten)

📺 Streaming

  • Watch page — full episode data with servers

  • Stream info — video embed URLs via AJAX

  • Server list — all available streaming servers

  • Mapper API — gogoanime/anivibe server sources

  • Episode navigation — prev/next episode data

  • Next episode schedule — countdown timer data

🛡️ Reliability

  • CORS enabled — works from any frontend

  • Error responses with descriptive messages

  • Input validation — required params checked

  • Timeout protection — 15s per request

  • Multiple domains — fallback mirror support

  • Zero dependencies on databases — pure scraping

🌟 Feature Highlights

Feature Description Status
🎬 24 API Endpoints Complete coverage of anime data ✅
🔍 Full-Text Search Keyword search with pagination ✅
📺 Episode Lists AJAX-loaded episode data ✅
🎯 Advanced Filtering Genre, type, status, rating, sort ✅
🏆 Top 10 Rankings Day/week/month leaderboards ✅
🎲 Random Anime Random anime discovery ✅
📡 Streaming Servers Video embed URLs + mapper API ✅
📋 AZ List A-Z alphabetical browsing ✅
🔄 Smart Caching 5-min TTL, in-memory Map ✅
🚀 One-Click Deploy Vercel button deployment ✅
🏗️ Express Mode Standalone server with npm start ✅
📖 AlisaReactionBot Style Full JSDoc documentation ✅

🗞️ Anime Data Source

Source Domain Status Data
AniKato anikototv.to ✅ Active Primary source
AniKato anikoto.cz ✅ Active Mirror domain
AniKato anikoto.me ✅ Active Mirror domain
AniKato anikoto.net ✅ Active Mirror domain
AniKato anikoto.se ✅ Active Mirror domain

Data Available

Category Count Source
🎬 Total Anime 10,000+ anikototv.to
📺 Total Episodes 100,000+ AJAX endpoints
🏷️ Genres 43 Genre pages
🎭 Types 6 TV, Movie, OVA, ONA, Special, Music
📊 Statuses 3 Airing, Finished, Not Yet Aired

🛠️ Tech Stack

Technology Purpose Version Documentation
🟢 Node.js JavaScript runtime >= 20 Docs
⚡ Express HTTP server framework 5.2 Docs
▲ Vercel Functions Serverless deployment — Docs
🔍 Cheerio HTML parsing & scraping 1.0 Docs
🌐 Axios HTTP client 1.11 Docs
🔧 dotenv Environment variables 17.2 Docs
🔒 cors CORS middleware 2.8 Docs
🍪 cookie-parser Cookie parsing 1.4 Docs

📦 Key Dependencies

{
  "express": "^5.2.0",        // HTTP server
  "axios": "^1.11.0",         // HTTP client for scraping
  "cheerio": "^1.0.0-rc.12",  // HTML parsing
  "cors": "^2.8.5",           // CORS middleware
  "dotenv": "^17.2.0",        // Environment variables
  "cookie-parser": "^1.4.7"   // Cookie parsing
}

🏗️ Architecture

Request Flow

Stage Component Description
1 Client Browser, app, or curl sends request
2 Vercel Edge / Express Routes request, applies CORS + security headers
3 Cache Check In-memory Map with 5-min TTL — hit = instant response
4 Scrape Source Axios fetches HTML from anikototv.to with custom headers
5 Parse HTML Cheerio extracts data using CSS selectors
6 Cache + Respond Store in cache, return JSON response

Caching Architecture

flowchart TD
    A["📥 Request"] --> B{"🧠 Memory Cache<br/>(Map + TTL)"}
    B -- HIT --> C["⚡ Return Cached<br/>~200ms"]
    B -- MISS --> D["🌐 Fetch from<br/>anikototv.to"]
    D --> E["🔍 Parse with<br/>Cheerio"]
    E --> F["💾 Cache Result<br/>(5-min TTL)"]
    F --> G["📤 Return Fresh"]

    style A fill:#1e1e2e,stroke:#a78bfa,color:#f1f5f9
    style B fill:#1e1e2e,stroke:#f43f8e,color:#f1f5f9
    style C fill:#1e1e2e,stroke:#22c55e,color:#f1f5f9
    style D fill:#1e1e2e,stroke:#6366f1,color:#f1f5f9
    style E fill:#1e1e2e,stroke:#06b6d4,color:#f1f5f9
    style F fill:#1e1e2e,stroke:#a855f7,color:#f1f5f9
    style G fill:#1e1e2e,stroke:#22c55e,color:#f1f5f9

💡 Serverless functions have read-only filesystems except /tmp. The cache uses in-memory Map which survives across warm invocations.

📁 Project Structure

AniKatoAPI/
├── 📂 public/                            # 🌐 Static files
│   ├── 📄 index.html                     #    📖 API documentation page
│   └── 📄 404.html                       #    ❌ Custom 404 error page
│
├── 📂 src/                               # ⚙️ Core logic
│   ├── 📂 configs/                       #    🔧 Configuration files
│   │   ├── 📄 dataUrl.js                 #       🌐 URL patterns for anikototv.to
│   │   ├── 📄 header.config.js           #       📋 Request headers
│   │   └── 📄 ids.config.js              #       🏷️ Genre/Type/Status/Rating ID mappings
│   │
│   ├── 📂 controllers/                   #    🎮 Route handlers (22 files)
│   │   ├── 📄 homeInfo.controller.js
│   │   ├── 📄 animeInfo.controller.js
│   │   ├── 📄 search.controller.js
│   │   ├── 📄 episodeList.controller.js
│   │   ├── 📄 episodeListAjax.controller.js
│   │   ├── 📄 streamInfo.controller.js
│   │   ├── 📄 filter.controller.js
│   │   ├── 📄 watchPage.controller.js
│   │   └── 📄 ... (14 more)
│   │
│   ├── 📂 extractors/                    #    🔍 HTML scrapers (22 files)
│   │   ├── 📄 homeInfo.extractor.js      #       🏠 Home page data
│   │   ├── 📄 search.extractor.js        #       🔍 Search results
│   │   ├── 📄 animeInfo.extractor.js     #       📺 Anime details
│   │   ├── 📄 streamInfo.extractor.js    #       📡 Streaming servers
│   │   ├── 📄 filter.extractor.js        #       🎯 Filtered results
│   │   ├── 📄 watchPage.extractor.js     #       ▶️ Watch page data
│   │   ├── 📄 episodeList.extractor.js   #       📋 Episode lists
│   │   └── 📄 ... (15 more)
│   │
│   ├── 📂 helper/                        #    🛠️ Utility functions
│   │   ├── 📄 cache.helper.js            #       💾 In-memory caching
│   │   ├── 📄 countPages.helper.js       #       📄 Pagination counter
│   │   ├── 📄 extractPages.helper.js     #       📃 Page fetcher
│   │   └── 📄 formatTitle.helper.js      #       🔤 Title formatter
│   │
│   └── 📂 routes/                        #    🛤️ Express routes
│       ├── 📄 apiRoutes.js               #       🌐 Main API routes (24 endpoints)
│       └── 📄 category.route.js          #       🏷️ Category routes
│
├── 📄 server.js                          # 🚀 Express server entry point
├── 📄 package.json                       # 📦 Dependencies & scripts
├── 📄 vercel.json                        # ▲ Vercel routing & headers config
├── 📄 CHANGELOG.md                       # 📝 Version history
├── 📄 LICENSE                            # 📜 MIT License
└── 📄 README.md                          # 📖 This file

🚀 Quick Start

Prerequisites

Requirement Minimum Recommended
📦 Node.js 20.x 20.x LTS
📦 npm 9.0+ 10.x
💻 OS Windows, macOS, Linux Any

🔧 Installation

# 1️⃣ Clone the repository
git clone https://github.com/Shineii86/AniKatoAPI.git
cd AniKatoAPI

# 2️⃣ Install dependencies
npm install

# 3️⃣ Start development server
npm run dev

🌐 Open http://localhost:4444 in your browser.

🏗️ Build for Production

# Start production server
npm start

🐳 Alternative Package Managers

# Using yarn
yarn install
yarn dev

# Using pnpm
pnpm install
pnpm dev

# Using bun
bun install
bun dev

⚙️ Configuration

Environment Variables

Variable Default Description
PORT 4444 Server port (Express mode only)
ALLOWED_ORIGINS * Comma-separated allowed origins

Vercel Configuration

The vercel.json file handles:

  • Builds — Maps server.js to @vercel/node
  • Routes — All requests forwarded to Express
  • Headers — CORS Access-Control-Allow-Origin: *

📡 API Endpoints

Base URL

https://anikato.vercel.app/api

GET /api/

Home page data — spotlight carousel, trending anime, top airing, and genre list.

curl "https://anikato.vercel.app/api/"
📄 Example Response 
{
  "success": true,
  "results": {
    "spotlights": [
      {
        "slug": "one-piece-odmau",
        "poster": "https://image.tmdb.org/t/p/original/a6ptrTUH1c5OdWanjyYtAkOuYD0.jpg",
        "title": "One Piece",
        "japaneseTitle": "One Piece",
        "description": "",
        "rating": "PG-13",
        "quality": "HD",
        "sub": 0,
        "dub": 0,
        "date": "Oct 20, 1999 to ?"
      }
    ],
    "trending": [
      {
        "slug": "one-piece-odmau/ep-1165",
        "poster": "https://cdn.anipixcdn.co/thumbnail/f899139df5e1059396431415e770c6dd.jpg",
        "title": "One Piece",
        "japaneseTitle": "One Piece",
        "sub": 1165,
        "dub": 1133,
        "total": 0,
        "type": "TV"
      }
    ],
    "topAiring": [
      {
        "slug": "one-piece-odmau",
        "poster": "https://cdn.anipixcdn.co/thumbnail/f899139df5e1059396431415e770c6dd.jpg",
        "title": "One Piece",
        "sub": 1165,
        "dub": 1133,
        "type": ""
      }
    ],
    "genres": [
      "Action", "Adventure", "Comedy", "Drama", "Fantasy",
      "Horror", "Isekai", "Mecha", "Mystery", "Romance",
      "Sci-Fi", "Slice of Life", "Sports", "Supernatural", "Thriller"
    ]
  }
}

GET /api/search

Search anime by keyword with pagination.

Param Type Default Description
keyword string required Search query
page number 1 Page number 
curl "https://anikato.vercel.app/api/search?keyword=one+piece"
📄 Example Response 
{
  "success": true,
  "results": {
    "totalPages": 11,
    "data": [
      {
        "slug": "one-piece-episode-of-luffy-hand-island-adventure-br7lf/ep-1",
        "animeId": "769",
        "poster": "https://cdn.anipixcdn.co/thumbnail/4f16c818875d9fcb6867c7bdc89be7eb.jpg",
        "title": "One Piece: Episode of Luffy - Hand Island Adventure",
        "japaneseTitle": "One Piece: Episode of Luffy - Hand Island no Bouken",
        "sub": 1,
        "dub": 0,
        "total": 0,
        "type": "Special",
        "rating": "7.68",
        "genres": ["Action", "Adventure", "Fantasy", "Comedy", "Shounen", "Super Power"]
      },
      {
        "slug": "one-piece-odmau/ep-1",
        "animeId": "1642",
        "poster": "https://cdn.anipixcdn.co/thumbnail/f899139df5e1059396431415e770c6dd.jpg",
        "title": "One Piece",
        "japaneseTitle": "One Piece",
        "sub": 1165,
        "dub": 1133,
        "total": 0,
        "type": "TV",
        "rating": "8.73",
        "genres": ["Action", "Adventure", "Fantasy", "Comedy", "Shounen", "Super Power", "Drama"]
      }
    ]
  }
}

GET /api/search/suggest

Search suggestions for autocomplete (returns max 10 results).

Param Type Default Description
keyword string required Search query 
curl "https://anikato.vercel.app/api/search/suggest?keyword=one+piece"
📄 Example Response 
{
  "success": true,
  "results": [
    {
      "slug": "one-piece-odmau/ep-1",
      "poster": "https://cdn.anipixcdn.co/thumbnail/f899139df5e1059396431415e770c6dd.jpg",
      "title": "One Piece",
      "japaneseTitle": "One Piece",
      "type": "TV"
    }
  ]
}

GET /api/info

Detailed anime information including synopsis, genres, studios, and more.

Param Type Default Description
id string required Anime slug 
curl "https://anikato.vercel.app/api/info?id=one-piece-odmau"
📄 Example Response 
{
  "success": true,
  "results": {
    "slug": "one-piece-odmau",
    "animeId": 1642,
    "title": "One Piece",
    "japaneseTitle": "One Piece",
    "altNames": "",
    "poster": "https://cdn.anipixcdn.co/thumbnail/f899139df5e1059396431415e770c6dd.jpg",
    "backgroundImage": "...",
    "synopsis": "Gol D. Roger was known as the Pirate King...",
    "type": "TV",
    "premiered": "Fall 1999",
    "aired": "Oct 20, 1999",
    "status": "Currently Airing",
    "malScore": "8.73",
    "duration": "24 min",
    "episodes": "Unknown",
    "studios": ["Toei Animation"],
    "producers": [],
    "genres": ["Action", "Adventure", "Fantasy", "Comedy", "Shounen", "Super Power", "Drama"],
    "rating": "8.73",
    "reviewCount": "0"
  }
}

GET /api/watch

Complete watch page data — anime info, episode list, servers, trending, and recommended.

Param Type Default Description
slug string required Anime slug
ep number required Episode number 
curl "https://anikato.vercel.app/api/watch?slug=one-piece-odmau&ep=1165"
📄 Example Response 
{
  "success": true,
  "results": {
    "slug": "one-piece-odmau",
    "animeId": 1642,
    "animeUrl": "/watch/one-piece-odmau",
    "title": "One Piece",
    "japaneseTitle": "One Piece",
    "episodeNumber": 1165,
    "synopsis": "Gol D. Roger was known as the Pirate King...",
    "type": "TV",
    "status": "Currently Airing",
    "malScore": "8.73",
    "duration": "24 min",
    "episodes": "Unknown",
    "studios": ["Toei Animation"],
    "genres": ["Action", "Adventure", "Fantasy"],
    "rating": "8.73",
    "poster": "https://cdn.anipixcdn.co/thumbnail/f899139df5e1059396431415e770c6dd.jpg",
    "backgroundImage": "...",
    "nextEpisodeDate": "",
    "nextEpisodeTimestamp": 0,
    "servers": [
      {
        "linkId": "...",
        "epId": "...",
        "cmId": "...",
        "svId": "...",
        "name": "Vidstreaming",
        "type": "sub"
      }
    ],
    "trending": [...],
    "recommended": [...]
  }
}

GET /api/episodes/:id

Episode list for an anime (loaded via AJAX for accuracy).

Param Type Default Description
id string required Anime slug 
curl "https://anikato.vercel.app/api/episodes/one-piece-odmau"
📄 Example Response 
{
  "success": true,
  "results": {
    "animeId": 1642,
    "slug": "one-piece-odmau",
    "totalEpisodes": 0,
    "episodes": []
  }
}

GET /api/episodes-ajax/:id

Raw AJAX episode list response from the source site. Returns HTML that contains episode buttons with data-ep-id, data-num, and data-slug attributes.

Param Type Default Description
id number required Anime ID 
curl "https://anikato.vercel.app/api/episodes-ajax/1642"
📄 Example Response 
{
  "success": true,
  "results": "<a data-ep-id=\"12345\" data-num=\"1\" data-slug=\"ep-1\" href=\"/watch/one-piece-odmau/ep-1\" class=\"active\">...</a>..."
}

💡 This endpoint returns raw HTML from the AJAX call. Use /api/episodes/:slug for parsed episode data instead.

GET /api/stream

Streaming server info — extracts video embed URL and skip data via AJAX. Requires a linkId from the server buttons on the watch page.

Param Type Default Description
id string required Link ID from server buttons (data-link-id) 
curl "https://anikato.vercel.app/api/stream?id={linkId}"
📄 Example Response 
{
  "success": true,
  "results": {
    "linkId": "abc123",
    "url": "https://embed.s3t.stream/embed/xyz",
    "skipData": {
      "intro": { "start": 0, "end": 90 },
      "outro": { "start": 1320, "end": 1410 }
    }
  }
}

💡 The skipData object contains intro/outro timestamps for the video player to auto-skip.

GET /api/servers

Server list for an episode — returns available streaming servers with their names and types.

Param Type Default Description
ids string required Episode IDs 
curl "https://anikato.vercel.app/api/servers?ids={episodeIds}"
📄 Example Response 
{
  "success": true,
  "results": {
    "sub": [
      { "server_id": 1, "server_name": "Vidstreaming", "type": "sub" },
      { "server_id": 2, "server_name": "Gogocdn", "type": "sub" }
    ],
    "dub": [
      { "server_id": 3, "server_name": "Vidstreaming", "type": "dub" }
    ]
  }
}

GET /api/mapper-servers

Mapper API — fetches additional streaming servers from gogoanime/anivibe via the nekostream mapper service. Returns sub/dub server URLs for each provider.

Param Type Default Description
malId number required MyAnimeList ID
slug string required Anime slug
timestamp number required Current timestamp 
curl "https://anikato.vercel.app/api/mapper-servers?malId=21&slug=one-piece&timestamp=1717900000"
📄 Example Response 
{
  "success": true,
  "results": [
    {
      "provider": "gogoanime",
      "type": "sub",
      "url": "https://embtaku.pro/embed?id=...",
      "download": "https://gogodl.net/download?id=..."
    },
    {
      "provider": "gogoanime",
      "type": "dub",
      "url": "https://embtaku.pro/embed?id=...",
      "download": "https://gogodl.net/download?id=..."
    }
  ]
}

GET /api/top-ten

Top 10 anime rankings for day, week, and month.

curl "https://anikato.vercel.app/api/top-ten"
📄 Example Response 
{
  "success": true,
  "results": {
    "today": [
      { "slug": "one-piece-odmau", "rank": 1, "name": "One Piece", "poster": "...", "sub": 1165, "dub": 1133, "type": "" },
      { "slug": "that-time-i-got-reincarnated-as-a-slime-season-4-0u851", "rank": 2, "name": "That Time I Got Reincarnated as a Slime Season 4", "sub": 9, "dub": 7 },
      { "slug": "wistoria-wand-and-sword-season-2-dua04", "rank": 3, "name": "Wistoria: Wand and Sword Season 2", "sub": 9, "dub": 7 }
    ],
    "week": [
      { "slug": "one-piece-odmau", "rank": 1, "name": "One Piece", "sub": 1165, "dub": 1133 },
      { "slug": "re-zero-starting-life-in-another-world-season-4-4hk9h", "rank": 2, "name": "Re:ZERO Season 4", "sub": 9, "dub": 9 },
      { "slug": "that-time-i-got-reincarnated-as-a-slime-season-4-0u851", "rank": 3, "name": "Tensei Slime Season 4", "sub": 9, "dub": 7 }
    ],
    "month": [
      { "slug": "one-piece-odmau", "rank": 1, "name": "One Piece", "sub": 1165, "dub": 1133 },
      { "slug": "that-time-i-got-reincarnated-as-a-slime-season-4-0u851", "rank": 2, "name": "Tensei Slime Season 4", "sub": 9, "dub": 7 },
      { "slug": "wistoria-wand-and-sword-season-2-dua04", "rank": 3, "name": "Wistoria Season 2", "sub": 9, "dub": 7 }
    ]
  }
}

GET /api/spotlight

Spotlight carousel data — featured anime with posters, descriptions, and ratings.

curl "https://anikato.vercel.app/api/spotlight"
📄 Example Response 
{
  "success": true,
  "results": [
    {
      "slug": "one-piece-odmau",
      "poster": "https://image.tmdb.org/t/p/original/a6ptrTUH1c5OdWanjyYtAkOuYD0.jpg",
      "title": "One Piece",
      "japaneseTitle": "One Piece",
      "description": "",
      "rating": "PG-13",
      "quality": "HD",
      "sub": 0,
      "dub": 0,
      "date": "Oct 20, 1999 to ?"
    },
    {
      "slug": "that-time-i-got-reincarnated-as-a-slime-season-4-0u851",
      "poster": "https://cdn.anipixcdn.co/background/14c2f4ab3ad95f50_1778862809.jpg",
      "title": "That Time I Got Reincarnated as a Slime Season 4",
      "japaneseTitle": "Tensei shitara Slime Datta Ken 4th Season",
      "rating": "PG-13",
      "quality": "HD"
    }
  ]
}

GET /api/trending

Trending anime — recently updated episodes with sub/dub counts.

curl "https://anikato.vercel.app/api/trending"
📄 Example Response 
{
  "success": true,
  "results": [
    {
      "slug": "one-piece-odmau/ep-1165",
      "poster": "https://cdn.anipixcdn.co/thumbnail/f899139df5e1059396431415e770c6dd.jpg",
      "title": "One Piece",
      "japaneseTitle": "One Piece",
      "sub": 1165,
      "dub": 1133,
      "total": 0,
      "type": "TV"
    },
    {
      "slug": "wistoria-wand-and-sword-season-2-dua04/ep-9",
      "poster": "https://cdn.anipixcdn.co/thumbnail/4739d8dbd05dddb73604f6240b83ea68.jpg",
      "title": "Wistoria: Wand and Sword Season 2",
      "sub": 9,
      "dub": 7,
      "total": 12,
      "type": "TV"
    }
  ]
}

GET /api/random

Random anime — follows redirect to a random anime page and returns full info.

curl "https://anikato.vercel.app/api/random"
📄 Example Response 
{
  "success": true,
  "results": {
    "slug": "https://anikototv.to/random",
    "animeId": 998,
    "title": "Saint Young Men (Movie)",
    "japaneseTitle": "Saint Oniisan (Movie)",
    "poster": "https://cdn.anipixcdn.co/thumbnail/6081594975a764c8e3a691fa2b3a321d.jpg",
    "type": "Movie",
    "synopsis": "What if Jesus and Buddha were living on Earth in modern times?",
    "rating": "7.86   7.86 /10",
    "genres": ["Comedy", "Slice of Life", "Seinen"],
    "url": "https://anikototv.to/random"
  }
}

GET /api/most-popular

Most popular anime with pagination — sorted by view count.

Param Type Default Description
page number 1 Page number 
curl "https://anikato.vercel.app/api/most-popular?page=1"
📄 Example Response 
{
  "success": true,
  "results": {
    "totalPages": 293,
    "data": [
      {
        "slug": "solo-leveling-season-2-arise-from-the-shadow-3eukp/ep-1",
        "animeId": "7457",
        "poster": "https://cdn.anipixcdn.co/thumbnail/4b5ed938de41e4ff532c02c27dfd143a.jpg",
        "title": "Solo Leveling Season 2: Arise from the Shadow",
        "sub": 13, "dub": 13, "total": 13,
        "type": "TV", "rating": "8.87"
      },
      {
        "slug": "one-piece-odmau/ep-1",
        "animeId": "1642",
        "title": "One Piece",
        "sub": 1165, "dub": 1133,
        "type": "TV", "rating": "8.73"
      },
      {
        "slug": "dandadan-lzcmw/ep-1",
        "animeId": "4",
        "title": "Dandadan",
        "sub": 12, "dub": 12,
        "type": "TV", "rating": "8.75"
      }
    ]
  }
}

GET /api/new-release

Newly released anime with pagination.

Param Type Default Description
page number 1 Page number 
curl "https://anikato.vercel.app/api/new-release?page=1"
📄 Example Response 
{
  "success": true,
  "results": {
    "totalPages": 50,
    "data": [
      {
        "slug": "given-movie-2024-xt2kv/ep-1",
        "animeId": "7386",
        "poster": "https://cdn.anipixcdn.co/thumbnail/b4067f8aa165e643477e6c2eaf8e978c.jpg",
        "title": "Given Movie (2024)",
        "japaneseTitle": "Given Movie (2024)",
        "sub": 1, "dub": 1, "total": 1,
        "type": "Movie", "rating": "8"
      },
      {
        "slug": "jujutsu-kaisen-hidden-inventory-premature-death-wjoxj/ep-1",
        "animeId": "8584",
        "title": "Jujutsu Kaisen: Hidden Inventory/Premature Death",
        "sub": 1, "dub": 1, "total": 1,
        "type": "Movie", "rating": "8.1"
      }
    ]
  }
}

GET /api/trending-sidebar

Sidebar data — trending (day/week/month) + latest episodes for widget display.

curl "https://anikato.vercel.app/api/trending-sidebar"
📄 Example Response 
{
  "success": true,
  "results": {
    "day": [
      { "slug": "one-piece-odmau", "rank": 1, "name": "One Piece", "sub": 1165, "dub": 1133 },
      { "slug": "that-time-i-got-reincarnated-as-a-slime-season-4-0u851", "rank": 2, "name": "Tensei Slime S4", "sub": 9, "dub": 7 }
    ],
    "week": [...],
    "month": [...],
    "latestEpisodes": [
      {
        "slug": "one-piece-odmau/ep-1165",
        "title": "One Piece",
        "sub": 1165, "dub": 1133,
        "type": "TV"
      }
    ]
  }
}

GET /api/newly-added

Recently added anime with pagination.

Param Type Default Description
page number 1 Page number 
curl "https://anikato.vercel.app/api/newly-added?page=1"
📄 Example Response 
{
  "success": true,
  "results": {
    "totalPages": 150,
    "data": [
      {
        "slug": "one-piece-odmau/ep-1",
        "animeId": "1642",
        "poster": "https://cdn.anipixcdn.co/thumbnail/f899139df5e1059396431415e770c6dd.jpg",
        "title": "One Piece",
        "sub": 1165, "dub": 1133, "total": 0,
        "type": "TV", "rating": "8.73"
      },
      {
        "slug": "wistoria-wand-and-sword-season-2-dua04/ep-1",
        "animeId": "8737",
        "title": "Wistoria: Wand and Sword Season 2",
        "sub": 9, "dub": 7, "total": 12,
        "type": "TV", "rating": "8.12"
      }
    ]
  }
}

GET /api/schedule

Anime schedule for a specific date. Returns an array of anime airing on that date with episode info, or an empty array if no schedule data is available.

Param Type Default Description
date string required Date in YYYY-MM-DD format 
curl "https://anikato.vercel.app/api/schedule?date=2026-06-08"
📄 Example Response 
{
  "success": true,
  "results": [
    {
      "slug": "anime-slug-xyz/ep-1",
      "title": "Anime Title",
      "episode": "Ep 1",
      "japaneseTitle": "Japanese Title",
      "type": "TV",
      "subs": 1,
      "dubs": 0
    }
  ]
}

💡 If no anime are scheduled for the given date, the response will be {"success": true, "results": []}.

GET /api/filter

Advanced filtering with multiple criteria. Requires keyword parameter (use empty string for unfiltered).

Param Type Default Description
keyword string "" Search keyword (required by site)
genre string — Comma-separated genre slugs
type string — Comma-separated types
status string — Comma-separated statuses
language string — sub, dub
rating string — g, pg, pg-13, r, r+, rx
sort string — latest-updated, score, name-az, etc.
season string — spring, summer, fall, winter
year number — e.g. 2026
page number 1 Page number

Available Genres: action, adventure, cars, comedy, dementia, demons, drama, ecchi, fantasy, game, harem, historical, horror, isekai, josei, kids, magic, mahou-shoujo, martial-arts, mecha, military, music, mystery, parody, police, psychological, romance, samurai, school, sci-fi, seinen, shoujo, shoujo-ai, shounen, shounen-ai, slice-of-life, space, sports, super-power, supernatural, thriller, unknown, vampire

Available Types: movie, music, ona, ova, special, tv

Available Statuses: currently-airing, finished-airing, not-yet-aired

Available Sorts: default, latest-updated, latest-added, score, name-az, release-date, most-viewed, number_of_episodes

curl "https://anikato.vercel.app/api/filter?genre=action&type=tv&page=1"
📄 Example Response 
{
  "success": true,
  "results": {
    "totalPages": 89,
    "data": [
      {
        "slug": "one-piece-odmau/ep-1",
        "animeId": "1642",
        "poster": "https://cdn.anipixcdn.co/thumbnail/f899139df5e1059396431415e770c6dd.jpg",
        "title": "One Piece",
        "sub": 1165, "dub": 1133, "total": 0,
        "type": "TV", "rating": "8.73"
      }
    ]
  }
}

GET /api/genre/:name

Browse anime by genre.

Param Type Default Description
name string required Genre slug (e.g. action, comedy)
page number 1 Page number 
curl "https://anikato.vercel.app/api/genre/action?page=1"
📄 Example Response 
{
  "success": true,
  "results": {
    "totalPages": 89,
    "data": [
      {
        "slug": "one-piece-odmau/ep-1",
        "animeId": "1642",
        "poster": "https://cdn.anipixcdn.co/thumbnail/f899139df5e1059396431415e770c6dd.jpg",
        "title": "One Piece",
        "sub": 1165, "dub": 1133, "total": 0,
        "type": "TV", "rating": "8.73"
      },
      {
        "slug": "solo-leveling-season-2-arise-from-the-shadow-3eukp/ep-1",
        "animeId": "7457",
        "title": "Solo Leveling Season 2: Arise from the Shadow",
        "sub": 13, "dub": 13, "total": 13,
        "type": "TV", "rating": "8.87"
      }
    ]
  }
}

GET /api/type/:name

Browse anime by type.

Param Type Default Description
name string required Type slug (tv, movie, ova, ona, special)
page number 1 Page number 
curl "https://anikato.vercel.app/api/type/movie?page=1"
📄 Example Response 
{
  "success": true,
  "results": {
    "totalPages": 44,
    "data": [
      {
        "slug": "given-movie-2024-xt2kv/ep-1",
        "animeId": "7386",
        "poster": "https://cdn.anipixcdn.co/thumbnail/b4067f8aa165e643477e6c2eaf8e978c.jpg",
        "title": "Given Movie (2024)",
        "japaneseTitle": "Given Movie (2024)",
        "sub": 1, "dub": 1, "total": 1,
        "type": "Movie", "rating": "8"
      },
      {
        "slug": "jujutsu-kaisen-hidden-inventory-premature-death-wjoxj/ep-1",
        "animeId": "8584",
        "title": "Jujutsu Kaisen: Hidden Inventory/Premature Death",
        "sub": 1, "dub": 1, "total": 1,
        "type": "Movie", "rating": "8.1"
      }
    ]
  }
}

GET /api/status/:name

Browse anime by airing status.

Param Type Default Description
name string required Status slug
page number 1 Page number 
curl "https://anikato.vercel.app/api/status/currently-airing?page=1"
📄 Example Response 
{
  "success": true,
  "results": {
    "totalPages": 15,
    "data": [
      {
        "slug": "one-piece-odmau/ep-1",
        "animeId": "1642",
        "poster": "https://cdn.anipixcdn.co/thumbnail/f899139df5e1059396431415e770c6dd.jpg",
        "title": "One Piece",
        "sub": 1165, "dub": 1133, "total": 0,
        "type": "TV", "rating": "8.73"
      },
      {
        "slug": "daemons-of-the-shadow-realm-hxj32/ep-1",
        "animeId": "8712",
        "title": "Daemons of the Shadow Realm",
        "sub": 10, "dub": 8, "total": 24,
        "type": "TV", "rating": "9.58"
      }
    ]
  }
}

GET /api/az-list/:letter

Browse anime alphabetically.

Param Type Default Description
letter string required Letter (a-z, 0-9, other, all)
page number 1 Page number 
curl "https://anikato.vercel.app/api/az-list/a?page=1"
📄 Example Response 
{
  "success": true,
  "results": {
    "totalPages": 19,
    "letter": "a",
    "data": [
      {
        "slug": "a-silent-voice-fghla/ep-1",
        "poster": "https://cdn.anipixcdn.co/thumbnail/6512bd43d9caa6e02c990b0a82652dca.jpg",
        "title": "A Silent Voice",
        "japaneseTitle": "Koe no Katachi",
        "sub": 1, "dub": 1, "total": 0,
        "type": "Movie", "rating": ""
      },
      {
        "slug": "attack-on-titan-bgaoa/ep-1",
        "title": "Attack on Titan",
        "japaneseTitle": "Shingeki no Kyojin",
        "sub": 25, "dub": 25, "total": 25,
        "type": "TV", "rating": "8.52"
      }
    ]
  }
}

GET /api/suggestions

Search suggestions for autocomplete (returns max 10 results).

Param Type Default Description
keyword string required Search query 
curl "https://anikato.vercel.app/api/suggestions?keyword=naruto"
📄 Example Response 
{
  "success": true,
  "results": [
    {
      "slug": "naruto-shippuden-c8gov/ep-1",
      "poster": "https://cdn.anipixcdn.co/thumbnail/82cec96096d4281b7c95cd7e74623496.jpg",
      "title": "Naruto: Shippuden",
      "japaneseTitle": "Naruto: Shippuuden",
      "type": "TV",
      "sub": 500,
      "dub": 500
    },
    {
      "slug": "the-last-naruto-the-movie-whib1/ep-1",
      "title": "The Last: Naruto the Movie",
      "type": "Movie",
      "sub": 1,
      "dub": 1
    }
  ]
}

📋 API Response Schema

Success Response

{
  "success": true,
  "results": { ... }
}

Error Response

{
  "success": false,
  "message": "Error description"
}

Anime Item Object

Field Type Description Example
slug string URL-safe identifier "one-piece-odmau"
animeId number/string Internal ID 1642
poster string Thumbnail URL "https://cdn.anipixcdn.co/..."
title string English title "One Piece"
japaneseTitle string Japanese title "One Piece"
sub number Subbed episodes count 1165
dub number Dubbed episodes count 1133
total number Total episodes 0
type string Anime type "TV"
rating string MAL rating "8.73"

Spotlight Object

Field Type Description Example
slug string URL-safe identifier "one-piece-odmau"
poster string Background image URL "https://..."
title string English title "One Piece"
japaneseTitle string Japanese title "One Piece"
description string Synopsis "Gol D. Roger..."
rating string Content rating "PG-13"
quality string Video quality "HD"
sub number Sub count 0
dub number Dub count 0
date string Air date range "Oct 20, 1999 to ?"

Ranking Object

Field Type Description Example
slug string URL-safe identifier "one-piece-odmau"
rank number Position (1-10) 1
name string Anime title "One Piece"
poster string Thumbnail URL "https://..."
sub number Sub count 1165
dub number Dub count 1133
type string Anime type "TV"

🌐 Deployment

▲ Vercel (Recommended)

Deploy with Vercel

  1. Click the button above (or import manually on vercel.com)
  2. Vercel auto-detects the project — no config needed
  3. Your API is live! 🎉
# Or use Vercel CLI
npx vercel --prod

🖥️ Standalone Server

# Clone and install
git clone https://github.com/Shineii86/AniKatoAPI.git
cd AniKatoAPI && npm install

# Start production server
npm start
# → http://localhost:4444

🐳 Docker

FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --production
COPY . .
EXPOSE 4444
CMD ["node", "server.js"]

📜 Available Scripts

Command Description Details
npm run dev 🔥 Start development server Runs on localhost:4444
npm start 🚀 Start production server node server.js
npm test 🧪 Run tests Placeholder

⚡ Performance

Metric Value
⚡ Cached response ~200ms
🔄 Fresh fetch ~1-3s
💾 Cache TTL 5 minutes
⏱️ Timeout per request 15 seconds
🎬 Total anime indexed 10,000+
📦 Total codebase ~80KB

Optimization Features

  • 💾 In-memory cache — Map-based with TTL expiration
  • ⚡ Cheerio parsing — Fast HTML DOM traversal
  • 🔧 Custom headers — Mimics browser requests
  • 🎯 Selective scraping — Only extracts needed data
  • 📁 Minimal deps — Only 6 production dependencies
  • 🔄 Graceful fallback — Empty arrays on error, never crashes

📝 Changelog Highlights

Version Date Key Changes
1.5.0 2026-06-08 Complete documentation rewrite — 50+ files with AlisaReactionBot style
1.4.0 2026-06-08 Fixed ALL CSS selectors to match actual anikototv.to HTML structure
1.3.0 2026-06-08 Added streaming, mapper API, seasons, watch order, episode AJAX
1.2.0 2026-06-08 Added watch page, AZ list, new release, newly added, trending sidebar
1.1.0 2026-06-08 Corrected HTML selectors based on actual website analysis
1.0.0 2026-06-08 Initial release — 20+ endpoints, Vercel deployment

📝 See CHANGELOG.md for the full version history.

🔧 Troubleshooting

Problem Cause Solution
❌ npm install fails Node.js version too old Upgrade to Node.js 20+ (node -v)
❌ 500 error on filter Missing keyword param Add ?keyword= (even empty) to filter requests
❌ Empty episodes array AJAX not loaded Use /api/episodes/:slug which fetches via AJAX
❌ CORS errors Frontend domain blocked CORS is * — check browser extension
❌ 404 on API routes Wrong URL format Use /api/ prefix, not just /
❌ Deploy fails on Vercel Build error Check node server.js locally first
❌ Slow first request Serverless cold start Normal — first request after idle takes ~3s
❌ Rate limited Too many requests Cache reduces this — wait 5 min for TTL expiry

🐛 Debug Mode

# Run with verbose logging
NODE_ENV=development npm run dev

# Test specific endpoint
curl http://localhost:4444/api/
curl http://localhost:4444/api/search?keyword=naruto
curl http://localhost:4444/api/top-ten

❓ FAQ

📰 How do I search for anime?
Use /api/search?keyword=your+search. Results include title, poster, episodes, rating, and genres. For autocomplete suggestions, use /api/search/suggest?keyword=your+search which returns max 10 results.
📺 How do I get episode lists?
Use /api/episodes/:slug where :slug is the anime URL slug (e.g., one-piece-odmau). This fetches episode data via AJAX for accuracy. The response includes animeId, totalEpisodes, and episodes array.
🎯 How does filtering work?
Use /api/filter with query params. The keyword param is required by the source site (use empty string if not searching). Combine genre, type, status, sort, season, and year for advanced filtering.
📡 Can I use this in my frontend app?
Yes! CORS is enabled for all origins (*). Just make fetch requests to the API endpoints. No API key needed. Example: fetch('https://anikato.vercel.app/api/search?keyword=naruto')
🔄 How often does the data refresh?
The cache TTL is 5 minutes. After that, the next request triggers a fresh scrape from anikototv.to. This keeps data relatively fresh while reducing load on the source site.
🎲 What does the random endpoint do?
/api/random follows a redirect on the source site to a random anime page, then returns the full anime info including title, synopsis, rating, genres, and poster.
🌐 Can I self-host this?
Yes! Use npm start to run the Express server on any VPS, Docker container, or PaaS. The Vercel serverless functions are optional — server.js handles everything.
📊 How many anime are indexed?
The API can access 10,000+ anime titles from anikototv.to. The most-popular endpoint alone has 293 pages of results with 30 items per page.

🗺️ Roadmap

🎯 Planned Features

  • 🔐 API key authentication — Per-user rate limits
  • 📊 Analytics endpoint — Usage statistics
  • 🌙 Dark/light mode — Theme toggle for landing page
  • 📱 PWA support — Install as app on mobile
  • 🔔 Webhook notifications — Push new episodes to Discord
  • 📈 Rate limiting — Per-IP request throttling
  • 🗄️ Redis cache — Persistent caching for serverless
  • 🌐 Multi-language — Sub/dub language metadata
  • 🤖 AI summaries — Auto-generated anime descriptions
  • 📦 NPM package — Client SDK for easy integration

✅ Completed

  • 🎬 24 API endpoints covering all data
  • 🔍 Full-text search with pagination
  • 📺 Episode lists via AJAX loading
  • 🎯 Advanced filtering (genre, type, status, rating, sort)
  • 🏆 Top 10 rankings (day/week/month)
  • 🎲 Random anime discovery
  • 📡 Streaming server info + mapper API
  • 📋 AZ List alphabetical browsing
  • 🔄 Smart caching with 5-min TTL
  • 🚀 One-click Vercel deployment
  • 📖 Comprehensive documentation
  • 🏗️ AlisaReactionBot-style code comments

🤝 Contributing

Contributions are welcome and appreciated! Here's how you can help:

🐛 Report Bugs

Found something broken?

Open an Issue

💡 Suggest Features

Have an idea?

Start a Discussion

🔀 Submit PRs

Ready to contribute code?

Fork & Submit

🔄 How to Contribute

# 1️⃣ Fork the repository
# Click the "Fork" button on GitHub

# 2️⃣ Clone your fork
git clone https://github.com/YOUR_USERNAME/AniKatoAPI.git
cd AniKatoAPI

# 3️⃣ Create a feature branch
git checkout -b feature/amazing-feature

# 4️⃣ Make your changes
# Edit files, add features, fix bugs...

# 5️⃣ Commit your changes
git commit -m 'feat: add amazing feature'

# 6️⃣ Push to your fork
git push origin feature/amazing-feature

# 7️⃣ Open a Pull Request
# Go to GitHub and create a PR

📋 Guidelines

  • ✅ Follow the existing code style and documentation conventions
  • ✅ Write meaningful commit messages (use conventional commits)
  • ✅ Update CHANGELOG.md with your changes
  • ✅ Keep PRs focused — one feature or fix per PR
  • ✅ Add JSDoc comments for new functions
  • ❌ Don't commit node_modules or cache files
  • ❌ Don't add unrelated changes to a single PR

🙏 Acknowledgements

🎬 Data Source

Source About
AniKato Anime streaming site — primary data source
AniKato CZ Mirror domain
AniKato ME Mirror domain
AniKato NET Mirror domain
AniKato SE Mirror domain

🛠️ Technologies

  • Express — Fast, unopinionated web framework
  • Cheerio — Fast, flexible HTML parsing
  • Axios — Promise-based HTTP client
  • Vercel — Serverless deployment platform

📝 Resources

📄 License

License: MIT

This project is licensed under the MIT License.

Free to use, modify, and distribute — see the LICENSE file for details.

👤 Author

Shinei Nouzen
Full-Stack Developer & Anime Enthusiast

GitHub Telegram Instagram Email

⭐ Star History

Star History Chart

⭐ If you found this project useful, please consider giving it a star!

Made With ❤️ For The Anime Community

© 2026 Shineii86. All Rights Reserved.

Reference in New Issue View Git Blame Copy Permalink
S
Description
No description provided
anikotoanime-apianime-dataanime-streamingcheerioexpressfree-apihlsm3u8nodejsopen-sourcerest-apiserverlessvercelweb-scraping
Readme MIT
2.6 MiB
Languages
JavaScript 84.1%
HTML 15.9%