The Cat API

Load a new selection of cat photos and inspect each image ID, image URL, width and height.

Official docs

Current public response

Use the button to load another selection; no search term is required.

What the response contains

Load a new selection of cat photos and inspect each image ID, image URL, width and height.

Use the button to request another selection. The photos may change with each load, while the response keeps the same field structure.

Fields worth checking

Image ID
Photo URL
Width in pixels
Height in pixels

How to read each image

The route returns an array. In each item, id identifies the image in the service, url points to the file, and width and height give its pixel dimensions. Those fields describe the returned file; they do not independently provide a breed, name, or history for the cat.

id distinguishes one image from another in the response.
url is the photo address that can be opened separately.
width and height help reserve space before rendering an image.

Do not assume a fixed count

This page calls /v1/images/search?limit=6, but the observed response contained 10 images. Read the received array length instead of designing an interface for exactly six items. New calls can also return different photos and proportions.

A requested parameter does not replace checking the actual response.
A grid needs to accept both landscape and portrait images.
This page does not let you choose a breed in the random result.

An image is not a breed profile

This page uses only image search. The service site also mentions breed data, but that information is not guaranteed by this endpoint or this screen. If a product needs to show breed or origin, make a separate request and display only what it returns.

Do not infer breed or behavior from a photo appearance.
Check the file type and dimensions supplied by the URL before using it in a layout.
For public use, establish image credit, moderation, and rights rules for your project.