🐱

Face Cats as a Service

The purr-fect API for cat faces, ASCII art, and feline wisdom

(=¬ω¬=)

sleepy

💡 A cat's purr vibrates at 25-150 Hz, which can promote healing.

// Endpoints

GET /api/cat

Random cat face with mood and fun fact

→ try it

GET /api/cat?count=5

Get multiple cat faces at once (max 50)

→ try it

GET /api/cat/:mood

Cat face by mood — happy, sad, angry, sleepy, surprised, love, cool, mischievous

→ try /api/cat/happy

GET /api/cat/ascii

Random ASCII art cat. Add ?format=text for plain text

→ try it

GET /api/moods

List all available moods and face counts

→ try it

GET /api/fact

Random cat fact to brighten your day

→ try it

GET /api/stats

API statistics — total faces, moods, requests served

→ try it

// Available Moods

😺 happy 😿 sad 😾 angry 😴 sleepy 🙀 surprised 😻 love 😎 cool 😼 mischievous

// Quick Start

// Fetch a random cat face
const res = await fetch('/api/cat');
const data = await res.json();

console.log(data.face);  // (=^・ω・^=)
console.log(data.mood);  // "happy"
console.log(data.fact);  // "Cats sleep 12-16 hours..."

// Get 5 sleepy cats
const sleepy = await fetch('/api/cat/sleepy?count=5');

// ASCII art cat (plain text)
const ascii = await fetch('/api/cat/ascii?format=text');
console.log(await ascii.text());
      

// ASCII Preview

/\_/\ ( ^.^ ) > ♡ < /| |\ (_| |_)