Endpoint Description Fetch a complete list of animes with extensive filtering capabilities. This endpoint returns comprehensive anime data including metadata, genres, studios, ratings, and more. Results are cached for 2 hours to optimize performance.
Authentication This endpoint is publicly accessible and does not require authentication.
Rate Limiting
Limit : 100 requests per 60 seconds per IPHeaders : Rate limit information included in response headers
Query Parameters Filtering Parameters Filter by anime genres. Supports multiple values. Available genres : Action, Adventure, Avant Garde, Award Winning, Boys Love, Comedy, Drama, Ecchi, Erotica, Fantasy, Girls Love, Gourmet, Horror, Mystery, Romance, Sci-Fi, Slice of Life, Sports, Supernatural, SuspenseExample : genre_filter=Action,Adventure
Filter by anime type. Available types : TV, Movie, OVA, ONA, Special, Music, CM, PV, TV SpecialExample : type_filter=TV
Filter by animation studio name. Supports multiple studios. Example : studio_filter=MAPPA,Ufotable
Filter by minimum score (0-10). Example : score_filter=8.5
Filter by airing status. Available statuses : Finished Airing, Currently Airing, Not yet airedExample : status_filter=Currently Airing
Filter by release year. Example : year_filter=2024
Filter by age rating. Available ratings :
g - all ages (E)pg - children (E10+)pg-13 - teens 13 or older (13+)r - 17+ (violence & profanity) (15+)r+ - mild nudity (17+)rx+-+hentai (18+) Example : rating_filter=pg-13 - teens 13 or olderFilter by anime season. Available seasons : Winter, Spring, Summer, FallExample : season_filter=Spring
Filter by broadcast day of the week. Available days : Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, SundayExample : aired_day_filter=Saturday
Filter to only show animes with banner images. Example : banners_filter=true
Sorting Parameters Sort results by specified field. Available options :
score - Sort by score (descending)score_asc - Sort by score (ascending)title - Sort by title (descending)title_asc - Sort by title (ascending) Example : order_by=scoreContent Control Apply parental control filtering to exclude mature content. Example : parental_control=false
Search query to filter animes by title. Example : search_query=attack on titan
Response Array of anime objects Show Anime Object Properties
MyAnimeList ID (unique identifier)
Alternative titles and synonyms
Anime type (TV, Movie, OVA, etc.)
Source material (Manga, Light Novel, Original, etc.)
Whether the anime is currently airing
Start date (ISO 8601 format)
End date (ISO 8601 format)
Number of users who scored the anime
Number of times favorited
Anime description/synopsis
Anime season (Winter, Spring, Summer, Fall)
Day of the week for broadcast
Small WebP format image URL
Large WebP format image URL
YouTube video ID for trailer
Trailer thumbnail image URL
Whether the entry is approved on MAL
Cache-Control: public, max-age=7200, s-maxage=7200 Expires: <timestamp> Vary: Accept-Encoding
Examples Basic Request curl -X GET "https://your-domain.com/api/animes/full"
Filter by Genre and Type curl -X GET "https://your-domain.com/api/animes/full?genre_filter=Action,Adventure&type_filter=TV"
Filter by Score and Year curl -X GET "https://your-domain.com/api/animes/full?score_filter=8.0&year_filter=2024&order_by=score"
Search with Parental Control Disabled curl -X GET "https://your-domain.com/api/animes/full?search_query=demon&parental_control=false"
Response Example { "data" : [ { "mal_id" : 16498 , "title" : "Shingeki no Kyojin" , "title_english" : "Attack on Titan" , "title_japanese" : "進撃の巨人" , "title_synonyms" : [ "AoT" ], "type" : "TV" , "source" : "Manga" , "episodes" : 25 , "status" : "Finished Airing" , "airing" : false , "aired_from" : "2013-04-07T00:00:00.000Z" , "aired_to" : "2013-09-29T00:00:00.000Z" , "duration" : "24 min per ep" , "rating" : "r - 17+ (violence & profanity)" , "score" : 8.55 , "scored_by" : 2500000 , "popularity" : 1 , "members" : 3500000 , "favorites" : 180000 , "synopsis" : "Centuries ago, mankind was slaughtered to near extinction by monstrous humanoid creatures called Titans..." , "background" : "Shingeki no Kyojin adapts content from the first 8 volumes of the original manga..." , "season" : "Spring" , "year" : 2013 , "broadcast_day" : "Sunday" , "broadcast_time" : "01:58" , "broadcast_timezone" : "Asia/Tokyo" , "image_url" : "https://cdn.myanimelist.net/images/anime/10/47347.jpg" , "image_webp" : "https://cdn.myanimelist.net/images/anime/10/47347.webp" , "image_small_webp" : "https://cdn.myanimelist.net/images/anime/10/47347t.webp" , "image_large_webp" : "https://cdn.myanimelist.net/images/anime/10/47347l.webp" , "banner_image" : "https://example.com/banner.jpg" , "youtube_id" : "MGRm4IzK1SQ" , "trailer_url" : "https://www.youtube.com/watch?v=MGRm4IzK1SQ" , "trailer_embed_url" : "https://www.youtube.com/embed/MGRm4IzK1SQ" , "trailer_image_url" : "https://i.ytimg.com/vi/MGRm4IzK1SQ/maxresdefault.jpg" , "url" : "https://myanimelist.net/anime/16498/Shingeki_no_Kyojin" , "approved" : true , "genres" : [ "Action" , "Drama" , "Fantasy" , "Mystery" ], "studios" : [ "Wit Studio" ], "producers" : [ "Production I.G" , "Dentsu" , "Mainichi Broadcasting System" ], "licensors" : [ "Funimation" ], "themes" : [ "Military" , "Survival" ] } ] }
Error Responses Rate Limit Exceeded (429) { "error" : { "message" : "Too many requests. Please try again later." , "type" : "rate_limit" , "statusCode" : 429 } }
Internal Server Error (500) { "error" : { "message" : "Failed to fetch animes" , "type" : "database" , "statusCode" : 500 } }
Performance Tip : This endpoint implements aggressive caching. Results are cached for 2 hours with both browser and CDN caching enabled.
When using multiple filters, ensure values are properly URL-encoded, especially for filters with special characters or spaces.
