hianime-api

A RESTful API that utilizes web scraping to fetch anime content from hianime.to

Documentation • Installation • API Endpoints • Development

Overview

hianime-api is a comprehensive RESTful API that provides endpoints to retrieve anime details, episodes, and streaming links by scraping content from hianime.to. Built with modern web technologies, it offers a robust solution for anime content aggregation.

Important Notice

This API is recommended for personal use only. Deploy your own instance and customize it as needed.
This API is just an unofficial API for hianime.to and is in no other way officially related to the same.
The content that this API provides is not mine, nor is it hosted by me. These belong to their respective owners. This API just demonstrates how to build an API that scrapes websites and uses their content.

Used By

This API is used by the following projects:

Animo: A comprehensive anime streaming platform that leverages this API for real-time anime data, schedules, and streaming links. Check it out to see the API in action!

Installation

Prerequisites

Make sure you have Bun.js installed on your system.

Install Bun.js:

https://bun.sh/docs/installation

NPM Usage

Run via CLI (npx):

npx @ryanwtf88/hianime-api

Install as Library:

npm install @ryanwtf88/hianime-api

Usage as Library:

import app from '@ryanwtf88/hianime-api';
// Mount app or use fetch handler

Local Setup

Step 1: Clone the repository

git clone https://github.com/ryanwtf88/hianime-api.git

Step 2: Navigate to the project directory

cd hianime-api

Step 3: Install dependencies

bun install

Step 4: Start the development server

bun run dev

The server will be running at http://localhost:3030

Deployment

Docker Deployment

Prerequisites:

Docker installed (Install Docker)

Build the Docker image:

docker build -t hianime-api .

Run the container:

docker run -p 3030:3030 hianime-api

With environment variables:

docker run -p 3030:3030 \
  -e NODE_ENV=production \
  -e PORT=3030 \
  hianime-api

Using Docker Compose:

Create a docker-compose.yml file:

version: '3.8'

services:
  hianime-api:
    build: .
    ports:
      - "3030:3030"
    environment:
      - NODE_ENV=production
      - PORT=3030
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3030/"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

Then run:

docker-compose up -d

Cloudflare Workers Deployment

One-Click Deploy:

Manual Deployment:

Fork or clone the repository to your GitHub account
Sign up at Cloudflare
Install Wrangler CLI: npm install -g wrangler
Login to Cloudflare: wrangler login
Deploy: wrangler deploy
Configure environment variables in Cloudflare Dashboard:
- UPSTASH_REDIS_REST_URL (Required - Get from Upstash)
- UPSTASH_REDIS_REST_TOKEN (Required)
- ORIGIN=* (or your frontend domain)
- RATE_LIMIT_ENABLED=true
- RATE_LIMIT_WINDOW_MS=60000
- RATE_LIMIT_LIMIT=100

Why Cloudflare Workers?

Edge computing with ultra-low latency
Global network across 300+ cities
Free tier with 100,000 requests/day
Automatic HTTPS and DDoS protection
Git-based deployments
Built-in Redis support via Upstash

Environment Variables:

Key	Value	Required
`UPSTASH_REDIS_REST_URL`	Your Upstash Redis URL	Yes
`UPSTASH_REDIS_REST_TOKEN`	Your Upstash Redis Token	Yes
`ORIGIN`	`*` or your domain	No
`RATE_LIMIT_ENABLED`	`true`	No
`RATE_LIMIT_WINDOW_MS`	`60000`	No
`RATE_LIMIT_LIMIT`	`100`	No

For detailed instructions, see CLOUDFLARE.md

Vercel Proxy (Separate Deployment)

For HLS streaming with CORS support, deploy our separate proxy:

Repository: vercel-proxy

This standalone proxy is deployed on Vercel to handle CDN requests that may be blocked by Cloudflare Workers. It adds CORS headers and rewrites M3U8 playlists.

Quick Deploy:

Visit the vercel-proxy repository
Click "Deploy to Vercel" or fork and deploy manually
Use the proxy endpoint in your streaming requests

For more details, see the vercel-proxy README

Replit Deployment

Import this repository into Replit
Click the Run button
Your API will be available at your Replit URL

For detailed deployment instructions, troubleshooting, and best practices, see the DEPLOYMENT.md guide.

Documentation

