https://github.com/shineii86/aniquizapi
A Smart, Open-Source Anime Quiz API with auto-generated trivia, difficulty levels, image & quote questions.
https://github.com/shineii86/aniquizapi
anime anime-api anime-downloader anime-quiz anime-scraper anime-search anime-website animes quiz quiz-api
Last synced: 4 days ago
JSON representation
A Smart, Open-Source Anime Quiz API with auto-generated trivia, difficulty levels, image & quote questions.
- Host: GitHub
- URL: https://github.com/shineii86/aniquizapi
- Owner: Shineii86
- License: mit
- Created: 2025-08-02T01:27:41.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-08-02T02:11:02.000Z (2 months ago)
- Last Synced: 2025-08-16T01:50:11.476Z (about 2 months ago)
- Topics: anime, anime-api, anime-downloader, anime-quiz, anime-scraper, anime-search, anime-website, animes, quiz, quiz-api
- Language: HTML
- Homepage: https://aniquizapi.vercel.app
- Size: 37.1 KB
- Stars: 0
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# [AniQuizAPI](https://github.com/AniPulse)
**The Ultimate Smart Anime Quiz REST API**
Auto-generated trivia questions — by difficulty, image, quote, or random — with robust error handling and personalized watermark in every response.
 [](https://github.com/Shineii86/AniQuizAPI/stargazers) [](https://github.com/Shineii86/AniQuizAPI/fork)
[](https://aniquiz.vercel.app)
---
## 🚀 Overview
AniQuiz API is an open-source anime quiz API that provides:
- 🎯 Trivia questions (Easy / Medium / Hard)
- 🖼️ Image-based quizzes (guess anime from images)
- 🗣️ Quote-based quizzes (guess the anime from quotes)
- 🔀 Random question mixing
- 💡 Advanced error handling
- 🖋️ Creator watermark in every response
- 🌐 Deployed on Vercel for free public usage
---
## 🌟 Features
- ✅ Difficulty Tags: `Easy`, `Medium`, `Hard`
- ✅ Auto-generated & AI-enriched questions
- ✅ Random, image, and quote quiz endpoints
- ✅ Fully RESTful API
- ✅ Timestamp & Creator Credit in response
- ✅ Ready to deploy on GitHub + Vercel
- ✅ Free & Open Source
---
## 📚 API Documentation
### 🔹 `/api/quiz?difficulty=easy|medium|hard`
Get a trivia question by difficulty level.
```bash
GET /api/quiz?difficulty=medium
````
### 🔹 `/api/image-quiz`
Returns a question with an anime image. User must guess the anime title.
### 🔹 `/api/quote-quiz`
Returns a famous anime quote and asks to guess the anime or character.
### 🔹 `/api/random`
Returns a completely randomized question from any mode (trivia, image, or quote).
---
## 🧠 Example Response
```json
{
"question": "Who is the main character of the anime Naruto?",
"options": ["Sasuke", "Itachi", "Naruto", "Sakura"],
"answer": "Naruto",
"difficulty": "Easy",
"type": "quiz",
"creator": "Shinei Nouzen",
"github": "https://github.com/Shineii86",
"telegram": "https://telegram.me/Shineii86",
"message": "Build with ❤️ by Shinei Nouzen",
"timestamp": "India Date & Time 12H Format"
}
```
---
## ❗ Error Handling
All endpoints return well-formatted JSON errors:
```json
{
"error": {
"code": "INVALID_DIFFICULTY",
"message": "Please use one of: easy, medium, hard."
}
}
```
- [x] HTTP status codes: `400`, `404`, `500`
- [x] Validation for missing/invalid params
- [x] Graceful fallback if source API fails
---
## 🛠️ Installation
### 1. Clone this repo
```bash
git clone https://github.com/Shineii86/AniQuizAPI
cd AniQuizAPI
```
### 2. Install dependencies
```bash
npm install
```
### 3. Start development server
```bash
npm run dev
```
---
## 🌐 Deployment (Vercel Recommended)
> One-click deploy with Vercel for instant API hosting.
* Fork this repo
* Connect it to [Vercel](https://vercel.com)
* Set up the project (no special env needed)
* Deploy 🎉
---
## 🪪 License
```json
This project is licensed under the *MIT License*.
Feel free to use, remix, and share it with proper credits.
```
---
## 👤 Credits
> Project created by [**Shinei Nouzen**](https://github.com/Shineii86)
> Built with ❤️ passion for Anime and Open Source.
---
## 📬 Support
* Issues: [GitHub Issues](https://github.com/Shineii86/AniQuizAPI/issues)
---
## 💕 Loved My Work?
🚨 [Follow me on GitHub](https://github.com/Shineii86/Shineii86)
⭐ [Give a star to this project](https://github.com/Shineii86/AniQuizAPI/)
---
## ☎️ Contact
*For inquiries or collaborations*
[](https://telegram.me/Shineii86 "Contact on Telegram")
[](https://instagram.com/ikx7.a "Follow on Instagram")
[](https://pinterest.com/ikx7a "Follow on Pinterest")
[](mailto:ikx7a@hotmail.com "Send an Email")
Copyright © 2025 Shinei Nouzen.
All Rights Reserved