# AniList Anime & Manga Scraper (`straightforward_hydra/anilist-anime-manga-scraper`) Actor Anime & manga data from AniList's open API: trending, top-rated, most-popular, seasonal charts and search. No API key. - **URL**: https://apify.com/straightforward\_hydra/anilist-anime-manga-scraper.md - **Developed by:** [Dev D](https://apify.com/straightforward_hydra) (community) - **Categories:** Developer tools, E-commerce, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 media This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use 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 ## AniList Anime & Manga Scraper ๐ŸŒธ **Trending anime, top-rated manga, seasonal charts and title search โ€” straight from AniList's open API. No API key, no login, no browser.** Pull clean, structured anime & manga data from [AniList](https://anilist.co): what's **trending right now**, the **highest-rated** series of all time, the **most popular** titles, full **seasonal charts** (Winter/Spring/Summer/Fall of any year), or a simple **title search**. Perfect for anime recommendation apps, seasonal-chart dashboards, Discord bots, tracking tools and research. > Powered by AniList's public GraphQL API โ€” open data, no key required. Fully testable out of the box. --- ### What you can build with it - ๐Ÿ”ฅ **Trending tracker** โ€” snapshot what's hot each week and feed a "what to watch now" list. - โญ **Top-100 rankings** โ€” highest-scored anime *or* manga of all time. - ๐ŸŒธ **Seasonal charts** โ€” every show airing in Summer 2026 with live episode countdowns. - ๐Ÿ”Ž **Title lookup** โ€” resolve a name to scores, studios, genres, artwork and AniList/MyAnimeList IDs. - ๐Ÿค– **Discord / Telegram bots** โ€” power an "!anime " command with real data. - ๐Ÿ“Š **Recommendation engines** โ€” filter by genre + minimum score to seed a catalog. ### Features - โœ… **No API key** โ€” AniList's open GraphQL endpoint, works instantly. - โœ… **Anime *and* manga** โ€” one Actor, both libraries. - โœ… **6 modes** โ€” trending, top-rated, most-popular, most-favourited, seasonal, search. - โœ… **Rich records** โ€” scores, popularity, favourites, genres, tags, studios, cover art, next-episode countdown, AniList + MyAnimeList IDs. - โœ… **Filters** โ€” genre and minimum score on top of any mode. - โœ… **Low-maintenance** โ€” stable public API, one clean record per title. --- ### Input | Field | Description | |---|---| | **Mode** | trending / top-rated / most-popular / most-favourited / seasonal / search. | | **Anime or Manga** | Which library to pull from. | | **Search title** | Free-text title search (Search mode). | | **Season / Season year** | e.g. Summer + 2026 (Seasonal mode). | | **Genre** | Optional filter, e.g. Action, Romance, Sports. | | **Minimum score** | Optional 0โ€“100 average-score floor. | | **Max results** | How many titles to return. | #### Example โ€” trending anime right now ```json { "mode": "trending", "mediaType": "ANIME", "maxResults": 50 } ```` #### Example โ€” Summer 2026 seasonal chart ```json { "mode": "seasonal", "mediaType": "ANIME", "season": "SUMMER", "seasonYear": 2026, "maxResults": 100 } ``` #### Example โ€” top-rated Sports anime ```json { "mode": "top-rated", "mediaType": "ANIME", "genre": "Sports", "minScore": 80 } ``` ### Output One row per title: ```json { "id": 154587, "id_mal": 52991, "title_romaji": "Sousou no Frieren", "title_english": "Frieren: Beyond Journeyโ€™s End", "title_native": "่‘ฌ้€ใฎใƒ•ใƒชใƒผใƒฌใƒณ", "type": "ANIME", "format": "TV", "status": "FINISHED", "episodes": 28, "average_score": 91, "popularity": 459331, "favourites": 40000, "genres": ["Adventure", "Drama", "Fantasy"], "tags": ["Elf", "Magic", "Time Skip"], "studios": ["Madhouse"], "season": "FALL", "season_year": 2023, "cover_image": "https://s4.anilist.co/file/...jpg", "next_episode": null, "next_airing_in_sec": null, "url": "https://anilist.co/anime/154587" } ``` Manga rows include `chapters` / `volumes`; currently-airing anime include `next_episode`, `next_airing_at` and `next_airing_in_sec` (a live countdown). ### Run it on a schedule Schedule the Actor to snapshot **trending** or **seasonal** charts over time and connect a **Google Sheets / Slack / Discord webhook** integration to build your own anime dashboard or airing-notifier. ### Notes & limitations - Uses AniList's open GraphQL API โ€” no key needed. - Genres/scores are point-in-time snapshots at run time. - Data attribution: powered by [AniList](https://anilist.co). - Public catalog data (non-personal). *** #### Keywords AniList, anime scraper, manga scraper, anime API, anime data, manga data, anime list, seasonal anime, trending anime, top anime, anime rankings, anime ratings, MyAnimeList, MAL, anime database, anime charts, airing schedule, anime tracker, otaku data, anime dashboard, Japan, anime recommendations. # Actor input Schema ## `mode` (type: `string`): What to pull. Trending = hot right now; Top rated = highest scores; Most popular = biggest audience; Seasonal = a specific anime season; Search = by title. ## `mediaType` (type: `string`): Which library to pull from. ## `search` (type: `string`): Free-text title search, e.g. "Frieren", "One Piece", "Chainsaw Man". Only used in Search mode. ## `season` (type: `string`): Anime season. Only used in Seasonal mode. ## `seasonYear` (type: `integer`): Year for the seasonal chart, e.g. 2026. Only used in Seasonal mode. ## `genre` (type: `string`): Limit to a genre, e.g. Action, Romance, Comedy, Fantasy, Horror, Sci-Fi, Slice of Life, Sports, Mystery, Psychological. ## `minScore` (type: `integer`): Only keep titles with an average score at or above this (0โ€“100). ## `maxResults` (type: `integer`): How many titles to return (sorted by the chosen mode). AniList pages 50 at a time. ## Actor input object example ```json { "mode": "trending", "mediaType": "ANIME", "maxResults": 50 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '<YOUR_API_TOKEN>' with your token const client = new ApifyClient({ token: '<YOUR_API_TOKEN>', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("straightforward_hydra/anilist-anime-manga-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '<YOUR_API_TOKEN>' with your token. client = ApifyClient("<YOUR_API_TOKEN>") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("straightforward_hydra/anilist-anime-manga-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call straightforward_hydra/anilist-anime-manga-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=straightforward_hydra/anilist-anime-manga-scraper", "--header", "Authorization: Bearer <YOUR_API_TOKEN>" ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "AniList Anime & Manga Scraper", "description": "Anime & manga data from AniList's open API: trending, top-rated, most-popular, seasonal charts and search. No API key.", "version": "0.1", "x-build-id": "6MJC4IdTqzx3FolNf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/straightforward_hydra~anilist-anime-manga-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-straightforward_hydra-anilist-anime-manga-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/straightforward_hydra~anilist-anime-manga-scraper/runs": { "post": { "operationId": "runs-sync-straightforward_hydra-anilist-anime-manga-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/straightforward_hydra~anilist-anime-manga-scraper/run-sync": { "post": { "operationId": "run-sync-straightforward_hydra-anilist-anime-manga-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Mode", "enum": [ "trending", "top-rated", "most-popular", "most-favourited", "seasonal", "search" ], "type": "string", "description": "What to pull. Trending = hot right now; Top rated = highest scores; Most popular = biggest audience; Seasonal = a specific anime season; Search = by title.", "default": "trending" }, "mediaType": { "title": "Anime or Manga", "enum": [ "ANIME", "MANGA" ], "type": "string", "description": "Which library to pull from.", "default": "ANIME" }, "search": { "title": "Search title (Search mode)", "type": "string", "description": "Free-text title search, e.g. \"Frieren\", \"One Piece\", \"Chainsaw Man\". Only used in Search mode." }, "season": { "title": "Season (Seasonal mode)", "enum": [ "WINTER", "SPRING", "SUMMER", "FALL" ], "type": "string", "description": "Anime season. Only used in Seasonal mode." }, "seasonYear": { "title": "Season year (Seasonal mode)", "minimum": 1940, "maximum": 2100, "type": "integer", "description": "Year for the seasonal chart, e.g. 2026. Only used in Seasonal mode." }, "genre": { "title": "Genre filter (optional)", "type": "string", "description": "Limit to a genre, e.g. Action, Romance, Comedy, Fantasy, Horror, Sci-Fi, Slice of Life, Sports, Mystery, Psychological." }, "minScore": { "title": "Minimum score (optional)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only keep titles with an average score at or above this (0โ€“100)." }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "How many titles to return (sorted by the chosen mode). AniList pages 50 at a time.", "default": 50 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```