Hey ! Do you like Cataas? Do you want to support the project ?Buy me a beer 🍺
Hey cat lovers, new major version of cataas :
application/json header, API doc updated here"," separator (see documentation)| Url | Description | Example |
|---|---|---|
| /cat | Will return a random cat | Random cat |
| /cat/:tag | Will return a random cat with a :tag, You can combine multiple tags with :tag separator | Random orange cute cat |
| /cat/gif | Will return a random gif cat \o/ | Random gif cat |
| /cat/says/:text | Will return a random cat saying :text | Random cat saying hello |
| /cat/:tag/says/:text | Will return a random cat with a :tag and saying :text | Random cute cat saying hello |
| /cat/says/:text?fontSize=:size&fontColor=:color | Will return a random cat saying :text with text's :fontSize and text's :fontColor | Custom random cat saying hello |
| Url | Description | Example |
|---|---|---|
| /cat?type=:type | Will return a random cat with image :type (xsmall, small, medium or square) | Random cat with type |
| /cat?filter=:filter | Will return a random cat with image filtered by :filter (blur, mono, negate or custom) | Random cat filtered |
| /cat?filter=custom&brightness=:brightness&lightness=:lightness&saturation=:saturation&hue=:hue | Will return a random cat with image filtered by :brightness, :lightness, :saturation and :hue | Random cat filtered |
| /cat?filter=custom&r=:red&g=:green&b=:blue | Will return a random cat with image filtered by :red, :green and :blue | Random cat filtered |
| /cat?width=:width or /cat?height=:height | Will return a random cat with :width or :height | Random cat with custom size |
| /cat?html=true | Will return a random cat in a HTML page, usefull for Twitter or Facebook embedded render | Random cat in HTML |
| /cat?json=true | Will return a random cat in a JSON object | Random cat in JSON |
| /cat/gif/says/Hello?filter=mono&fontColor=orange&fontSize=20&type=square | Mix 'em all :D | Combo |
| Url | Description | Example |
|---|---|---|
| /api/cats?tags=tag1,tag2&skip=0&limit=10 | Will return all cats | Get all cute cats |
| /api/tags | Will return all tags | Get all tags |