All endpoints return JSON responses. Base URL: /api/v1

1. GET Anime Home Page

Retrieve the home page data including spotlight anime, trending shows, top airing, and more.

Endpoint:

GET /api/v1/home

Request Example:

const resp = await fetch('/api/v1/home');
const data = await resp.json();
console.log(data);

Response Schema:

{
  "success": true,
  "data": {
    "spotlight": [...],
    "trending": [...],
    "topAiring": [...],
    "mostPopular": [...],
    "mostFavorite": [...],
    "latestCompleted": [...],
    "latestEpisode": [...],
    "newAdded": [...],
    "topUpcoming": [...],
    "top10": {
      "today": [...],
      "week": [...],
      "month": [...]
    },
    "genres": [...]
  }
}

2. GET Next Episode Schedule

Get the next episode schedule for a specific anime.

Endpoint:

GET /api/v1/schedule/next/:id

Request Example:

const resp = await fetch('/api/v1/schedule/next/one-piece-100');
const data = await resp.json();
console.log(data);

Response Schema:

{
  "success": true,
  "data": {
    "nextEpisode": {
      "episodeNumber": 1120,
      "releaseDate": "2024-12-15"
    }
  }
}

4. GET Anime List Page

Retrieve anime lists based on various categories and filters.

Endpoint:

GET /api/v1/animes/:query/:category?page=:page

Valid Queries:

Query	Has Category	Category Options
`top-airing`	No	-
`most-popular`	No	-
`most-favorite`	No	-
`completed`	No	-
`recently-added`	No	-
`recently-updated`	No	-
`top-upcoming`	No	-
`genre`	Yes	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
`producer`	Yes	Any producer slug (e.g., bones, toei-animation, mappa)
`az-list`	Yes	0-9, all, a-z
`subbed-anime`	No	-
`dubbed-anime`	No	-
`movie`	No	-
`tv`	No	-
`ova`	No	-
`ona`	No	-
`special`	No	-
`events`	No	-

Request Example:

const resp = await fetch('/api/v1/animes/az-list/a?page=1');
const data = await resp.json();
console.log(data);

Response Schema:

{
  "success": true,
  "data": {
    "pageInfo": {
      "totalPages": 10,
      "currentPage": 1,
      "hasNextPage": true
    },
    "animes": [
      {
        "title": "Attack on Titan",
        "alternativeTitle": "Shingeki no Kyojin",
        "id": "attack-on-titan-112",
        "poster": "https://cdn.noitatnemucod.net/thumbnail/300x400/100/...",
        "episodes": {
          "sub": 25,
          "dub": 25,
          "eps": 25
        },
        "type": "TV",
        "duration": "24m"
      }
    ]
  }
}

5. GET Anime Detailed Info

Retrieve comprehensive information about a specific anime.

Endpoint:

GET /api/v1/anime/:id

Request Example:

const resp = await fetch('/api/v1/anime/attack-on-titan-112');
const data = await resp.json();
console.log(data);

Response Schema:

{
  "success": true,
  "data": {
    "title": "Attack on Titan",
    "alternativeTitle": "Shingeki no Kyojin",
    "japanese": "進撃の巨人",
    "id": "attack-on-titan-112",
    "poster": "https://cdn.noitatnemucod.net/thumbnail/300x400/100/...",
    "rating": "R",
    "type": "TV",
    "episodes": {
      "sub": 25,
      "dub": 25,
      "eps": 25
    },
    "synopsis": "...",
    "synonyms": "AoT",
    "aired": {
      "from": "Apr 7, 2013",
      "to": "Sep 29, 2013"
    },
    "premiered": "Spring 2013",
    "duration": "24m",
    "status": "Finished Airing",
    "MAL_score": "8.52",
    "genres": [...],
    "studios": ["wit-studio"],
    "producers": [...],
    "moreSeasons": [...],
    "related": [...],
    "mostPopular": [...],
    "recommended": [...]
  }
}

6. GET Search Results

Search for anime by keyword with pagination support.

Endpoint:

GET /api/v1/search?keyword=:query&page=:page

Request Example:

const resp = await fetch('/api/v1/search?keyword=one+piece&page=1');
const data = await resp.json();
console.log(data);

Response Schema:

