# Anime API > Search anime and manga, fetch full details — score, episodes or chapters, genres, studios, synopsis and artwork — and browse the top-ranked titles. Backed by the MyAnimeList catalog via Jikan. Great for anime trackers, recommendation engines, media discovery and fan apps. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/anime-api/..." ``` ## Pricing - **Free** (Free) — 5,000 calls/Mo, 5 req/s - **Basic** ($12/Mo) — 75,000 calls/Mo, 15 req/s - **Pro** ($39/Mo) — 300,000 calls/Mo, 30 req/s - **Mega** ($99/Mo) — 1,200,000 calls/Mo, 50 req/s ## Endpoints ### Anime #### `GET /v1/anime` — Anime details by id **Parameters:** - `id` (query, required, string) — MyAnimeList anime id Example: `1` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/anime-api/v1/anime?id=1" ``` **Response:** ```json { "data": { "url": "https://myanimelist.net/anime/1/Cowboy_Bebop", "rank": 48, "type": "TV", "year": 1998, "image": "https://cdn.myanimelist.net/images/anime/4/19644.jpg", "score": 8.75, "title": "Cowboy Bebop", "airing": false, "genres": [ "Action", "Award Winning", "Sci-Fi" ], "mal_id": 1, "rating": "R - 17+ (violence & profanity)", "season": "spring", "source": "Original", "status": "Finished Airing", "studios": [ "Sunrise" ], "duration": "24 min per ep", "episodes": 26, "synopsis": "Crime is timeless. By the year 2071, humanity has expanded across the galaxy, filling the surface of other planets with settlements like those on Earth. These new societies are plagued by murder, drug use, and theft, and intergalactic outlaws are hunted by a growing number of tough bounty hunters.\n\nSpike Spiegel and Jet Black pursue criminals throughout space to make a humble living. Beneath his goofy and aloof demeanor, Spike is haunted by the weight of his violent past. Meanwhile, Jet manages his own troubled memories while taking care of Spike and the Bebop, their ship. The duo is joined by the beautiful con artist Faye Valentine, odd child Edward Wong Hau Pepelu Tivrusky IV, and Ein, a bioengineered Welsh corgi.\n\nWhile developing bonds and working to catch a colorful cast of cr …(truncated, see openapi.json for full schema) ``` #### `GET /v1/anime/search` — Search anime **Parameters:** - `q` (query, required, string) — Search term Example: `naruto` - `limit` (query, optional, string) — Max 1-25 Example: `10` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/anime-api/v1/anime/search?q=naruto&limit=10" ``` **Response:** ```json { "data": { "count": 10, "query": "naruto", "results": [ { "url": "https://myanimelist.net/anime/20/Naruto", "rank": 730, "type": "TV", "year": 2002, "image": "https://cdn.myanimelist.net/images/anime/1141/142503.jpg", "score": 8.02, "title": "Naruto", "airing": false, "genres": [ "Action", "Adventure", "Fantasy" ], "mal_id": 20, "rating": "PG-13 - Teens 13 or older", "season": "fall", "source": "Manga", "status": "Finished Airing", "studios": [ "Studio Pierrot" ], "duration": "23 min per ep", "episodes": 220, "synopsis": "Twelve years ago, a colossal demon fox terrorized the world. During the monster's attack on the Hidden Leaf Village, the Hokage—the village's leader and most powerful ninja—sacrifices himself to seal the beast inside a newborn, relieving civilization from destruction while dooming the baby to a lonely life.\n\nNow, after years of being shunned and bullied, Naruto Uzumaki pesters the village with elaborate pranks and vandalism. Despite these antics, he works hard to achieve his dream: to become the Hokage and earn the ackn …(truncated, see openapi.json for full schema) ``` ### Manga #### `GET /v1/manga/search` — Search manga **Parameters:** - `q` (query, required, string) — Search term Example: `berserk` - `limit` (query, optional, string) — Max 1-25 Example: `10` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/anime-api/v1/manga/search?q=berserk&limit=10" ``` **Response:** ```json { "data": { "count": 10, "query": "berserk", "results": [ { "url": "https://myanimelist.net/manga/2/Berserk", "rank": 1, "type": "Manga", "year": 1989, "image": "https://cdn.myanimelist.net/images/manga/1/157897.jpg", "score": 9.46, "title": "Berserk", "genres": [ "Action", "Adventure", "Award Winning", "Drama", "Fantasy", "Horror" ], "mal_id": 2, "status": "Publishing", "authors": [ "Miura, Kentarou", "Studio Gaga" ], "volumes": null, "chapters": null, "synopsis": "Guts, a former mercenary now known as the Black Swordsman, is out for revenge. After a tumultuous childhood, he finally finds someone he respects and believes he can trust, only to have everything fall apart when this person takes away everything important to Guts for the purpose of fulfilling his own desires. Now marked for death, Guts becomes condemned to a fate in which he is relentlessly pursued by demonic beings.\n\nSetting out on a dreadful quest riddled with misfortune, Guts, armed with a massive sword and monstrous strength, will let nothing stop him, not eve …(truncated, see openapi.json for full schema) ``` ### Rankings #### `GET /v1/top` — Top-ranked titles **Parameters:** - `type` (query, optional, string) — anime or manga Example: `anime` - `limit` (query, optional, string) — Max 1-25 Example: `10` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/anime-api/v1/top?type=anime&limit=10" ``` **Response:** ```json { "data": { "type": "anime", "count": 10, "results": [ { "url": "https://myanimelist.net/anime/52991/Sousou_no_Frieren", "rank": 1, "type": "TV", "year": 2023, "image": "https://cdn.myanimelist.net/images/anime/1015/138006.jpg", "score": 9.26, "title": "Sousou no Frieren", "airing": false, "genres": [ "Adventure", "Award Winning", "Drama", "Fantasy" ], "mal_id": 52991, "rating": "PG-13 - Teens 13 or older", "season": "fall", "source": "Manga", "status": "Finished Airing", "studios": [ "Madhouse" ], "duration": "24 min per ep", "episodes": 28, "synopsis": "During their decade-long quest to defeat the Demon King, the members of the hero's party—Himmel himself, the priest Heiter, the dwarf warrior Eisen, and the elven mage Frieren—forge bonds through adventures and battles, creating unforgettable precious memories for most of them.\n\nHowever, the time that Frieren spends with her comrades is equivalent to merely a fraction of her life, which has lasted over a thousand years. When the party disbands after their victory, Fri …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/anime-api OpenAPI spec: https://www.oanor.com/api/anime-api/openapi.json