Metachan API (1.0.0)

Download OpenAPI specification:

CAUTION: I do not provide pre-hosted instances of the MetaChan API. You will need to host your own instance of the API to use it. MetaChan is provided on an "as-is" basis and fetches data from various public sources and projects, some of which may have rate limits, restrictions, and even contain pirated content. The API is intended for personal use only and should not be used for commercial purposes. I do not take any responsibility for any legal issues that may arise from using the API. Please use it at your own risk. I do not condone piracy or illegal distribution of content.

MetaChan

MetaChan Welcome to MetaChan. MetaChan is an Anime and Manga metadata API that provides a RESTful interface for accessing metadata for various anime and manga titles. MetaChan best integrates with MyAnimeList and uses MAL IDs as the primary identifier for anime and manga titles. AniList is also supported partially and will reverse lookup MAL IDs.

health

Health check and system status endpoints

Get system health status

Returns the current health status of the API including memory usage, database status, and running tasks

Responses

Response samples

Content type
application/json
{
  • "status": "healthy",
  • "timestamp": "2026-01-16T06:10:19Z",
  • "uptime": "7s",
  • "memory": {
    },
  • "database": {
    },
  • "tasks": {
    }
}

anime

Anime information endpoints

Get anime details

Retrieves comprehensive information about an anime including metadata, episodes, characters, and streaming details.

Supports both MyAnimeList (MAL) IDs and AniList IDs via the provider query parameter.

  • Default: Uses MAL ID
  • With provider=anilist: Uses AniList ID and reverse lookups MAL ID
path Parameters
id
required
integer
Example: 1

The anime ID (MAL ID by default, or AniList ID when provider=anilist)

query Parameters
provider
string
Value: "anilist"
Example: provider=anilist

The ID provider type. Omit for MAL ID, use 'anilist' for AniList ID

Responses

Response samples

Content type
application/json
{}

episodes

Episode-specific endpoints

Get all episodes for an anime

Retrieves a list of all episodes for the specified anime, including metadata like titles, air dates, scores, and episode counts.

The response includes both individual episode data and aggregate statistics (total, aired, subbed, dubbed counts).

Supports both MyAnimeList (MAL) IDs and AniList IDs via the provider query parameter.

path Parameters
id
required
integer
Example: 1

The anime ID (MAL ID by default, or AniList ID when provider=anilist)

query Parameters
provider
string
Value: "anilist"

The ID provider type. Omit for MAL ID, use 'anilist' for AniList ID

Responses

Response samples

Content type
application/json
{}

Get single episode details

Retrieves detailed information about a specific episode including:

  • Episode metadata (titles, description, air date, scores)
  • Streaming sources for both subbed and dubbed versions
  • Filler/recap indicators

Streaming data is cached for 7 days to improve performance.

Supports both MyAnimeList (MAL) IDs and AniList IDs via the provider query parameter.

path Parameters
id
required
integer
Example: 1

The anime ID (MAL ID by default, or AniList ID when provider=anilist)

episodeId
required
string
Example: a1b2c3d4e5f6

The unique episode ID (hash generated from episode titles)

query Parameters
provider
string
Value: "anilist"

The ID provider type. Omit for MAL ID, use 'anilist' for AniList ID

Responses

Response samples

Content type
application/json
{}

characters

Character and voice actor endpoints

Get anime characters

Retrieves a list of characters for the specified anime, including:

  • Character information (name, image, role)
  • Voice actors for each character
  • Voice actor languages

Supports both MyAnimeList (MAL) IDs and AniList IDs via the provider query parameter.

path Parameters
id
required
integer
Example: 1

The anime ID (MAL ID by default, or AniList ID when provider=anilist)

query Parameters
provider
string
Value: "anilist"

The ID provider type. Omit for MAL ID, use 'anilist' for AniList ID

Responses

Response samples

Content type
application/json
[]