Introduction
The Anime API provides a comprehensive set of endpoints for accessing anime information, including detailed metadata, search functionality, and random anime discovery. All endpoints implement Redis caching for optimal performance and rate limiting to prevent abuse.Base URL
All API requests should be made to:Available Endpoints
Get Animes (Full)
Retrieve a filtered list of animes with comprehensive data
Get Anime Details
Get detailed information about a specific anime by ID
Random Anime
Fetch a random anime for discovery
Common Features
Rate Limiting
All anime endpoints are protected by rate limiting middleware to prevent API abuse:- Default: 100 requests per 60 seconds
- Exceeded limits return
429 Too Many RequestswithRetry-Afterheader
Caching
Endpoints implement Redis caching with the following strategies:- GET /api/animes/full: 2-hour cache (7200 seconds)
- GET /api/animes/getAnime: 1-hour cache
- GET /api/animes/random: No persistent caching (always fresh)
Response Format
All endpoints follow a consistent response structure:Error Handling
Standardized error responses include:Error information object
Common Query Parameters
Many endpoints support these common parameters:Filter content based on parental control settings. Set to
false to disable filtering.Number of results to return per page
Page number for pagination
Available Filters
The API supports extensive filtering options:- genre_filter: Filter by anime genres (Action, Adventure, Comedy, etc.)
- type_filter: Filter by anime type (TV, Movie, OVA, ONA, etc.)
- studio_filter: Filter by animation studio
- score_filter: Filter by minimum score
- status_filter: Filter by airing status (Finished Airing, Currently Airing, etc.)
- year_filter: Filter by release year
- rating_filter: Filter by age rating (G, PG, PG-13, R, R+, Rx)
- season_filter: Filter by season (Winter, Spring, Summer, Fall)
- aired_day_filter: Filter by broadcast day
- order_by: Sort results (score, score_asc, title, title_asc)
Authentication
Anime API endpoints are publicly accessible and do not require authentication. However, rate limiting still applies based on IP address.Next Steps
Get Animes
Learn how to fetch filtered anime lists
Get Details
Retrieve detailed anime information