Random cat memes API. 1000 memes, zero dogs. Built with FastAPI.

🔗 Live API: https://catmemesapi.onrender.com

📖 Interactive Docs: https://catmemesapi.onrender.com/docs

...

NEVER open the memes/ folder in your browser or file explorer!

• Folder contains 1000+ JPG files (85 MB total)
• Your browser will crash or freeze for minutes
• Your file explorer might stop responding
• Only access memes through the API endpoints

✅ Correct way: Use /meme/search?limit=5 or /meme/{meme_id}
❌ Wrong way: Clicking on memes/ folder in GitHub web interface

Your RAM will thank you.

CatMemeAPI returns random cat memes with metadata (width, height). All memes are curated and sorted.

• 🐱 1000 cat memes
• 🖼️ Returns image dimensions (width, height)
• 📦 Single endpoint for random memes
• ⚡ FastAPI + PIL
• ⚠️ Safe API access only (no browser folder browsing!)

pip install -r requirements.txt

Start the server:

uvicorn main:app --host 0.0.0.0 --port 8000

[
  {
    "id": 42,
    "url": "http://localhost:8000/meme/42",
    "width": 640,
    "height": 480
  },
  {
    "id": 777,
    "url": "http://localhost:8000/meme/777",
    "width": 800,
    "height": 600
  }
]

• Python 3.x
• FastAPI
• uvicorn
• Pillow

• FelineFantasy
• License: MIT