Docs
Open Lodol
DocumentationIntegrationsAPI

CATAAS

App · Images & Design · 6 actions

Pull cat pictures and GIFs from CATAAS (Cat as a service), a free library of about 2,000 cats tagged by the people who shared them. Get a random cat or one with the tags you name (cute, orange, sleeping), make a cat say something in a meme-style caption, and resize, crop, blur or recolour it on the way. Every cat comes with a link that always shows that same picture, ready for a chat message or an email, and can be saved as a file to attach. No account or API key required.

Actions

ActionWhat it does
Count catsCount the cats in the library, or only those with the tags you name: the check before asking for a cat by tag, which fails when no cat has them.
Get a cat by idGet one particular cat by its id: its tags, its type and when it was added, with a link to its picture at the size and with the effects you ask for, and the picture as a file if you want it.
Get a random catGet a random cat picture, or one tagged the way you ask (cute, orange, sleeping), with a link that always shows that same cat.
List catsList the cats in the library with their ids, tags and links: all of them, or only those with the tags you name.
List tagsList the tags the library's cats carry, spelled exactly as the other actions match them, or only those containing some text.
Make a cat say somethingPut your words on a cat picture as a meme-style caption: a random cat, one with the tags you ask for, or a particular cat by its id.

Count cats

Count the cats in the library, or only those with the tags you name: the check before asking for a cat by tag, which fails when no cat has them. No API key required.

Inputs

Tagstagstext
Optional. Count only the cats with these tags. Separate several with commas; a cat must carry every one. Tags match exactly, capitals included, so run List tags for the library's own spelling.

Outputs

countnumber
How many cats match.
tagslist
The tags the cats were counted by, if any.
Example output
{
  "count": 1987,
  "tags": []
}

Get a cat by id

Get one particular cat by its id: its tags, its type and when it was added, with a link to its picture at the size and with the effects you ask for, and the picture as a file if you want it. No API key required.

Inputs

Cat idcat_idtextRequired
The id of the cat to get. Every action that returns a cat reports its id, and a CATAAS link to the cat works too.
Sizesizetext
Optional. One of CATAAS's own sizes. Original size by default. Square crops to 200 x 200; the others set the width and keep the cat's proportions. For any other size, leave this and set Width and Height.One of: original (Original size), square (Square, 200 x 200), medium (Medium, 400 wide), small (Small, 300 wide), xsmall (Extra small, 100 wide). Default: original.
Widthwidthnumber
Optional. The width in pixels, 1 to 1000, the most CATAAS draws. Alone, it keeps the cat's proportions; with a height too, Fit decides how the cat fills that box.From 1 to 1000.
Heightheightnumber
Optional. The height in pixels, 1 to 1000, the most CATAAS draws. Alone, it keeps the cat's proportions; with a width too, Fit decides how the cat fills that box.From 1 to 1000.
Fitfittext
Optional. How the cat fills a box set by both Width and Height: crop to fill it (the default), fit inside it with black bars, stretch to it, shrink to fit inside it without bars, or grow to cover it without cropping.One of: cover (Crop to fill the size), contain (Fit inside, with black bars), fill (Stretch to the size), inside (Shrink to fit inside, no bars), outside (Grow to cover the size, no crop). Default: cover.
Crop frompositiontext
Optional. Which part of the cat to keep when it is cropped or barred to fit a box. The center by default; choose Top to keep a cat's head in a wide crop.One of: center, top, right top (Top right), right, right bottom (Bottom right), bottom, left bottom (Bottom left), left, left top (Top left). Default: center.
Filterfiltertext
Optional. Black and white, or a negative. None by default. Cannot be combined with the adjustments below; for black and white with other adjustments, set Saturation to 0 instead.One of: none, mono (Black and white), negate (Negative). Default: none.
Blurblurnumber
Optional. How much to blur the picture, from 1 (a light softening) to 1000. Around 10 is heavy. Leave empty or 0 for a sharp picture.From 0 to 1000.
Brightnessbrightnessnumber
Optional. Multiplies the brightness: 1 leaves it as it is, 0.5 halves it, 1.5 is half as bright again.At least 0.
Saturationsaturationnumber
Optional. Multiplies the colour: 1 leaves it as it is, 0 turns the picture black and white, 2 makes it twice as vivid.At least 0.
Hue shifthuenumber
Optional. Turns every colour round the colour wheel by this many degrees, -360 to 360: 180 makes an orange cat blue.From -360 to 360.
Lightnesslightnessnumber
Optional. Adds to the lightness, -100 to 100: 20 lifts the whole picture towards white, -20 pushes it towards black.From -100 to 100.
Tinttint_colortext
Optional. A colour to tint the picture with, keeping its light and dark: a colour name such as 'orange', a hex code such as '#3366FF', or red, green and blue such as '255, 136, 0'.
Also save the picture as a filesave_as_filetrue/false
Off by default, because the link is all a chat message, an email or a web page needs. Turn it on when a later step needs the file itself: attaching it to an email, uploading it to storage, or posting it as a file.Default: false.

