API Key Required

Check Authentication for more details

/breeds

https://api.thecatapi.com/v1/images/search?breed_ids={breed-id}

Each breed has a unique 4 character id which can be used to filter a Search. This breed.id is available by listing all the Breeds via https://api.thecatapi.com/v1/breeds

e.g. for only Bengal cats you’d request https://api.thecatapi.com/v1/images/search?breed_ids=beng

Checkout the /breeds API Reference in the left panel

Example - Breed Selection
  1. It populates the Select Dropdown with https://api.thecatapi.com/v1/breeds
  2. Requests a new Image with https://api.thecatapi.com/images/search?breed_id={{selected_breed.id}} when you change Breed
  3. This then shows a random Image for that Breed
object

Information about a Cat Breed, there’s around 60. The properties will be expanded over time as more information is written about each (description, history etc).

id
string
name
string
temperament
string
life_span
string
alt_names
string
wikipedia_url
string
origin
string
weight_imperial
string
experimental
integer
minimum: 0
maximum: 1
hairless
integer
minimum: 0
maximum: 1
natural
integer
minimum: 0
maximum: 1
rare
integer
minimum: 0
maximum: 1
rex
integer
minimum: 0
maximum: 1
suppress_tail
integer
minimum: 0
maximum: 1
short_legs
integer
minimum: 0
maximum: 1
hypoallergenic
integer
minimum: 0
maximum: 1
adaptability
integer
minimum: 1
maximum: 5
affection_level
integer
minimum: 1
maximum: 5
country_code
string
child_friendly
integer
minimum: 1
maximum: 5
dog_friendly
integer
minimum: 1
maximum: 5
energy_level
integer
minimum: 1
maximum: 5
grooming
integer
minimum: 1
maximum: 5
health_issues
integer
minimum: 1
maximum: 5
intelligence
integer
minimum: 1
maximum: 5
shedding_level
integer
minimum: 1
maximum: 5
social_needs
integer
minimum: 1
maximum: 5
stranger_friendly
integer
minimum: 1
maximum: 5
vocalisation
integer
minimum: 1
maximum: 5