API for getting random facts and information about cat breeds in English.

CatFactsAPI is a simple and lightweight REST API built with FastAPI that returns random facts about cats and breed information. Perfect for educational projects, test applications, or just for fun.

• ✅ Random cat facts
• ✅ 100+ unique facts in the database
• ✅ Cat breed information
• ✅ Get fact or breed by ID
• ✅ Fact length information
• ✅ Automatic documentation via Swagger UI
• ✅ English-language API

• Python 3.8+
• pip

1. Clone the repository:

git clone https://github.com/FelineFantasy/CatFactsAPI
cd CatFactsAPI

2. Install dependencies:

pip install -r requirements.txt

Start the server using Uvicorn:

uvicorn main:app --reload

The server will be available at: http://localhost:8000

The API is already deployed and available at: https://catfactsapi.onrender.com

Interactive documentation is available at:

• Swagger UI: https://catfactsapi.onrender.com/docs
• ReDoc: https://catfactsapi.onrender.com/redoc

When running locally:

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

# Random fact
curl https://catfactsapi.onrender.com/fact

# Random breed
curl https://catfactsapi.onrender.com/breed

# 3 random facts
curl https://catfactsapi.onrender.com/facts?limit=3

# Fact by ID
curl https://catfactsapi.onrender.com/fact/42

# Breed by ID
curl https://catfactsapi.onrender.com/breed/5

import requests

# Random fact
response = requests.get("https://catfactsapi.onrender.com/fact")
data = response.json()
print(data["fact"])

# Random breed
response = requests.get("https://catfactsapi.onrender.com/breed")
data = response.json()
print(data["breed"], data["country"])

// Random fact
fetch('https://catfactsapi.onrender.com/fact')
  .then(response => response.json())
  .then(data => console.log(data.fact));

// Random breed
fetch('https://catfactsapi.onrender.com/breed')
  .then(response => response.json())
  .then(data => console.log(data.breed, data.country));

CatFactsAPI/
├── main.py           # Main application file
├── facts.json        # Cat facts database (100+)
├── breeds.json       # Cat breeds database (10+)
├── requirements.txt  # Project dependencies
└── README.md         # Documentation

• FastAPI — Modern web framework for building APIs
• Uvicorn — ASGI server
• Render — Hosting (live version)

• FelineFantasy
• License: MIT

• API: https://catfactsapi.onrender.com
• Documentation: https://catfactsapi.onrender.com/docs
• GitHub: https://github.com/FelineFantasy/CatFactsAPI

Made with ❤️ for cat lovers