Anime API Documentation

API Overview

The Anime API provides random anime recommendations. You can get completely random anime or filter by specific genres.

Base URL: https://hisham-zahid.online/api/v1/anime/random

Features

Random Anime: Get a completely random anime recommendation
Genre Filtering: Filter by one or multiple genres
Flexible Genre Matching: Supports various genre formats (spaces, underscores, case-insensitive)
Rich Response: Includes title, type, episodes, genres, and MAL URL
Fast Response: Direct database queries for optimal performance

Endpoint

GET

/api/v1/anime/random

Parameters

Parameter	Type	Required	Description
`tags`	string	No	Comma-separated list of genre tags to filter by. Case-insensitive, supports spaces and underscores

Response Format

{
  "title": "Anime Title",
  "mal_url": "https://myanimelist.net/anime/...",
  "type": "TV",
  "episodes": 24,
  "genres": ["Action", "Adventure", "Drama"]
}

Usage Examples

1. Random Anime (No Tags)

GET https://hisham-zahid.online/api/v1/anime/random

2. Get All Available Tags

GET https://hisham-zahid.online/api/v1/anime/tags

3. Single Tag Filter

GET https://hisham-zahid.online/api/v1/anime/random?tags=action

4. Multiple Tags Filter

GET https://hisham-zahid.online/api/v1/anime/random?tags=action,adventure,fantasy

5. Flexible Genre Formats

All of these will work for "Slice of Life" genre:

GET https://hisham-zahid.online/api/v1/anime/random?tags=Slice of Life
GET https://hisham-zahid.online/api/v1/anime/random?tags=Slice_of_Life
GET https://hisham-zahid.online/api/v1/anime/random?tags=slice_of_life

Response Codes

200 Success

Request successful, anime data returned

404 Not Found

No anime found for the provided tags or no anime in database

{"error": "No anime found for the provided tags"}

500 Internal Server Error

Server error occurred while processing request

{"error": "Internal server error"}

Additional Information

Genre Matching

The API uses flexible genre matching that:

Is case-insensitive
Handles spaces, underscores, and hyphens interchangeably
Matches genres exactly after normalization

Response Fields

title: The anime title
mal_url: MyAnimeList URL for the anime
type: Anime type (TV, Movie, OVA, etc.)
episodes: Number of episodes (null for unknown)
genres: Array of genre names