CATAAS
Free · No API key · Open source

Cats,
from a simple URL.

CATAAS — Cat as a Service — serves random cat images and GIFs, with text, filters and tags. One link, one cat. That's it.

Try it nowSee the endpoints
$ curl https://cataas.com/cat -o cat.jpg
A random cat
Filter
Format
0
Cats served
$0
No subscription
0 keys
No sign-up required
100% cat
Zero dogs, promise
/ API

A few endpoints, plenty of possibilities.

/cat

A random cat, as an image.

Try it
/cat/:tag

A random cat matching a tag. Combine several with commas.

Try it
/cat/gif

A random animated cat, as a GIF.

Try it
/cat/says/:text

A random cat saying the text.

Try it
/cat/:tag/says/:text

A random cat with a tag, saying the text.

Try it
/cat/says/:text?fontSize=50&fontColor=red

Customize the text with fontSize and fontColor.

Try it
/cat?type=square

Image size: xsmall, small, medium or square.

Try it
/cat?filter=mono

Apply a filter: blur, mono, negate or custom.

Try it
/cat?filter=custom&r=7&g=12&b=50

Custom filter with brightness, lightness, saturation, hue, or r, g, b.

Try it
/cat?width=100&height=100

Resize with width and/or height.

Try it
/cat?html=true

Return an HTML page, handy for embedded previews.

Try it
/cat?json=true

Return the cat as a JSON object.

Try it
/avatar/:seed

Return a square cat avatar, always the same for a given seed.

Try it
/placeholder/:size

Return a cat cropped to the requested size (or a solid color with color), captioned WxH.

Try it
/api/cats?tags=cute

List cats as JSON (tags, skip, limit).

Try it
/api/tags

List all available tags as JSON.

Try it
More possibilities

Fonts, positions, fit, custom filters and more: every parameter is in the full documentation.

Read the documentation
/ Usage

Paste it anywhere.

An image tag is all you need. Combine text, size and filter right in the URL.

CATAAS can be used for testing, placeholders, monitoring, education… whatever you need.

<img src="https://cataas.com/cat/says/hello" alt="A cat saying hello"> /* Resize + filter */ https://cataas.com/cat?width=400&height=300&filter=mono /* JSON response */ https://cataas.com/cat?json=true /* Stable avatar per seed */ https://cataas.com/avatar/alice /* Placeholder at any size */ https://cataas.com/placeholder/600x400?format=webp
/ CLI

Cats in your terminal.

The CATAAS CLI shows cats straight in your terminal, with the same tags, text and filters as the API.

Full-resolution images on Kitty and iTerm2, colored half-blocks everywhere else, animated GIFs included.

View on GitHub
/* Install (Linux / macOS) */ curl -fsSL https://raw.githubusercontent.com/cataas/cli/main/install.sh | bash /* A random cat with tags */ cataas cute orange /* Text and filter */ cataas --says "Hello" --filter mono /* An animated cat */ cataas --gif /* List available tags */ cataas tags

Ready to add cats to your project?

Read the documentation