Cataas

How to Use This API

1. Random Cat Image

https://cataas.com/cat

Get a random cat image. The URL itself returns the image directly.

2. Cat with Custom Text

https://cataas.com/cat/says/hello%20world

Add any text caption to a random cat image. Text appears overlaid on the image.

3. Cat GIF

https://cataas.com/cat/gif

Returns a random cat GIF instead of a static image.

4. Cat by Tag

https://cataas.com/cat/white

Filter by tag — available tags include colors (white, orange, black), mood (sleepy, playful), and features (fluffy, cute, funny).

5. JavaScript — Random Cat with Message

async function displayRandomCat(tag, message) {
  const base = 'https://cataas.com';
  const path = tag
    ? `/cat/${encodeURIComponent(tag)}/says/${encodeURIComponent(message)}`
    : `/cat/says/${encodeURIComponent(message)}`;
  
  // Returns a cat image with your message
  const img = document.createElement('img');
  img.src = `${base}${path}`;
  img.alt = 'Random cat';
  img.style = 'max-width:400px;border-radius:8px;';
  document.body.appendChild(img);
}

displayRandomCat('orange', 'Purrfect!');

// Or just get the URL directly:
console.log('Random cat:', 'https://cataas.com/cat');
console.log('With text:', 'https://cataas.com/cat/sites/Hi');
console.log('GIF:', 'https://cataas.com/cat/gif');

6. Python — Download Cat Images

import requests
import shutil

def download_random_cat(filename='cat.jpg', tag=None, text=None):
    url = 'https://cataas.com/cat'
    if tag:
        url += f'/{tag}'
    if text:
        url += f'/says/{text}'
    
    with requests.get(url, stream=True) as r:
        r.raise_for_status()
        with open(filename, 'wb') as f:
            shutil.copyfileobj(r.raw, f)
    print(f'Saved cat to {filename}')

download_random_cat('my-cat.jpg', 'fluffy', 'Meow!')