{
  "success": true,
  "data": {
    "pageInfo": {
      "totalPages": 5,
      "currentPage": 1,
      "hasNextPage": true
    },
    "animes": [
      {
        "title": "One Piece",
        "alternativeTitle": "One Piece",
        "id": "one-piece-100",
        "poster": "https://cdn.noitatnemucod.net/thumbnail/300x400/100/...",
        "episodes": {
          "sub": 1100,
          "dub": 1050,
          "eps": 1100
        },
        "type": "TV",
        "duration": "24m"
      }
    ]
  }
}

7. GET Search Suggestions

Get autocomplete suggestions while searching for anime.

Endpoint:

GET /api/v1/suggestion?keyword=:query

Request Example:

const resp = await fetch('/api/v1/suggestion?keyword=naruto');
const data = await resp.json();
console.log(data);

Response Schema:

{
  "success": true,
  "data": [
    {
      "title": "Naruto",
      "alternativeTitle": "Naruto",
      "poster": "https://cdn.noitatnemucod.net/thumbnail/300x400/100/...",
      "id": "naruto-677",
      "aired": "Oct 3, 2002",
      "type": "TV",
      "duration": "23m"
    }
  ]
}

8. Filter Anime

Filter anime based on multiple criteria.

Endpoint:

GET /api/v1/filter?type=:type&status=:status&rated=:rated&score=:score&season=:season&language=:language&start_date=:start_date&end_date=:end_date&sort=:sort&genres=:genres&page=:page

Query Parameters:

type - all, tv, movie, ova, ona, special, music
status - all, finished_airing, currently_airing, not_yet_aired
rated - all, g, pg, pg-13, r, r+, rx
score - all, appalling, horrible, very_bad, bad, average, fine, good, very_good, great, masterpiece
season - all, spring, summer, fall, winter
language - all, sub, dub, sub_dub
start_date - YYYY-MM-DD format
end_date - YYYY-MM-DD format
sort - default, recently-added, recently-updated, score, name-az, released-date, most-watched
genres - Comma-separated genre slugs (action, adventure, cars, comedy, dementia, demons, mystery, drama, ecchi, fantasy, game, historical, horror, kids, magic, martial_arts, mecha, music, parody, samurai, romance, school, sci-fi, shoujo, shoujo_ai, shounen, shounen_ai, space, sports, super_power, vampire, harem, slice_of_life, supernatural, military, police, psychological, thriller, seinen, josei, isekai)
page - Page number (default: 1)

Request Example:

const resp = await fetch('/api/v1/filter?type=tv&status=currently_airing&sort=score&genres=action,fantasy&page=1');
const data = await resp.json();
console.log(data);

Response Schema:

{
  "success": true,
  "data": {
    "pageInfo": {
      "totalPages": 20,
      "currentPage": 1,
      "hasNextPage": true
    },
    "animes": [...]
  }
}

9. GET Filter Options

Get all available filter options.

Endpoint:

GET /api/v1/filter/options

Request Example:

const resp = await fetch('/api/v1/filter/options');
const data = await resp.json();
console.log(data);

Response Schema:

{
  "success": true,
  "data": {
    "types": [...],
    "statuses": [...],
    "ratings": [...],
    "scores": [...],
    "seasons": [...],
    "languages": [...],
    "sorts": [...],
    "genres": [...]
  }
}

10. GET Anime Characters

Retrieve character list for a specific anime.

Endpoint:

GET /api/v1/characters/:id?page=:page

Request Example:

const resp = await fetch('/api/v1/characters/one-piece-100?page=1');
const data = await resp.json();
console.log(data);

Response Schema:

{
  "success": true,
  "data": {
    "pageInfo": {
      "totalPages": 5,
      "currentPage": 1,
      "hasNextPage": true
    },
    "characters": [
      {
        "name": "Monkey D. Luffy",
        "image": "https://...",
        "id": "character:monkey-d-luffy-1",
        "role": "Main",
        "voiceActors": [...]
      }
    ]
  }
}

11. GET Character Details

Get detailed information about a character or voice actor.

Endpoint:

GET /api/v1/character/:id

Request Example (Character):

const resp = await fetch('/api/v1/character/character:roronoa-zoro-7');
const data = await resp.json();
console.log(data);

Request Example (Actor):

const resp = await fetch('/api/v1/character/people:kana-hanazawa-1');
const data = await resp.json();
console.log(data);