Outputs

catobject
One cat, and everything CATAAS records about it.
content_typetext
The saved file's type, e.g. image/jpeg or image/gif, or '' when not saved.
document_reftext
The saved file's document reference, or '' when not saved.
documentslist
The saved picture as a document, ready to attach to a later step. Empty when it was not saved.
file_size_bytesnumber
The saved file's size in bytes, or 0 when not saved.
file_urltext
A URL that serves the saved file, or '' when not saved.
image_tagtext
The same link as an HTML <img> tag, with alt text, for a step that writes an email or a page.
saved_as_filetrue/false
True when the picture was also saved as a file (Also save the picture as a file). The file fields below are empty otherwise.
urltext
A link to this exact picture, at the size and with the effects asked for. It always shows the same cat, so it can go straight into a chat message, an email or a web page.
Example output
{
  "cat": {
    "created_at": "2016-04-13T14:20:46.638000+00:00",
    "id": "Ybl50EQXvmgtCHSl",
    "is_gif": false,
    "mimetype": "image/jpeg",
    "size_bytes": null,
    "tags": [
      "cute",
      "orange"
    ],
    "url": "https://cataas.com/cat/Ybl50EQXvmgtCHSl"
  },
  "content_type": "",
  "document_ref": "",
  "documents": [],
  "file_size_bytes": 0,
  "file_url": "",
  "image_tag": "<img src=\"https://cataas.com/cat/Ybl50EQXvmgtCHSl?type=square\" alt=\"A cat (cute, orange)\" width=\"200\" height=\"200\">",
  "saved_as_file": false,
  "url": "https://cataas.com/cat/Ybl50EQXvmgtCHSl?type=square"
}

Get a random cat

Get a random cat picture, or one tagged the way you ask (cute, orange, sleeping), with a link that always shows that same cat. Resize it, crop it, blur it or recolour it on the way, and save it as a file to attach. No API key required.

Inputs

