Anime Map API Documentation
This API route allows you to map anime IDs from our database to other popular anime databases such as AniList and MyAnimeList. By using this route, you can retrieve the corresponding anime ID from these external databases, facilitating data integration and synchronization across different platforms.
Base URL
/api/anime-mapAuthentication
Each request must include a valid key parameter. Unauthorized requests will receive a 401 Unauthorized response. You can obtain an API key by contacting us at [email protected]. You must mention a legitimate justification for using the API key in your email.
Rate Limiting
- Each user is limited to 40 requests per minute.
- Exceeding the limit returns a 429 Too Many Requests response.
1. Get Paginated Anime List
Endpoint
GET /api/anime-mapQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
page | Number | No | The page number (default: 1) |
key | String | Yes | API authentication key |
Response
Success (200 OK)
json
{
"page": 1,
"totalPages": 10,
"isNextPage": true,
"results": [
{
"id": "6755479600421d2345059887",
"idAL": 16498,
"idMal": 16498,
"idAniDB": 9541,
"idZoro": "attack-on-titan-112",
"idGogo": "shingeki-no-kyojin",
"idGogoDub": "shingeki-no-kyojin-dub",
"episodesStats": {
"sub": 25,
"dub": 25,
"total": 25
}
}
]
}Errors
| Status Code | Message | Description |
|---|---|---|
| 401 | { "error": "Unauthorized" } | Missing or invalid API key |
| 429 | { "error": "Too Many Requests" } | Rate limit exceeded |
| 500 | { "error": "Internal Server Error" } | Server-side error |
2. Get Anime by ID
Endpoint
GET /api/anime-map/animeQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | String | No | Anime ID in the database |
idAL | Number | No | AniList ID |
idMal | Number | No | MyAnimeList ID |
Key | String | Yes | API authentication key |
At least one of id, idAL, or idMal must be provided.
Response
Success (200 OK)
json
{
"id": "6755479600421d2345059887",
"idAL": 16498,
"idMal": 16498,
"idAniDB": 9541,
"idZoro": "attack-on-titan-112",
"idGogo": "shingeki-no-kyojin",
"idGogoDub": "shingeki-no-kyojin-dub",
"episodesStats": {
"sub": 25,
"dub": 25,
"total": 25
}
}Errors
| Status Code | Message | Description |
|---|---|---|
| 400 | { "error": "Missing id" } | No valid anime ID provided |
| 401 | { "error": "Unauthorized" } | Missing or invalid API key |
| 404 | { "error": "Anime not found" } | Anime not found in the database |
| 429 | { "error": "Too Many Requests" } | Rate limit exceeded |
| 500 | { "error": "Internal Server Error" } | Server-side error |