anime-api

KO | EN

gitlite — search

#react #typescript #llm #golang #go #android #machine-learning #deep-learning #java #windows #awesome #kubernetes #mcp #open-source

(★ 11)

A REST API for anime discovery and stream extraction from miruro. Bypasses provider restrictions via internal pipe-forging, supports HLS proxying, and integrates seamlessly with AniList.

anime-api 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Kuhi API v2.0

> DISCLAIMER: This API is experimental and not reliable. Use at your own risk. No guarantees on uptime or data accuracy. I'M NOT RESPONSIBLE FOR ANY UNETHICAL USAGES OR LEGAL TROUBLES, ONLY FOR EDUCATION PURPOSE.

Current Status: 18/05/2026 (working)

A anime streaming API built for scale. Kuhi provides a clean REST interface to search, filter, and stream anime content with automatic source extraction and proxy capabilities.

## Features

-  **Smart Search** - Search by anime name or AniList ID
-  **Auto-Extraction** - Automatically finds best streaming sources
-  **Movie Detection** - Automatically handles movies vs episodes
-  **Decryption Pipeline** - Handles encrypted streaming sources
-  **CORS Proxy** - Built-in proxy for bypassing CDN restrictions
-  **HLS Streaming** - Full M3U8 playlist and segment proxying

## Installation

### Prerequisites
- Python 3.8+
- pip

### Setup

1. Clone the repository:
```bash
git clone https://github.com/aryaniiil/kuhi-anime-api
cd Kuhi-anime-api
```

2. Install dependencies:
```bash
python -m pip install -r requirements.txt
```

3. Run the server:
```bash
uvicorn api:app --reload
```

4. Access the API:
```
http://127.0.0.1:8000
```

## Project Structure

```
Kuhi/
├── src/
│   ├── __init__.py          # Package initializer
│   ├── main.py              # FastAPI app & proxy endpoints
│   ├── endpoints.py         # Anime API routes
│   ├── extractor.py         # AniList & Miruro data fetchers
│   ├── parser.py            # Data transformation utilities
│   ├── queries.py           # GraphQL query templates
│   └── config.py            # Configuration & constants
├── api.py                   # Alternative entry point
├── .gitignore              # Git ignore rules
└── README.md               # This file
```

## API Endpoints

### Search & Discovery

#### `GET /anime/search`
Search anime by keyword with pagination.

**Parameters:**
- `query` (string, required) - Search term
- `page` (int, default: 1) - Page number
- `per_page` (int, default: 20, max: 50) - Results per page

**Example:**
```bash
curl "http://127.0.0.1:8000/anime/search?query=naruto&page=1"
```

#### `GET /anime/suggestions`
Lightweight autocomplete search for dropdowns.

**Parameters:**
- `query` (string, required) - Search term

**Example:**
```bash
curl "http://127.0.0.1:8000/anime/suggestions?query=one%20piece"
```

#### `GET /anime/genres`
List all available genres for filtering.

**Example:**
```bash
curl "http://127.0.0.1:8000/anime/genres"
```

### Collections

#### `GET /anime/spotlight`
Top 10 trending and popular anime.

**Example:**
```bash
curl "http://127.0.0.1:8000/anime/spotlight"
```

#### `GET /anime/trending`
Currently trending anime with pagination.