Tagstagstext
Optional. Only cats with these tags. Separate several with commas; a cat must carry every one. Tags match exactly, capitals included, so run List tags for the library's own spelling.
GIFs onlygiftrue/false
Optional. Pick from the GIFs, most of them animated: the cats tagged 'gif'. Off by default, and then a cat picked with no tags is never a GIF, though one picked by tag can be.Default: false.
Sizesizetext
Optional. One of CATAAS's own sizes. Original size by default. Square crops to 200 x 200; the others set the width and keep the cat's proportions. For any other size, leave this and set Width and Height.One of: original (Original size), square (Square, 200 x 200), medium (Medium, 400 wide), small (Small, 300 wide), xsmall (Extra small, 100 wide). Default: original.
Widthwidthnumber
Optional. The width in pixels, 1 to 1000, the most CATAAS draws. Alone, it keeps the cat's proportions; with a height too, Fit decides how the cat fills that box.From 1 to 1000.
Heightheightnumber
Optional. The height in pixels, 1 to 1000, the most CATAAS draws. Alone, it keeps the cat's proportions; with a width too, Fit decides how the cat fills that box.From 1 to 1000.
Fitfittext
Optional. How the cat fills a box set by both Width and Height: crop to fill it (the default), fit inside it with black bars, stretch to it, shrink to fit inside it without bars, or grow to cover it without cropping.One of: cover (Crop to fill the size), contain (Fit inside, with black bars), fill (Stretch to the size), inside (Shrink to fit inside, no bars), outside (Grow to cover the size, no crop). Default: cover.
Crop frompositiontext
Optional. Which part of the cat to keep when it is cropped or barred to fit a box. The center by default; choose Top to keep a cat's head in a wide crop.One of: center, top, right top (Top right), right, right bottom (Bottom right), bottom, left bottom (Bottom left), left, left top (Top left). Default: center.
Filterfiltertext
Optional. Black and white, or a negative. None by default. Cannot be combined with the adjustments below; for black and white with other adjustments, set Saturation to 0 instead.One of: none, mono (Black and white), negate (Negative). Default: none.
Blurblurnumber
Optional. How much to blur the picture, from 1 (a light softening) to 1000. Around 10 is heavy. Leave empty or 0 for a sharp picture.From 0 to 1000.
Brightnessbrightnessnumber
Optional. Multiplies the brightness: 1 leaves it as it is, 0.5 halves it, 1.5 is half as bright again.At least 0.
Saturationsaturationnumber
Optional. Multiplies the colour: 1 leaves it as it is, 0 turns the picture black and white, 2 makes it twice as vivid.At least 0.
Hue shifthuenumber
Optional. Turns every colour round the colour wheel by this many degrees, -360 to 360: 180 makes an orange cat blue.From -360 to 360.
Lightnesslightnessnumber
Optional. Adds to the lightness, -100 to 100: 20 lifts the whole picture towards white, -20 pushes it towards black.From -100 to 100.
Tinttint_colortext
Optional. A colour to tint the picture with, keeping its light and dark: a colour name such as 'orange', a hex code such as '#3366FF', or red, green and blue such as '255, 136, 0'.
Also save the picture as a filesave_as_filetrue/false
Off by default, because the link is all a chat message, an email or a web page needs. Turn it on when a later step needs the file itself: attaching it to an email, uploading it to storage, or posting it as a file.Default: false.

Outputs

catobject
One cat, and everything CATAAS records about it.
content_typetext
The saved file's type, e.g. image/jpeg or image/gif, or '' when not saved.
document_reftext
The saved file's document reference, or '' when not saved.
documentslist
The saved picture as a document, ready to attach to a later step. Empty when it was not saved.
file_size_bytesnumber
The saved file's size in bytes, or 0 when not saved.
file_urltext
A URL that serves the saved file, or '' when not saved.
image_tagtext
The same link as an HTML <img> tag, with alt text, for a step that writes an email or a page.
saved_as_filetrue/false
True when the picture was also saved as a file (Also save the picture as a file). The file fields below are empty otherwise.
urltext
A link to this exact picture, at the size and with the effects asked for. It always shows the same cat, so it can go straight into a chat message, an email or a web page.
Example output
{
  "cat": {
    "created_at": "2016-04-13T14:20:46.638000+00:00",
    "id": "Ybl50EQXvmgtCHSl",
    "is_gif": false,
    "mimetype": "image/jpeg",
    "size_bytes": null,
    "tags": [
      "cute",
      "orange"
    ],
    "url": "https://cataas.com/cat/Ybl50EQXvmgtCHSl"
  },
  "content_type": "",
  "document_ref": "",
  "documents": [],
  "file_size_bytes": 0,
  "file_url": "",
  "image_tag": "<img src=\"https://cataas.com/cat/Ybl50EQXvmgtCHSl\" alt=\"A cat (cute, orange)\">",
  "saved_as_file": false,
  "url": "https://cataas.com/cat/Ybl50EQXvmgtCHSl"
}

List cats

List the cats in the library with their ids, tags and links: all of them, or only those with the tags you name. CATAAS lists them in order of id, which is no particular order. Page through with Skip. No API key required.

Inputs

Tagstagstext
Optional. Only cats with these tags. Separate several with commas; a cat must carry every one. Tags match exactly, capitals included, so run List tags for the library's own spelling.
Number of catslimitnumber
Optional. How many cats to return, 1 to 1000. 10 by default.From 1 to 1000. Default: 10.
Skipskipnumber
Optional. How many cats to skip first, for the next page: pass the next skip the previous run reported. 0 by default.At least 0. Default: 0.

Outputs