Response Schema:

{
  "success": true,
  "data": {
    "name": "Roronoa Zoro",
    "image": "https://...",
    "role": "Main",
    "animeAppearances": [...],
    "biography": "...",
    "voiceActors": [...]
  }
}

12. GET Anime Episodes

Retrieve the episode list for a specific anime.

Endpoint:

GET /api/v1/episodes/:id

Request Example:

const resp = await fetch('/api/v1/episodes/steins-gate-3');
const data = await resp.json();
console.log(data);

Response Schema:

{
  "success": true,
  "data": {
    "totalEpisodes": 24,
    "episodes": [
      {
        "title": "Turning Point",
        "alternativeTitle": "Hajimari to Owari no Prologue",
        "episodeNumber": 1,
        "id": "steinsgate-3?ep=213",
        "isFiller": false
      }
    ]
  }
}

13. GET Anime Episode Servers

Get available streaming servers for a specific episode.

Endpoint:

GET /api/v1/servers?id=:episodeId

Request Example:

const resp = await fetch('/api/v1/servers?id=steinsgate-3?ep=213');
const data = await resp.json();
console.log(data);

Response Schema:

{
  "success": true,
  "data": {
    "episodeNumber": 1,
    "sub": [
      {
        "serverName": "HD-1",
        "serverId": 4
      },
      {
        "serverName": "HD-2",
        "serverId": 1
      }
    ],
    "dub": [
      {
        "serverName": "HD-1",
        "serverId": 4
      }
    ]
  }
}

14. GET Anime Episode Streaming Links

Retrieve streaming links and metadata for a specific episode.

Endpoint:

GET /api/v1/stream?id=:episodeId&server=:server&type=:type

Query Parameters:

id - Episode ID (required)
server - Server name (default: hd-1)
type - sub or dub (default: sub)

Request Example:

const resp = await fetch('/api/v1/stream?id=102994&server=hd-2&type=sub');
const data = await resp.json();
console.log(data);

Response Schema:

{
  "success": true,
  "data": {
    "id": "steinsgate-3::ep=136197",
    "type": "dub",
    "link": {
      "file": "https://loda-lassan/master.m3u8",
      "type": "hls"
    },
    "tracks": [
      {
        "file": "https://loda-lassan/eng-2.vtt",
        "label": "English",
        "kind": "captions",
        "default": true
      },
      {
        "file": "https://loda-lassan.vtt",
        "kind": "thumbnails"
      }
    ],
    "intro": {
      "start": 81,
      "end": 170
    },
    "outro": {
      "start": 1315,
      "end": 1404
    },
    "server": "HD-2"
  }
}

15. GET Embedded Video Player

Returns an embedded video player HTML page for the specified episode.

Endpoint (Path Parameters):

GET /api/v1/embed/:server/:id/:type

Endpoint (Query Parameters):

GET /api/v1/embed?id=:episodeId&server=:server&type=:type

Path/Query Parameters:

server - Server ID (hd-1, hd-2) (default: hd-2)
id - Episode ID (required)
type - Audio type: sub or dub (default: sub)

Request Example (Path Params):

// Direct embed URL
window.location.href = '/api/v1/embed/hd-2/102994/sub';

Request Example (Query Params):

// Embed with query parameters
window.location.href = '/api/v1/embed?id=102994&server=hd-2&type=sub';

Response:

Returns an HTML page with an embedded video player featuring:

HLS.js video playback with adaptive quality
Quality selection (Auto, 1080p, 720p, 480p, 360p)
Playback speed control (0.25x - 2x)
Subtitle support with customizable styling
Skip intro/outro buttons (10 seconds)
Fullscreen support
Picture-in-picture mode
Keyboard shortcuts
Progress bar with intro/outro highlights

Usage Example:

<!-- Embed in iframe -->
<iframe 
  src="https://your-api.com/api/v1/embed/hd-2/102994/sub"
  width="100%" 
  height="500px"
  frameborder="0"
  allowfullscreen
></iframe>

16. GET Proxy Stream/Subtitle

Proxies video streams and subtitle files with proper headers to bypass CORS restrictions.

Endpoint:

GET /api/v1/proxy?url=:url&referer=:referer

Query Parameters:

