📺 hianime-API

hianime-API is an unofficial REST API that scrapes anime data from hianimez.to.
It provides endpoints for anime discovery, details, episodes, servers, and streaming links.

⚠️ Important

• This API is unofficial and not affiliated with hianimez.to
• No hosted instance exists — deploy your own
• All content belongs to its original owners
• This project is for educational and personal use only

---

✨ Features

• Anime home page data (trending, spotlight, top airing, etc.)
• Anime listings with filters (genre, A–Z, categories)
• Detailed anime information
• Episode lists
• Streaming servers & HLS links
• Search & search suggestions

---

💻 Installation

Prerequisites

• Bun (required)

Install Bun → https://bun.sh/docs/installation

---

Local Setup

git clone https://github.com/yahyaMomin/hianime-API.git
cd hianime-API
bun install
bun run dev

Server runs at:

http://localhost:3030

now vist /doc for intrective docs

http://localhost:3030/doc

⚠️ Important

• You Cannot Run this Projct Directly Using Nodemon or node
• You Need to Build Project using tsup in ESM module To Run Using Node

---

---

Deploy on Render

---

📚 API Documentation

Base URL:

/api/v1

All responses follow:

{
  "success": true,
  "data": {}
}

---

🏠 Home Page

GET /home

Returns spotlight, trending, top airing, latest episodes, genres, and more.

---

🏠 spotlight Page

GET /spotlight

Returns spotlight.

---

🏠 topten Page

GET /topten

Returns topTen.

---

📃 Anime List

GET /{query}?page={page}

Supports:

• top-airing
• most-popular
• most-favorite
• completed
• recently-added
• recently-updated
• top-upcoming
• subbed-anime
• dubbed-anime
• movie
• tv
• ova
• ona
• special

---

📃 AZ List

GET /az-list/{letter}?page={page}

Supports:

• A to Z
• 0 to 9
• All

---

📃 Genre Anime List

GET /genre/{genre}?page={page}

Supports:

• action
• adventure
• cars
• comedy
• dementia
• demons
• drama
• ecchi
• fantasy
• game
• harem
• historical
• horror
• isekai
• josei
• kids
• magic
• 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
• vampire

---

🎬 Anime Details

GET /anime/{animeId}

Returns full anime metadata, episodes info, related & recommended anime.

---

🔍 Search

GET /search?keyword={query}&page={page}

Suggestions

GET /search/suggestion?keyword={query}

---

📺 Episodes

GET /episodes/{animeId}

Servers

GET /servers?id={episodeId}

Streaming

GET /stream?id={episodeId}&server={server}&type={sub|dub}

Returns HLS links, subtitles, intro/outro timestamps.

---

👨‍💻 Development & Contribution

• Pull requests welcome
• Open issues for bugs or features

Issues → https://github.com/yahyamomin/hianime-API/issues

---

🎨 Frontend Example

Reference frontend:

https://github.com/yahyamomin/watanuki

---

✨ Contributors

---

🤝 Credits

• consumet.ts
• api.consumet.org

---

🌟 Support

Star the repo if it helped you.

---

📈 Star History