The Cats API provides detailed, qualitative information on every recognized cat breed.
https://api.api-ninjas.com/v1/cats
Get a list of cat breeds matching specified parameters. Returns at most 20 results. To access more than 20 results, use the offset
parameter to offset results in multiple API calls.
At least one of the following parameters (other than offset
) must be set:
name
optionalThe name of cat breed.
min_weight
optionalMinimum weight in pounds.
max_weight
optionalMaximum weight in pounds.
min_life_expectancy
optionalMinimum life expectancy in years.
max_life_expectancy
optionalMaximum life expectancy in years.
shedding
optionalHow much hair the cat sheds. Possible values: 1
, 2
, 3
, 4
, 5
, where 1
indicates no shedding and 5
indicates maximum shedding.
family_friendly
optionalHow affectionate the cat is to family. Possible values: 1
, 2
, 3
, 4
, 5
, where 1
indicates minimal affection and 5
indicates maximum affection.
playfulness
optionalHow playful the cat is. Possible values: 1
, 2
, 3
, 4
, 5
, where 1
indicates serious and stern and 5
indicates maximum playfulness.
grooming
optionalHow much work is required to properly groom the cat. Possible values: 1
, 2
, 3
, 4
, 5
, where 1
indicates maximum grooming effort and 5
indicates minimum grooming effort.
other_pets_friendly
optionalHow well the cat gets along with other pets in the household (for example, dogs). Possible values: 1
, 2
, 3
, 4
, 5
, where 1
indicates the cat isn't very friendly to other pets and 5
indicates the cat gets along very well with other pets.
children_friendly
optionalHow well the cat gets along with children. Possible values: 1
, 2
, 3
, 4
, 5
, where 1
indicates the cat does not get along well with kids and 5
indicates the cat is very kid-friendly.
offset
optionalNumber of results to offset for pagination.
X-Api-Key
requiredAPI Key associated with your account.
https://api.api-ninjas.com/v1/cats?name=abyssinian
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
[
{
"length": "12 to 16 inches",
"origin": "Southeast Asia",
"image_link": "https://api-ninjas.com/images/cats/abyssinian.jpg",
"family_friendly": 3,
"shedding": 3,
"general_health": 2,
"playfulness": 5,
"children_friendly": 5,
"grooming": 3,
"intelligence": 5,
"other_pets_friendly": 5,
"min_weight": 6,
"max_weight": 10,
"min_life_expectancy": 9,
"max_life_expectancy": 15,
"name": "Abyssinian"
}
]
1
2
3
4
5
6
7
8
9
import requests
name = 'abyssinian'
api_url = 'https://api.api-ninjas.com/v1/cats?name={}'.format(name)
response = requests.get(api_url, headers={'X-Api-Key': 'YOUR_API_KEY'})
if response.status_code == requests.codes.ok:
print(response.text)
else:
print("Error:", response.status_code, response.text)
If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.
https://api.api-ninjas.com/v1/allcats
Returns a list of all cat breed names.
None
X-Api-Key
requiredAPI Key associated with your account.
https://api.api-ninjas.com/v1/allcats
1
2
3
4
5
6
[
"Abyssinian",
"Aegean",
"American Bobtail",
...
]