Dogs API
The Dogs API provides detailed, qualitative information on over 200 different breeds of dogs.
Available endpoints:
- /v1/dogs - Get a list of dog breeds matching specified parameters
- /v1/alldogs - Get a list of all dog breed names
From 9,648 users
Applications using this API
API Status
API Response Times
Average | P50 | P75 | P90 | P95 |
|---|---|---|---|---|
| 204ms | 227ms | 266ms | 683ms | 865ms |
Didn't find what you were looking for? Suggest an improvement
/v1/dogs GET
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.
Parameters
At least one of the following parameters (excluding offset) is required.
nameoptionalThe name of breed.
min_heightoptionalMinimum height in inches.
max_heightoptionalMaximum height in inches.
min_weightoptionalMinimum weight in pounds.
max_weightoptionalMaximum weight in pounds.
min_life_expectancyoptionalMinimum life expectancy in years.
max_life_expectancyoptionalMaximum life expectancy in years.
sheddingoptionalHow much hair the breed sheds. Possible values:
1,2,3,4,5, where1indicates no shedding and5indicates maximum shedding.barkingoptionalHow vocal the breed is. Possible values:
1,2,3,4,5, where1indicates minimal barking and5indicates maximum barking.energyoptionalHow much energy the breed has. Possible values:
1,2,3,4,5, where1indicates low energy and5indicates high energy.protectivenessoptionalHow likely the breed is to alert strangers. Possible values:
1,2,3,4,5, where1indicates minimal alerting and5indicates maximum alerting.trainabilityoptionalHow easy it is to train the breed. Possible values:
1,2,3,4,5, where1indicates the breed is very difficult to train and5indicates the breed is very easy to train.offsetoptionalNumber of results to offset for pagination.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
Returns an array of dog breed objects, each containing:
nameThe name of the dog breed.
image_linkURL to an image of the breed.
good_with_childrenCompatibility rating with children (1-5, where 5 is best).
good_with_other_dogsCompatibility rating with other dogs (1-5, where 5 is best).
good_with_strangersCompatibility rating with strangers (1-5, where 5 is best).
sheddingHow much hair the breed sheds (1-5, where 1 indicates no shedding and 5 indicates maximum shedding).
groomingGrooming requirement rating (1-5, where 5 indicates highest maintenance).
droolingDrooling tendency rating (1-5, where 5 indicates maximum drooling).
coat_lengthCoat length rating (1-5).
playfulnessPlayfulness rating (1-5, where 5 indicates highest playfulness).
protectivenessHow likely the breed is to alert strangers (1-5, where 1 indicates minimal alerting and 5 indicates maximum alerting).
trainabilityHow easy it is to train the breed (1-5, where 1 indicates very difficult to train and 5 indicates very easy to train).
energyHow much energy the breed has (1-5, where 1 indicates low energy and 5 indicates high energy).
barkingHow vocal the breed is (1-5, where 1 indicates minimal barking and 5 indicates maximum barking).
min_life_expectancyMinimum life expectancy in years.
max_life_expectancyMaximum life expectancy in years.
min_height_maleMinimum height in inches for male dogs.
max_height_maleMaximum height in inches for male dogs.
min_height_femaleMinimum height in inches for female dogs.
max_height_femaleMaximum height in inches for female dogs.
min_weight_maleMinimum weight in pounds for male dogs.
max_weight_maleMaximum weight in pounds for male dogs.
min_weight_femaleMinimum weight in pounds for female dogs.
max_weight_femaleMaximum weight in pounds for female dogs.
Sample Request Live Demo!
Try this API endpoint with all available parameters in our API playground
https://api.api-ninjas.com/v1/dogs?name=golden%20retrieverHeaders
X-Api-KeyLog in or sign up to get your API KeySample Response
1
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"
}
]Code Examples
1
2
curl -X GET "https://api.api-ninjas.com/v1/dogs?name=husky" \
-H "X-Api-Key: YOUR_API_KEY"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.
/v1/alldogs GET
https://api.api-ninjas.com/v1/alldogs
Returns a list of all dog breed names.
Parameters
None
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
Returns an array of strings, where each string is a dog breed name.
Sample Request Live Demo!
Try this API endpoint with all available parameters in our API playground
https://api.api-ninjas.com/v1/alldogsHeaders
X-Api-KeyLog in or sign up to get your API KeySample Response
1
2
3
4
5
6
[
"Affenpinscher",
"Afghan Hound",
"Airedale Terrier",
"..."
]