https://cataas.com/ * Cataas * Upload cat * API doc * Follow on Buy me a CATAAS Cat as a service Is a REST API to spread peace and love (or not) thanks to cats. Have 0 cats for now Give me a cat Hey ! Do you like Cataas? Do you want to support the project ?Buy me a beer Hey cat lovers, new major version of cataas : * Now JSON will returns if request contain application/json header, API doc updated here * Fix tags search and fix tags combined with "," separator (see documentation) --------------------------------------------------------------------- Basic Url Description Example /cat Will return a random cat Random cat Will return a random cat with a Random /cat/:tag :tag, You can combine multiple tags orange cute with :tag separator cat /cat/gif Will return a random gif cat \o/ Random gif cat /cat/says/:text Will return a random cat saying Random cat :text saying hello Will return a random cat with a Random cute /cat/:tag/says/:text :tag and saying :text cat saying hello /cat/says/:text? Will return a random cat saying Custom fontSize=:size& :text with text's :fontSize and random cat fontColor=:color text's :fontColor saying hello Advanced Url Description Example Will return a random cat with Random /cat?type=:type image :type (xsmall, small, cat with medium or square) type Will return a random cat with Random /cat?filter=:filter image filtered by :filter cat (blur, mono, negate or filtered custom) /cat?filter=custom&brightness Will return a random cat with Random =:brightness&lightness image filtered by cat =:lightness&saturation :brightness, :lightness, filtered =:saturation&hue=:hue :saturation and :hue /cat?filter=custom&r=:red&g Will return a random cat with Random =:green&b=:blue image filtered by :red, cat :green and :blue filtered Random /cat?width=:width or /cat? Will return a random cat with cat with height=:height :width or :height custom size Will return a random cat in a Random /cat?html=true HTML page, usefull for cat in Twitter or Facebook embedded HTML render Will return a random cat in a Random /cat?json=true JSON object cat in JSON /cat/gif/says/Hello?filter= mono&fontColor=orange& Mix 'em all :D Combo fontSize=20&type=square Get JSON data Url Description Example /api/cats?tags=tag1,tag2&skip=0& Will return all Get all cute limit=10 cats cats /api/tags Will return all Get all tags tags @ 2026 - Made with [?] by Kevin - all rights reserved