url - URL to proxy (video stream M3U8 or subtitle VTT file) (required)
referer - Referer header value (default: https://megacloud.tv)

Request Example (Video Stream):

const streamUrl = encodeURIComponent('https://example.com/video/master.m3u8');
const referer = encodeURIComponent('https://megacloud.tv');
const resp = await fetch(`/api/v1/proxy?url=${streamUrl}&referer=${referer}`);
// Returns proxied M3U8 playlist with rewritten URLs

Request Example (Subtitle):

const subtitleUrl = encodeURIComponent('https://example.com/subtitles/english.vtt');
const resp = await fetch(`/api/v1/proxy?url=${subtitleUrl}&referer=${referer}`);
// Returns proxied VTT subtitle file

Response (M3U8 Playlist):

#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=2000000,RESOLUTION=1920x1080
/api/v1/proxy?url=https%3A%2F%2Fexample.com%2F1080p.m3u8&referer=https%3A%2F%2Fmegacloud.tv
#EXT-X-STREAM-INF:BANDWIDTH=1000000,RESOLUTION=1280x720
/api/v1/proxy?url=https%3A%2F%2Fexample.com%2F720p.m3u8&referer=https%3A%2F%2Fmegacloud.tv

Response (VTT Subtitle):

WEBVTT

00:00:01.000 --> 00:00:04.000
This is a subtitle line

00:00:05.000 --> 00:00:08.000
Another subtitle line

Features:

Automatically rewrites M3U8 playlist URLs to proxy through the API
Streams video segments directly without buffering
Adds proper CORS headers
Maintains original referer for source validation
Supports both video streams and subtitle files

17. GET Anime Schedules (7 Days)

Retrieve anime schedules for 7 days starting from the given date (or today).

Endpoint:

GET /api/v1/schedules

Query Parameters:

date - Start date in YYYY-MM-DD format (optional, defaults to today)

Request Example:

const resp = await fetch('/api/v1/schedules?date=2024-01-01');
const data = await resp.json();
console.log(data);

Response Schema:

{
  "success": true,
  "data": {
    "2024-01-01": [
      {
        "id": "anime-id",
        "time": "10:30",
        "title": "Anime Title",
        "jname": "Japanese Title",
        "episode": 12
      }
    ],
    "2024-01-02": [ ... ]
  }
}

18. GET All Genres

Retrieve all available anime genres.

Endpoint:

GET /api/v1/genres

Request Example:

const resp = await fetch('/api/v1/genres');
const data = await resp.json();
console.log(data);

Response Schema:

{
  "success": true,
  "data": [
    {
      "name": "Action",
      "slug": "action"
    },
    {
      "name": "Adventure",
      "slug": "adventure"
    }
  ]
}

19. GET Top Airing

Retrieve currently airing top anime.

Endpoint:

GET /api/v1/animes/top-airing?page=:page

Request Example:

const resp = await fetch('/api/v1/animes/top-airing?page=1');
const data = await resp.json();
console.log(data);

20. GET Most Popular

Retrieve most popular anime.

Endpoint:

GET /api/v1/animes/most-popular?page=:page

Request Example:

const resp = await fetch('/api/v1/animes/most-popular?page=1');
const data = await resp.json();
console.log(data);

21. GET Most Favorite

Retrieve most favorited anime.

Endpoint:

GET /api/v1/animes/most-favorite?page=:page

Request Example:

const resp = await fetch('/api/v1/animes/most-favorite?page=1');
const data = await resp.json();
console.log(data);

22. GET Completed Anime

Retrieve completed anime series.

Endpoint:

GET /api/v1/animes/completed?page=:page

Request Example:

const resp = await fetch('/api/v1/animes/completed?page=1');
const data = await resp.json();
console.log(data);

23. GET Recently Added

Retrieve recently added anime.

Endpoint:

GET /api/v1/animes/recently-added?page=:page

Request Example:

const resp = await fetch('/api/v1/animes/recently-added?page=1');
const data = await resp.json();
console.log(data);

24. GET Recently Updated

Retrieve recently updated anime.

Endpoint:

GET /api/v1/animes/recently-updated?page=:page

Request Example:

const resp = await fetch('/api/v1/animes/recently-updated?page=1');
const data = await resp.json();
console.log(data);

25. GET Top Upcoming

Retrieve top upcoming anime.

Endpoint:

GET /api/v1/animes/top-upcoming?page=:page

Request Example:

const resp = await fetch('/api/v1/animes/top-upcoming?page=1');
const data = await resp.json();
console.log(data);

26. GET Anime by Genre

Retrieve anime filtered by specific genre.

Endpoint:

GET /api/v1/animes/genre/:genre?page=:page

Available Genres: 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

Request Example:

const resp = await fetch('/api/v1/animes/genre/action?page=1');
const data = await resp.json();
console.log(data);

27. GET Anime by Producer

Retrieve anime filtered by production studio or company.

Endpoint:

GET /api/v1/animes/producer/:producer?page=:page

Producer Examples: bones, toei-animation, mappa, ufotable, kyoto-animation, wit-studio, madhouse, a-1-pictures, trigger, cloverworks

Request Example:

const resp = await fetch('/api/v1/animes/producer/bones?page=1');
const data = await resp.json();
console.log(data);

Response Schema:

{
  "success": true,
  "data": {
    "pageInfo": {
      "totalPages": 15,
      "currentPage": 1,
      "hasNextPage": true
    },
    "animes": [
      {
        "title": "My Hero Academia",
        "alternativeTitle": "Boku no Hero Academia",
        "id": "my-hero-academia-67",
        "poster": "https://cdn.noitatnemucod.net/thumbnail/300x400/100/...",
        "episodes": {
          "sub": 13,
          "dub": 13,
          "eps": 13
        },
        "type": "TV",
        "duration": "24m"
      }
    ]
  }
}

28. GET Subbed Anime

Retrieve anime with subtitles available.

Endpoint:

GET /api/v1/animes/subbed-anime?page=:page

Request Example:

const resp = await fetch('/api/v1/animes/subbed-anime?page=1');
const data = await resp.json();
console.log(data);

29. GET Dubbed Anime

Retrieve anime with English dub available.

Endpoint:

GET /api/v1/animes/dubbed-anime?page=:page

Request Example:

const resp = await fetch('/api/v1/animes/dubbed-anime?page=1');
const data = await resp.json();
console.log(data);

30. GET Anime Movies

Retrieve anime movies.

Endpoint:

GET /api/v1/animes/movie?page=:page

Request Example:

const resp = await fetch('/api/v1/animes/movie?page=1');
const data = await resp.json();
console.log(data);

31. GET TV Series

Retrieve anime TV series.

Endpoint:

GET /api/v1/animes/tv?page=:page

Request Example:

const resp = await fetch('/api/v1/animes/tv?page=1');
const data = await resp.json();
console.log(data);

32. GET OVA

Retrieve Original Video Animation (OVA) content.

Endpoint:

GET /api/v1/animes/ova?page=:page

Request Example:

const resp = await fetch('/api/v1/animes/ova?page=1');
const data = await resp.json();
console.log(data);

33. GET ONA

Retrieve Original Net Animation (ONA) content.

Endpoint:

GET /api/v1/animes/ona?page=:page

Request Example:

const resp = await fetch('/api/v1/animes/ona?page=1');
const data = await resp.json();
console.log(data);

34. GET Special

Retrieve special anime episodes.

Endpoint:

GET /api/v1/animes/special?page=:page

Request Example:

const resp = await fetch('/api/v1/animes/special?page=1');
const data = await resp.json();
console.log(data);

35. GET Events

Retrieve anime events.

Endpoint:

GET /api/v1/animes/events?page=:page

Request Example:

const resp = await fetch('/api/v1/animes/events?page=1');
const data = await resp.json();
console.log(data);

36. Clear Redis Cache

Clear all cached data from Redis. Useful for forcing fresh data retrieval.

Endpoint:

GET /api/v1/admin/clear-cache

Request Example:

const resp = await fetch('/api/v1/admin/clear-cache');
const data = await resp.json();
console.log(data);

Response Schema:

{
  "success": true,
  "data": {
    "success": true,
    "message": "Cache cleared successfully",
    "keysCleared": 5
  }
}

Notes:

This endpoint clears ALL cached data
Use sparingly as it will impact performance temporarily
Returns the number of cache keys that were cleared
If Redis is not configured, returns an error message

Development

Pull requests and stars are always welcome. If you encounter any bug or want to add a new feature to this API, consider creating a new issue. If you wish to contribute to this project, feel free to make a pull request.

Running in Development Mode

bun run dev

Running in Production Mode

bun start

37. GET Anime News

Retrieve latest anime news articles.

Endpoint:

GET /api/v1/news?page=:page

Request Example:

const resp = await fetch('/api/v1/news?page=1');
const data = await resp.json();
console.log(data);

Response Schema:

{
  "success": true,
  "data": {
    "news": [
      {
        "id": "article-id",
        "title": "Article Title",
        "description": "...",
        "thumbnail": "https://...",
        "uploadedAt": "2 hours ago"
      }
    ]
  }
}

38. GET Watch2gether Rooms

Retrieve active watch party rooms.

Endpoint:

GET /api/v1/watch2gether?room=:filter

Filters: all, on_air, scheduled, waiting, ended

Request Example:

const resp = await fetch('/api/v1/watch2gether?room=on_air');
const data = await resp.json();
console.log(data);

Response Schema:

{
  "success": true,
  "data": {
    "rooms": [
      {
        "id": "room-id",
        "animeTitle": "One Piece",
        "roomTitle": "Watch One Piece together",
        "status": "On-air",
        "type": "SUB",
        "episode": "Episode 1"
      }
    ]
  }
}

39. GET Random Anime

Retrieve a random anime ID.

Endpoint:

GET /api/v1/random

Request Example:

const resp = await fetch('/api/v1/random');
const data = await resp.json();
console.log(data);

Response Schema:

{
  "success": true,
  "data": {
    "id": "anime-id-123"
  }
}

Contributors

Thanks to the following people for keeping this project alive and relevant:

Want to contribute? Check out our contribution guidelines and feel free to submit a pull request!

Acknowledgments

Special thanks to the following projects for inspiration and reference:

Support

If you find this project useful, please consider giving it a star on GitHub!

Made by RY4N

Report Bug • Request Feature

Name		Name	Last commit message	Last commit date
Latest commit History 116 Commits
.github		.github
src		src
.dockerignore		.dockerignore
.env.example		.env.example
.gitignore		.gitignore
.prettierignore		.prettierignore
.prettierrc		.prettierrc
CLOUDFLARE.md		CLOUDFLARE.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
DEPLOYMENT.md		DEPLOYMENT.md
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
bun.lock		bun.lock
eslint.config.mjs		eslint.config.mjs
index.js		index.js
jsconfig.json		jsconfig.json
package-lock.json		package-lock.json
package.json		package.json
wrangler.toml		wrangler.toml

License

ryanwtf88/hianime-api

Folders and files

Latest commit

History

Repository files navigation

hianime-api

Table of Contents

Overview

Important Notice

Used By

Installation

Prerequisites

NPM Usage

Local Setup

Deployment

Docker Deployment

Cloudflare Workers Deployment

Vercel Proxy (Separate Deployment)

Replit Deployment

Documentation

1. GET Anime Home Page

2. GET Next Episode Schedule

4. GET Anime List Page

5. GET Anime Detailed Info

6. GET Search Results

7. GET Search Suggestions

8. Filter Anime

9. GET Filter Options

10. GET Anime Characters

11. GET Character Details

12. GET Anime Episodes

13. GET Anime Episode Servers

14. GET Anime Episode Streaming Links

15. GET Embedded Video Player

16. GET Proxy Stream/Subtitle

17. GET Anime Schedules (7 Days)

18. GET All Genres

19. GET Top Airing

20. GET Most Popular

21. GET Most Favorite

22. GET Completed Anime

23. GET Recently Added

24. GET Recently Updated

25. GET Top Upcoming

26. GET Anime by Genre

27. GET Anime by Producer

28. GET Subbed Anime

29. GET Dubbed Anime

30. GET Anime Movies

31. GET TV Series

32. GET OVA

33. GET ONA

34. GET Special

35. GET Events

36. Clear Redis Cache

Development

Running in Development Mode

Running in Production Mode

37. GET Anime News

38. GET Watch2gether Rooms

39. GET Random Anime

Contributors

Acknowledgments

Support

About

Topics

Resources

License

Code of conduct

Uh oh!

Stars

Watchers

Forks

Packages 0

Uh oh!

Uh oh!

Contributors 3

Uh oh!

Languages

Packages