catslist
The cats on this page, in order of id.
countnumber
How many cats are on this page.
has_moretrue/false
True when the page came back full, so there are probably more cats to list.
next_skipnumber
The Skip to pass for the next page. Null when this was the last one.
tagslist
The tags the cats were filtered by, if any.
Example output
{
  "cats": [
    {
      "created_at": "2016-10-09T12:51:24.421000+00:00",
      "id": "gjlDmSEsKJFyk0Zz",
      "is_gif": false,
      "mimetype": "image/jpeg",
      "size_bytes": null,
      "tags": [
        "cute",
        "sleeping"
      ],
      "url": "https://cataas.com/cat/gjlDmSEsKJFyk0Zz"
    }
  ],
  "count": 1,
  "has_more": false,
  "next_skip": null,
  "tags": [
    "cute"
  ]
}

List tags

List the tags the library's cats carry, spelled exactly as the other actions match them, or only those containing some text. Use it to find the tag for the cats you want. No API key required.

Inputs

Containingsearchtext
Optional. Only the tags that contain this text, in any case: 'orange' finds 'orange' and 'Orange cat'. Leave blank for every tag.

Outputs

countnumber
How many tags came back.
searchtext
The text the tags were filtered by. Null when every tag was asked for.
tagslist
The tags, sorted the way CATAAS sorts them, character by character: 'Cute' comes before 'cute', and both are separate tags.
totalnumber
How many tags the library has in all.
Example output
{
  "count": 2,
  "search": "orange",
  "tags": [
    "orange",
    "orange cat"
  ],
  "total": 734
}

Make a cat say something

Put your words on a cat picture as a meme-style caption: a random cat, one with the tags you ask for, or a particular cat by its id. Choose the font, size and colours, resize and recolour the cat, and get a link to share or a file to attach. No API key required.

Inputs

What the cat saystexttextRequired
The caption, up to 200 characters. It is drawn on one line across the bottom of the picture and is not wrapped, so keep it short, or make the font smaller, for it to fit.
Cat idcat_idtext
Optional. The id of the cat to caption. Leave blank for a random cat. Every action that returns a cat reports its id, and a CATAAS link to the cat works too.
Tagstagstext
Optional. Caption a random cat with these tags. Separate several with commas; a cat must carry every one. Tags match exactly, capitals included, so run List tags for the library's own spelling.
GIFs onlygiftrue/false
Optional. Pick from the GIFs, most of them animated: the cats tagged 'gif'. Off by default, and then a cat picked with no tags is never a GIF, though one picked by tag can be.Default: false.
Fontfonttext
Optional. The caption's font. Impact by default.One of: Impact, Andale Mono, Arial, Arial Black, Comic Sans MS, Courier New, Georgia, Times New Roman, Verdana, Webdings. Default: Impact.
Font sizefont_sizenumber
Optional. The caption's height in pixels. 30 by default, which suits a picture about 400 pixels wide; go larger on a big picture.From 1 to 500. Default: 30.
Text colourfont_colortext
Optional. The caption's colour: a colour name or a hex code. White by default, over a thin black shadow, which reads on most cats.Default: white.
Text backgroundfont_backgroundtext
Optional. A colour for a band across the bottom fifth of the picture, behind the caption, so it stands out on a busy picture. None by default.Default: none.
Sizesizetext
Optional. One of CATAAS's own sizes. Original size by default. Square crops to 200 x 200; the others set the width and keep the cat's proportions. For any other size, leave this and set Width and Height.One of: original (Original size), square (Square, 200 x 200), medium (Medium, 400 wide), small (Small, 300 wide), xsmall (Extra small, 100 wide). Default: original.
Widthwidthnumber
Optional. The width in pixels, 1 to 1000, the most CATAAS draws. Alone, it keeps the cat's proportions; with a height too, Fit decides how the cat fills that box.From 1 to 1000.
Heightheightnumber
Optional. The height in pixels, 1 to 1000, the most CATAAS draws. Alone, it keeps the cat's proportions; with a width too, Fit decides how the cat fills that box.From 1 to 1000.
Fitfittext
Optional. How the cat fills a box set by both Width and Height: crop to fill it (the default), fit inside it with black bars, stretch to it, shrink to fit inside it without bars, or grow to cover it without cropping.One of: cover (Crop to fill the size), contain (Fit inside, with black bars), fill (Stretch to the size), inside (Shrink to fit inside, no bars), outside (Grow to cover the size, no crop). Default: cover.
Crop frompositiontext
Optional. Which part of the cat to keep when it is cropped or barred to fit a box. The center by default; choose Top to keep a cat's head in a wide crop.One of: center, top, right top (Top right), right, right bottom (Bottom right), bottom, left bottom (Bottom left), left, left top (Top left). Default: center.
Filterfiltertext
Optional. Black and white, or a negative. None by default. Cannot be combined with the adjustments below; for black and white with other adjustments, set Saturation to 0 instead.One of: none, mono (Black and white), negate (Negative). Default: none.
Blurblurnumber
Optional. How much to blur the picture, from 1 (a light softening) to 1000. Around 10 is heavy. Leave empty or 0 for a sharp picture.From 0 to 1000.
Brightnessbrightnessnumber
Optional. Multiplies the brightness: 1 leaves it as it is, 0.5 halves it, 1.5 is half as bright again.At least 0.
Saturationsaturationnumber
Optional. Multiplies the colour: 1 leaves it as it is, 0 turns the picture black and white, 2 makes it twice as vivid.At least 0.
Hue shifthuenumber
Optional. Turns every colour round the colour wheel by this many degrees, -360 to 360: 180 makes an orange cat blue.From -360 to 360.
Lightnesslightnessnumber
Optional. Adds to the lightness, -100 to 100: 20 lifts the whole picture towards white, -20 pushes it towards black.From -100 to 100.
Tinttint_colortext
Optional. A colour to tint the picture with, keeping its light and dark: a colour name such as 'orange', a hex code such as '#3366FF', or red, green and blue such as '255, 136, 0'.
Also save the picture as a filesave_as_filetrue/false
Off by default, because the link is all a chat message, an email or a web page needs. Turn it on when a later step needs the file itself: attaching it to an email, uploading it to storage, or posting it as a file.Default: false.

