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
JPG · PNG · GIF
Available formats
/ 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
/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

Ready to add cats to your project?

Read the documentation