Manga API Documentation

API Overview

The Manga API provides random manga recommendations . You can get completely random manga or filter by specific genres.

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

Features

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

Endpoint

GET

/api/v1/manga/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": "Manga Title",
  "mal_url": "https://myanimelist.net/manga/...",
  "status": "Completed",
  "chapters": 120,
  "volumes": 15,
  "genres": ["Romance", "Drama", "School"]
}

Usage Examples

1. Random Manga (No Tags)

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

2. Get All Available Tags

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

3. Single Tag Filter

GET https://hisham-zahid.online/api/v1/manga/random?tags=romance

4. Multiple Tags Filter

GET https://hisham-zahid.online/api/v1/manga/random?tags=romance,drama,school

5. Flexible Genre Formats

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

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

Response Codes

200 Success

Request successful, manga data returned

404 Not Found

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

{"error": "No manga 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 manga title
mal_url: MyAnimeList URL for the manga
status: Publication status (Completed, Ongoing, etc.)
chapters: Number of chapters (null for unknown)
volumes: Number of volumes (null for unknown)
genres: Array of genre names