The Dogs API provides detailed, qualitative information on over 200 different breeds of dogs.
https://api.api-ninjas.com/v1/dogs
Get a list of dog 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 (excluding offset) is required.
name optionalThe name of breed.
min_height optionalMinimum height in inches.
max_height optionalMaximum height in inches.
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 breed sheds. Possible values: 1, 2, 3, 4, 5, where 1 indicates no shedding and 5 indicates maximum shedding.
barking optionalHow vocal the breed is. Possible values: 1, 2, 3, 4, 5, where 1 indicates minimal barking and 5 indicates maximum barking.
energy optionalHow much energy the breed has. Possible values: 1, 2, 3, 4, 5, where 1 indicates low energy and 5 indicates high energy.
protectiveness optionalHow likely the breed is to alert strangers. Possible values: 1, 2, 3, 4, 5, where 1 indicates minimal alerting and 5 indicates maximum alerting.
trainability optionalHow easy it is to train the breed. Possible values: 1, 2, 3, 4, 5, where 1 indicates the breed is very difficult to train and 5 indicates the breed is very easy to train.
offset optionalNumber of results to offset for pagination.
X-Api-Key requiredAPI Key associated with your account.
https://api.api-ninjas.com/v1/dogs?name=golden retrieverHeaders
X-Api-KeyLog in or sign up to get your API Key1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
[
{
"image_link": "https://api-ninjas.com/images/dogs/golden_retriever.jpg",
"good_with_children": 5,
"good_with_other_dogs": 5,
"shedding": 4,
"grooming": 2,
"drooling": 2,
"coat_length": 1,
"good_with_strangers": 5,
"playfulness": 4,
"protectiveness": 3,
"trainability": 5,
"energy": 3,
"barking": 1,
"min_life_expectancy": 10,
"max_life_expectancy": 12,
"max_height_male": 24,
"max_height_female": 24,
"max_weight_male": 75,
"max_weight_female": 65,
"min_height_male": 23,
"min_height_female": 23,
"min_weight_male": 65,
"min_weight_female": 55,
"name": "Golden Retriever"
}
]1
2
3
4
5
6
7
8
import requests
name = 'golden retriever'
api_url = 'https://api.api-ninjas.com/v1/dogs?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/alldogs
Returns a list of all dog breed names.
None
X-Api-Key requiredAPI Key associated with your account.
https://api.api-ninjas.com/v1/alldogs1
2
3
4
5
6
[
"Affenpinscher",
"Afghan Hound",
"Airedale Terrier",
...
]