- Category: images & design
- Auth: API_KEY
- Composio-managed OAuth available? N/A
- Tools: 18
- Triggers: 0
- Slug:
CATS - Version: 20261101_00
Tools
Create Favourite
Create Favourite
Create Vote
Create Vote
Delete Favourite
Delete Favourite
Delete Image
Delete Image
Delete Vote
Delete Vote
Get Cat Breed by ID
Get Cat Breed by ID
Slug:
CATS_GET_BREEDTool to get detailed information about a specific cat breed by its ID. Use when you need comprehensive details about a particular breed including temperament, origin, characteristics, and URLs.Input Parameters
Unique breed identifier (e.g., ‘pers’ for Persian, ‘beng’ for Bengal, ‘siam’ for Siamese).
Output
Get Favourite by ID
Get Favourite by ID
Slug:
CATS_GET_FAVOURITETool to retrieve a specific favourite by its unique ID. Returns full favourite details including user ID, image ID, creation timestamp, and associated image data. Use when you need to fetch a particular favourite’s information or verify favourite existence.Input Parameters
Output
Get Cat Image by ID
Get Cat Image by ID
Get Image Analysis
Get Image Analysis
Slug:
CATS_GET_IMAGE_ANALYSISGet machine learning analysis for an uploaded image, which may include labels, confidence scores, bounding boxes, and content moderation classifications. If the API returns multiple analysis records, only the first is returned; an empty list yields an empty analysis.Input Parameters
The unique identifier of the uploaded image to analyze. This is the ID returned when you upload an image to The Cat API.
Output
Get Image Breeds
Get Image Breeds
Get Cat Breeds
Get Cat Breeds
Get Vote by ID
Get Vote by ID
List Image Categories
List Image Categories
List Favourites
List Favourites
Slug:
CATS_LIST_FAVOURITESTool to get all favourites belonging to your account. Use when you need to retrieve saved cat images, optionally filtered by sub_id. Supports pagination to browse through large collections of favourites.Input Parameters
Sort order for the results by creation date. DESC returns newest first, ASC returns oldest first.
Filter favourites by sub_id value used when creating them. Use this to retrieve favourites for a specific user or context.
Output
List Uploaded Images
List Uploaded Images
Slug:
CATS_LIST_UPLOADED_IMAGESTool to get all images uploaded to your account via /images/upload. Supports pagination and filtering by sub_id or original filename. Use this to retrieve your uploaded images, check if a file already exists, or filter by user identifiers. The API returns images in order of upload date.Input Parameters
Page number for pagination (starts at 0). Only works with authenticated requests to page through your uploads.
Optional identifier to filter images by sub_id (e.g., user ID or session ID). Only returns images uploaded with this sub_id.
Optional filter to search for images by their original filename. Use this to check if a specific file has already been uploaded.
Output
List Votes
List Votes
Search Cat Breeds
Search Cat Breeds
Slug:
CATS_SEARCH_BREEDSSearch for cat breeds by name. Use the ‘q’ parameter with part or all of the breed name to find matching breeds. Returns breed details including temperament, origin, and characteristics.Input Parameters
Search term for breed name. Use part or all of the breed name to find matching breeds (e.g., ‘persian’, ‘sia’, ‘main’).
Whether to attach the reference image in the response. Use 0 for no image, 1 to include image. If omitted, no image is attached.
Output
Search Cat Images
Search Cat Images
Slug:
CATS_SEARCH_IMAGESSearch for random cat images with optional filters. Filter by breed availability, size, and file type. Returns an array of image objects with URLs and metadata. Use this to find cat images for display, testing, or content generation. The default behavior returns 1 random cat image.Input Parameters
Comma-separated MIME types to filter by (e.g., ‘jpg,png’ for static images, ‘gif’ for animated).