Random Quote API ✨

Free & beautiful REST API for hand-curated motivational, programming, life & wisdom quotes.
Built with FastAPI – automatic interactive docs, blazing fast, production-ready.

Why You'll Love It

• Instant inspiration – one endpoint, endless motivation
• Categories (motivational, programming, funny, wisdom...)
• Multiple quotes in one call
• Interactive docs – try it live with Swagger UI
• Free deploy ready (Render, Railway, Vercel Python...)
• Great for: GitHub README widgets, Discord/Telegram bots, daily quote apps, blogs, portfolios

Quick Start

git clone https://github.com/voidethic/Random-Quote-API.git
cd Random-Quote-API 

# Install
pip install -r requirements.txt

# Run locally
build.bat

Now open in your browser:

• http://localhost:8000/quote → one random quote
• http://localhost:8000/quote/5 → five random quotes
• http://localhost:8000/docs → beautiful interactive playground (Swagger UI)

📜 API Endpoints

Method	Endpoint	Description	Example Response Fields
GET	/	Welcome & API information	message, endpoints
GET	/quote	One random quote	quote, author, category
GET	/quote/{count}	Multiple random quotes (1–20)	quotes (array), count

🛠️ Deploy Free in 5 Minutes (Render.com Recommended)

1. Fork this repository
2. Go to https://render.com → New → Web Service → Connect your GitHub repo
3. Configure:
   • Runtime: Python
   • Build Command: pip install -r requirements.txt
   • Start Command: uvicorn main:app --host 0.0.0.0 --port $PORT
4. Click Deploy → you’ll get a live URL like:
   https://your-random-quote-api.onrender.com
5. Update this README with your live link!

🤝 Contributing

Love quotes? Want to make this project even better?

• Add more curated quotes to quotes.py
• Suggest or implement new features:
  • Search by author or category
  • Voting/rating system
  • Database support (SQLite/JSON file)
  • Rate limiting
  • Multiple categories filter

Steps:

1. Fork & clone the repo
2. Create your branch (git checkout -b feature/add-quotes)
3. Commit your changes
4. Push and open a Pull Request

Every great quote or improvement is welcome! 🌟

📄 License

MIT License — free to use, modify, and share.

---

If this API gave you even one good quote today — drop a ⭐ !
Your star helps others discover it 🚀