# MyAnimeList Scraper — Anime & Manga Data, Ratings API (`logiover/mal-anime-scraper`) Actor
Unofficial MyAnimeList API powered by the free, open Jikan API — no key, no browser. Scrape anime & manga data: top charts, full-text search, seasonal anime, ratings, characters, voice actors and recommendations. Export to JSON, CSV or Excel for analytics, ML and recommendation engines.
- **URL**: https://apify.com/logiover/mal-anime-scraper.md
- **Developed by:** [Logiover](https://apify.com/logiover) (community)
- **Categories:** Videos, Business, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $3.50 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## 🍥 MyAnimeList Scraper — Anime & Manga Data API Alternative (Ratings, Seasonal, Characters)
    
An **unofficial MyAnimeList scraper** and structured **anime data API** in a single Apify actor. Pull top anime and manga charts, run full-text search, browse any season, and fetch ratings, characters, voice actors and recommendations — primarily through the **free, open Jikan API** (the unofficial MyAnimeList API), with a direct public-MyAnimeList fallback for anime search and seasonal discovery when Jikan's list parser is unavailable. No API key, no login, no OAuth, no headless browser — just fast HTTP and clean, flat JSON you can export to CSV, Excel or JSON.
This **MyAnimeList API alternative** is built for data teams, anime and manga analysts, recommendation-engine developers, machine-learning practitioners, streaming apps, Discord bot builders and AI agents who need reliable, structured **anime data** on demand. Eight modes share one input form, and every result is tagged with `_mode` so you can mix modes in a single dataset and filter later.
> ### 🏆 Why this MyAnimeList scraper?
>
> 8 modes in one actor · anime + manga charts, search, seasonal, details, characters & recommendations · 30+ fields per title · no API key / no OAuth / no browser · Jikan + direct public-MAL recovery path · export to JSON, CSV & Excel · the practical **MyAnimeList API alternative**
***
### ✨ What this Actor does
- **📊 Top charts** — the highest-rated and most-popular anime and manga, paginated through the full ranking. Filter by `airing`, `upcoming`, `bypopularity` or `favorite`.
- **⭐ Ratings & rankings** — `score`, `scoredBy`, `rank`, `popularity`, `members` and `favorites` on every anime and manga, straight from MyAnimeList.
- **🔎 Full-text search** — search anime or manga by title and narrow with genre IDs, media type, airing/publishing status, and custom ordering (by score, rank, popularity, members, start date and more).
- **🗓️ Seasonal anime** — every title in a given `winter` / `spring` / `summer` / `fall` season for any year, or the current season — a ready-made **seasonal anime API**.
- **📺 Anime details** — `title`, `titleEnglish`, `titleJapanese`, `type`, `episodes`, `status`, `source`, `duration`, `rating`, `year`, `season`, `genres[]`, `themes[]`, `demographics[]`, `studios[]`, `producers[]`, `airedFrom` / `airedTo`, `synopsis`, poster `imageUrl` and `trailerUrl`.
- **📚 Manga details** — `chapters`, `volumes`, publishing status, `authors[]`, `serializations[]`, `publishedFrom` / `publishedTo` and the full synopsis.
- **🎭 Characters & voice actors** — every character of an anime with `role`, `favorites`, image and the `voiceActors[]` cast (name + language).
- **🤝 Recommendations** — the community recommendation graph: which anime fans of a given title also recommend, with vote counts.
- **🧩 Mix modes in one dataset** — every item carries `_mode` and `scrapedAt` (ISO 8601) plus a clean MyAnimeList `url`, so you can run several modes and filter later.
- **🛡️ Honest outage handling** — if Jikan's anime-search or seasonal list parser returns a persistent upstream 5xx, the actor discovers canonical IDs from MyAnimeList's public pages and enriches them through Jikan's per-ID route. If neither route can produce trustworthy data, the run fails explicitly instead of reporting a misleading successful empty dataset.
- **📤 Export anywhere** — CSV, JSON, Excel (XLSX), HTML, RSS or JSON Lines, with five pre-built dataset views (Overview, Anime, Manga, Characters, Recommendations).
#### The 8 modes
| Mode | What it returns |
|---|---|
| `topAnime` | Top / most-popular anime chart, paginated (highest volume, default) |
| `topManga` | Top / most-popular manga chart, paginated |
| `searchAnime` | Full-text anime search with genre, type, status and ordering filters |
| `searchManga` | Full-text manga search |
| `seasonal` | Every anime in a season (by year & season, or the current season) |
| `animeDetails` | Full details for one or many anime IDs (batch) |
| `characters` | Characters + voice actors for one or many anime IDs |
| `recommendations` | Community anime recommendations for one or many anime IDs |
***
### 🚀 Quick start (3 steps)
1. **Configure** — open the actor, pick a **Mode**, and fill the fields that mode needs (the input form shows which apply). For example, choose `topAnime` and set `maxResults: 100`.
2. **Run** — click **Start**. The actor paginates the Jikan API, applies retry/backoff, uses the public-MAL recovery path for affected anime search/seasonal requests, and streams clean rows into your dataset.
3. **Get your data** — download the results as CSV, JSON or Excel from the run page, switch between the Anime / Manga / Characters / Recommendations views, or pull them via the Apify API.
***
### 📥 Input
Pick a **mode**, then set only the fields that mode uses. Here are three ready-to-run scenarios:
**Top 100 currently-airing anime by rating**
```json
{
"mode": "topAnime",
"filter": "airing",
"maxResults": 100
}
```
**Highest-scoring fantasy anime (search + genre + order)**
```json
{
"mode": "searchAnime",
"query": "",
"genres": ["10"],
"orderBy": "score",
"sort": "desc",
"maxResults": 100
}
```
**Characters & voice actors for a batch of anime IDs**
```json
{
"mode": "characters",
"animeIds": ["1", "5", "20"]
}
```
| Field | Type | Description |
|---|---|---|
| `mode` | string | **Required.** Which endpoint to run: `topAnime`, `topManga`, `searchAnime`, `searchManga`, `seasonal`, `animeDetails`, `characters` or `recommendations`. Default `topAnime`. |
| `query` | string | Free-text term for `searchAnime` / `searchManga`. Leave empty to browse all entries by the chosen filters/order. |
| `genres` | array | One or more MyAnimeList genre IDs (e.g. `1`=Action, `10`=Fantasy, `22`=Romance, `24`=Sci-Fi). Filters the search modes. |
| `status` | string | Airing/publishing status. Anime: `airing`, `complete`, `upcoming`. Manga: `publishing`, `complete`, `hiatus`, `discontinued`, `upcoming`. |
| `orderBy` | string | Sort field for search, e.g. `score`, `rank`, `popularity`, `members`, `favorites`, `title`, `start_date`, `episodes` / `chapters`. |
| `sort` | string | Sort direction for `orderBy`: `desc` (highest first) or `asc`. |
| `filter` | string | Chart filter for `topAnime` / `topManga`: `airing`, `publishing`, `upcoming`, `bypopularity`, `favorite`, or empty for the overall top-rated chart. |
| `type` | string | Media type filter. Anime: `tv`, `movie`, `ova`, `special`, `ona`, `music`. Manga: `manga`, `novel`, `lightnovel`, `oneshot`, `doujin`, `manhwa`, `manhua`. |
| `year` | integer | Year for `seasonal` mode (e.g. `2024`). Combine with `season`. |
| `season` | string | Season for `seasonal` mode: `winter`, `spring`, `summer` or `fall`. Leave year + season empty for the current season. |
| `animeId` | string | Single numeric MyAnimeList anime ID (e.g. `1` = Cowboy Bebop) for `animeDetails` / `characters` / `recommendations`. |
| `animeIds` | array | Array of numeric MAL anime IDs for batch `animeDetails` / `characters` / `recommendations`. |
| `maxResults` | integer | Upper bound on rows for the paginated modes (`topAnime`, `topManga`, `searchAnime`, `searchManga`, `seasonal`). Jikan returns 25 per page, so 100 = 4 pages. Default `100`. |
***
### 📤 Output
Results stream to the default dataset. Every item carries a `_mode` field so you can filter or pivot on it. Here is a trimmed anime row (`topAnime` / `searchAnime` / `seasonal` / `animeDetails`):
```json
{
"_mode": "topAnime",
"malId": 5114,
"title": "Fullmetal Alchemist: Brotherhood",
"titleEnglish": "Fullmetal Alchemist: Brotherhood",
"titleJapanese": "鋼の錬金術師 FULLMETAL ALCHEMIST",
"type": "TV",
"episodes": 64,
"status": "Finished Airing",
"source": "Manga",
"duration": "24 min per ep",
"rating": "R - 17+ (violence & profanity)",
"score": 9.1,
"scoredBy": 2145678,
"rank": 1,
"popularity": 3,
"members": 3421890,
"favorites": 225114,
"year": 2009,
"season": "spring",
"genres": ["Action", "Adventure", "Drama", "Fantasy"],
"themes": ["Military"],
"demographics": ["Shounen"],
"studios": ["Bones"],
"producers": ["Aniplex", "Square Enix"],
"airedFrom": "2009-04-05",
"airedTo": "2010-07-04",
"synopsis": "After a failed attempt to bring their mother back...",
"imageUrl": "https://cdn.myanimelist.net/images/anime/1208/94745.jpg",
"trailerUrl": "https://www.youtube.com/watch?v=--IcmZkvL0Q",
"url": "https://myanimelist.net/anime/5114",
"scrapedAt": "2026-07-06T09:00:00.000Z"
}
```
📋 Full field reference (click to expand)
**Anime & manga rows** (`topAnime`, `topManga`, `searchAnime`, `searchManga`, `seasonal`, `animeDetails`)
| Field | Description |
|---|---|
| `_mode` | Which endpoint produced the row (filter/pivot on it) |
| `malId` | Numeric MyAnimeList ID |
| `title` | Default (romaji) title |
| `titleEnglish` | English title |
| `titleJapanese` | Japanese title |
| `type` | Media type (TV, Movie, OVA… / Manga, Novel…) |
| `episodes` | Episode count (anime) |
| `chapters` | Chapter count (manga) |
| `volumes` | Volume count (manga) |
| `status` | Airing / publishing status |
| `source` | Source material (e.g. Manga, Light novel, Original) |
| `duration` | Episode runtime (anime) |
| `rating` | Content rating (anime) |
| `score` | Average MAL score |
| `scoredBy` | Number of users who scored it |
| `rank` | Overall rank |
| `popularity` | Popularity rank |
| `members` | Members who added it to a list |
| `favorites` | Number of users who favorited it |
| `year` | Release year (anime) |
| `season` | Release season (anime) |
| `genres` | Genre names (array) |
| `themes` | Theme tags (array) |
| `demographics` | Demographic tags, e.g. Shounen (array) |
| `studios` | Animation studios (array, anime) |
| `producers` | Producers (array, anime) |
| `authors` | Authors (array, manga) |
| `serializations` | Serializing magazines (array, manga) |
| `airedFrom` / `airedTo` | Airing start / end date (anime) |
| `publishedFrom` / `publishedTo` | Publishing start / end date (manga) |
| `synopsis` | Full synopsis text |
| `imageUrl` | Poster / cover image URL |
| `trailerUrl` | Trailer URL (anime) |
| `url` | Canonical MyAnimeList URL |
| `scrapedAt` | Capture time (ISO 8601) |
**Character rows** (`characters` mode)
| Field | Description |
|---|---|
| `animeId` | Source anime MAL ID |
| `name` | Character name |
| `role` | Main / Supporting |
| `favorites` | Character favorites count |
| `voiceActors` | Cast: each entry's name + language |
| `imageUrl` | Character image URL |
| `url` | Character's MyAnimeList URL |
**Recommendation rows** (`recommendations` mode)
| Field | Description |
|---|---|
| `sourceAnimeId` | The anime you asked about |
| `recommendedId` | MAL ID of the recommended anime |
| `title` | Recommended anime title |
| `votes` | Community recommendation votes |
| `imageUrl` | Recommended anime poster URL |
| `url` | Recommended anime's MyAnimeList URL |