Package: anime-api
The Anime API ProjectThe Anime API is a collection of wrappers for different types of free anime-related APIs.Join our Discord server.Why anime-api (and not others)?There are several reasons why would you prefer using anime-api:Intuitive: anime-api is designed to be intuitive. Supports autocompletion everywhere.Complete: Every actively supported API has no feature left apart.Simple: Get all the anime information you want with a single line of code.Legal: I shouldn't need to say this, but all the APIs are legal. (no free streaming services/others)Actively supported: Get new releases (with new API wrappers) every now and then.InstallationUsing Poetry:poetry add anime-apiUsing pip:pip install anime-apiDocumentationThe full documentation can be foundhere.APIsThese are the currently supported and planned to add support for APIs:NameAPI DocumentationAvailableAnime Facts Rest APIDocumentation✅Trace.moeDocumentation✅AnimechanDocumentation✅Jikan (MyAnimeList)Documentation❌Waifu PicsDocumentation✅Studio Ghibli APIDocumentation✅KitsuDocumentation❌AniListDocumentation❌AniDBDocumentation❌KyokoDocumentation✅AnimuDocumentation✅AnisearchDocumentation❌Anime News NetworkDocumentation❌Notify.moe (Anime Notifier)Documentation❌HmtaiDocumentation✅Nekos.lifeDocumentation✅NekoBotDocumentation✅Neko-LoveDocumentation✅Nekos.bestDocumentation✅Nekos.moeDocumentation✅ShikimoriDocumentation❌MangaDexDocumentation❌DanbooruDocumentation❌YandereDocumentation❌KonachanDocumentation❌Waifu.imDocumentation✅CatboysDocumentation✅Anime Character DatabaseDocumentation❌Nekos APIDocumentation✅APIs by featureYou know what you want to do, but have no idea of what API will work for you? This list orders the APIs by features. See which fits you best!ImagesNekos API:Thousands of anime imagesLots of image metadataActively developed (frequent new features, images, categories, and more)100% open-sourcev2.0.0in its wayOfficial Python wrapper (this!)Completely freeAnimu:Tons of anime gifs and imagesGet reaction gifs from +60 different categoriesCompletely freeHmtai:Tons of anime gifs and imagesSFW and NSFW imagesGet random images from +70 different categoriesCompletely freeNekos.lifeLots of different neko picsGet random neko images from +20 different categoriesCompletely freeWaifu.picsLots of different waifu imagesGet random images from +30 categoriesSFW and NSFW imagesGet 30 different images with a single API callGet a different image every timeCompletely freeNekoBotLots of different neko imagesImage generation (memes, ships, etc.)Get random images from 30 different categoriesSFW and NSFW imagesCompletely freeNekos.moeLots of different neko imagesAdvanced image searchUpload imagesLike and favorite imagesSFW and NSFW imagesGet any amount of random imagesCompletely freeNekos.bestLots of different neko imagesGet random images from +35 different categoriesGet many random images with a single API callSearch for images by category, format and moreFully SFW99.9% uptimeFast response timesGet all image's sourceCompletely freeFactsAnime Facts Rest API:Lots of different anime factsGet random fact from an animeSave fact ID and refetch the fact laterGet a list of all available animesCompletely freeAnimu:Lots of anime factsGet random anime factsCompletely freeKyoko:Lots of different anime factsGet random reaction gifs from 3 different categoriesCompletely freeNekos.lifeLots of different anime factsGet random anime factsCompletely freeQuotesAnimechan:Lots of different quotes from a large list of characters and animesGet random anime quotesGet 10 random anime quotes with a single api callSearch quotes by character name or anime titleGet a list of all available animesCompletely freeAnimu:Lots of different anime quotes with information about who said them and whereGet random anime quotesCompletely free.Kyoko:Lots of different anime quotesGet random quotes with information about who said them and whereCompletely freeWaifusAnimu:Lots of different waifus from Video Games, Animes, Movies and more.Get random waifus with their statistics, source, many images and more.Completely freeAnimesAnime Facts Rest API:Get a list of lots of snake-case anime titles with their images and facts about themCompletely freeAnimechan:Get a list of lots of anime titles with random quotes from themCompletely freeStudio Ghibli APIGet Studio Ghibli animes with information such as director, producer, etc.Dynamic loading supportGet super specific anime details such as veichles, locations, people, and species.Completely freeEntertainmentNekos.lifeGet an answer from an 8ball with an aditional image of an 8ball showing the answer.Get a random "why?" questionCompletely freeUtilitiesTrace.moeFind an anime from a screenshot with information about the specific anime, episode and time of the screenshot.Completely freeNekos.lifeGet a random cat text emojiGenerate random namesOwoify text (hello=>hewwo)Mark text as spoiler (hello=>||hello||) (API endpoint is currently bugged)Completely freeAnimu:Generate a secure passwordCompletely freeAPIs that will not be supportedIllegal anime streaming servicesNon anime-related APIsAPIs that are not APIs (i.e. web scrapping)ContributingRead the following before contributing:Adding an APIIf you want to add an API to the list, please make sure that:The API is free to useThe API is anime-related (or manga-related)You follow the same architecture as the other API wrappersDocument the code you writeAdd all the necessary tests to thetestsfolderFixing an API wrapperBefore fixing an API wrapper, please make sure that:The bug is not being fixed in another PRThe bug is actually a bug and not a feature (xd)The bug is not a bug from the API itselfYou have created an issue. If you have not created an issue, please create one before fixing the bug.Requesting a new APIIf you want to request a new API, please make sure that:The API is free to useThe API is anime-related (or manga-related)It is not already in the list (wether available or not)Once you have checked this, please create an issue with the following information:The name of the APIThe API docs linkList of all the features the API hasMantainersNekidev