Outputs

captiontext
What the cat says, as it was drawn: on one line, with any line breaks turned into spaces.
catobject
One cat, and everything CATAAS records about it.
content_typetext
The saved file's type, e.g. image/jpeg or image/gif, or '' when not saved.
document_reftext
The saved file's document reference, or '' when not saved.
documentslist
The saved picture as a document, ready to attach to a later step. Empty when it was not saved.
file_size_bytesnumber
The saved file's size in bytes, or 0 when not saved.
file_urltext
A URL that serves the saved file, or '' when not saved.
image_tagtext
The same link as an HTML <img> tag, with alt text, for a step that writes an email or a page.
saved_as_filetrue/false
True when the picture was also saved as a file (Also save the picture as a file). The file fields below are empty otherwise.
urltext
A link to this exact picture, at the size and with the effects asked for. It always shows the same cat, so it can go straight into a chat message, an email or a web page.
Example output
{
  "caption": "Happy Friday!",
  "cat": {
    "created_at": "2016-04-13T14:20:46.638000+00:00",
    "id": "Ybl50EQXvmgtCHSl",
    "is_gif": false,
    "mimetype": "image/jpeg",
    "size_bytes": null,
    "tags": [
      "cute",
      "orange"
    ],
    "url": "https://cataas.com/cat/Ybl50EQXvmgtCHSl"
  },
  "content_type": "",
  "document_ref": "",
  "documents": [],
  "file_size_bytes": 0,
  "file_url": "",
  "image_tag": "<img src=\"https://cataas.com/cat/Ybl50EQXvmgtCHSl/says/Happy%20Friday%21?width=400&amp;height=300&amp;fontColor=white\" alt=\"A cat saying \u201cHappy Friday!\u201d\" width=\"400\" height=\"300\">",
  "saved_as_file": false,
  "url": "https://cataas.com/cat/Ybl50EQXvmgtCHSl/says/Happy%20Friday%21?width=400&height=300&fontColor=white"
}

Cat Facts

Previous Page

CelesTrak

Next Page

On this page

ActionsCount catsGet a cat by idGet a random catList catsList tagsMake a cat say something