HIGH-PERFORMANCE DATA CORE

Premium AniForge Anime API

A high-performance metadata, discovery, and streaming core engine powering the next generation of anime platforms. 15,000+ anime titles, 300,000+ episodes, 200,000+ characters, and 50,000+ people — all cross-referenced from MAL, AniList, AniDB, and TMDB. Lightning fast, richly detailed, and constantly syncing.

Advanced Search

Multi-parameter filtering with support for genres, tags, studios, and scores with sub-100ms latency.

Deep Metadata

Comprehensive character bios, voice actor listings across languages, and staff roles cross-referenced from multiple global databases.

Real-Time Sync

Automated Just-In-Time (JIT) pipelines keep airing statuses, episode thumbnails, and stream embeds perfectly up-to-date.

Rich Episode Data

Every episode enriched with embedded player links, filler flags, airdates, and multi-source support (AniList/MAL IDs + direct embed IDs).

v1.0.0 REST / JSON ~110 Endpoints CORS Enabled Bun + Hono MySQL (MariaDB) + Redis

Documentation

Overview

Pull a list of recently added anime, query detailed metadata, explore cross-referenced relations, and fetch episodes enriched with direct video embed player links (subbed and dubbed). All responses return clean, production-ready JSON structures.

Base URL
http://localhost:4430

Intended for backend and client application development: Call the API endpoints to retrieve metadata, populate listings, or enrich your catalog with complete character and staff references. Direct cross-origin (CORS) access is fully supported.

Authentication (API Keys)

Premium API keys bypass rate limits entirely. Pass your key as a Bearer token in the Authorization header:

curl -H "Authorization: Bearer af_live_<your_key_here>" \http://localhost:4430/anime/1

Keys are prefixed with af_live_. Requests without a valid key are still accepted but subject to rate limits.

Rate Limits

Free tier — Up to 120 requests per 60 seconds per IP. Tripping this limit returns a 429 Too Many Requests response with a Retry-After header.

Premium tier — Unlimited requests. All requests authenticated with a valid af_live_ API key are exempt from rate limiting.

Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset.

Try it

curl -s "http://localhost:4430/anime/recently-added"
curl -s "http://localhost:4430/anime/1/episodes"

JSON response

{}

Enter an anime ID, load its episodes, and pick one to play the embed stream.