AniQuizAPI

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.

---

🚀 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.

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

{
  "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:

{
  "error": {
    "code": "INVALID_DIFFICULTY",
    "message": "Please use one of: easy, medium, hard."
  }
}

• HTTP status codes: 400, 404, 500
• Validation for missing/invalid params
• Graceful fallback if source API fails

---

🛠️ Installation

1. Clone this repo

git clone https://github.com/Shineii86/AniQuizAPI
cd AniQuizAPI

2. Install dependencies

npm install

3. Start development server

npm run dev

---

🌐 Deployment (Vercel Recommended)

One-click deploy with Vercel for instant API hosting.

• Fork this repo
• Connect it to Vercel
• Set up the project (no special env needed)
• Deploy 🎉

---

🪪 License

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 Built with ❤️ passion for Anime and Open Source.

---

📬 Support

• Issues: GitHub Issues

---

💕 Loved My Work?

🚨 Follow me on GitHub

⭐ Give a star to this project

---

☎️ Contact

For inquiries or collaborations

^{Copyright © 2025 Shinei Nouzen. All Rights Reserved}