NewConnect Claude, Gemini, ChatGPT, and other AI agents to API Ninjas via our MCP server →

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
(4.3)

From 9,648 users

1,200+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
204ms227ms266ms683ms865ms

Similar APIs

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.

  • name  optional

    The name of breed.

  • min_height  optional

    Minimum height in inches.

  • max_height  optional

    Maximum height in inches.

  • min_weight  optional

    Minimum weight in pounds.

  • max_weight  optional

    Maximum weight in pounds.

  • min_life_expectancy  optional

    Minimum life expectancy in years.

  • max_life_expectancy  optional

    Maximum life expectancy in years.

  • shedding  optional

    How much hair the breed sheds. Possible values: 1, 2, 3, 4, 5, where 1 indicates no shedding and 5 indicates maximum shedding.

  • barking  optional

    How vocal the breed is. Possible values: 1, 2, 3, 4, 5, where 1 indicates minimal barking and 5 indicates maximum barking.

  • energy  optional

    How much energy the breed has. Possible values: 1, 2, 3, 4, 5, where 1 indicates low energy and 5 indicates high energy.

  • protectiveness  optional

    How 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  optional

    How 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  optional

    Number of results to offset for pagination.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON array of objects, each containing the following fields, or an error if the request is unsuccessful.

  • name

    The name of the dog breed.

  • image_link

    URL to an image of the breed.

  • good_with_children

    Compatibility rating with children (1-5, where 5 is best).

  • good_with_other_dogs

    Compatibility rating with other dogs (1-5, where 5 is best).

  • good_with_strangers

    Compatibility rating with strangers (1-5, where 5 is best).

  • shedding

    How much hair the breed sheds (1-5, where 1 indicates no shedding and 5 indicates maximum shedding).

  • grooming

    Grooming requirement rating (1-5, where 5 indicates highest maintenance).

  • drooling

    Drooling tendency rating (1-5, where 5 indicates maximum drooling).

  • coat_length

    Coat length rating (1-5).

  • playfulness

    Playfulness rating (1-5, where 5 indicates highest playfulness).

  • protectiveness

    How likely the breed is to alert strangers (1-5, where 1 indicates minimal alerting and 5 indicates maximum alerting).

  • trainability

    How easy it is to train the breed (1-5, where 1 indicates very difficult to train and 5 indicates very easy to train).

  • energy

    How much energy the breed has (1-5, where 1 indicates low energy and 5 indicates high energy).

  • barking

    How vocal the breed is (1-5, where 1 indicates minimal barking and 5 indicates maximum barking).

  • min_life_expectancy

    Minimum life expectancy in years.

  • max_life_expectancy

    Maximum life expectancy in years.

  • min_height_male

    Minimum height in inches for male dogs.

  • max_height_male

    Maximum height in inches for male dogs.

  • min_height_female

    Minimum height in inches for female dogs.

  • max_height_female

    Maximum height in inches for female dogs.

  • min_weight_male

    Minimum weight in pounds for male dogs.

  • max_weight_male

    Maximum weight in pounds for male dogs.

  • min_weight_female

    Minimum weight in pounds for female dogs.

  • max_weight_female

    Maximum weight in pounds for female dogs.

Sample Request Live Demo!

name
min_height
max_height
min_weight
max_weight

Try our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

https://api.api-ninjas.com/v1/dogs?name=golden%20retriever

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
[
    {
      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.

Premium subscriptions only

/v1/alldogs GET

https://api.api-ninjas.com/v1/alldogs

Returns a list of all dog breed names.

Parameters

None

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON array of strings, or an error if the request is unsuccessful.

Sample Request Live Demo!

Try our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

https://api.api-ninjas.com/v1/alldogs

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
[
    "Affenpinscher",
    "Afghan Hound",
    "Airedale Terrier",
    "..."
]

Frequently Asked Questions

  • Yes, but you must have a premium subscription. Commercial use of the Dogs API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
  • Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
  • Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
  • The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
  • The Dogs API provides detailed, qualitative information on over 200 dog breeds, including 1-5 ratings for traits like good_with_children, shedding, trainability, and energy, plus life expectancy and separate height and weight ranges for males and females. If you are interested in similar data for other animals, see the Cats API and the Animals API.
  • Send a GET request to the /v1/dogs endpoint with parameters such as min_height, max_height, min_weight, max_weight, min_life_expectancy, or 1-5 trait filters like shedding, barking, protectiveness, and trainability (at least one parameter, excluding offset, is required). You can create an account to get an API key and start querying.
  • The /v1/dogs endpoint returns at most 20 results per request, so use the offset parameter to page through additional matches across multiple calls. To retrieve a complete list of all dog breed names at once, use the premium-only /v1/alldogs endpoint, which requires a subscription on our pricing page.
  • The /v1/dogs endpoint returns a JSON array of objects with fields including name, image_link, trait ratings such as good_with_strangers, grooming, drooling, and playfulness, plus min_height_male, max_weight_female, and life expectancy ranges, while /v1/alldogs returns a JSON array of breed name strings. If a request is unsuccessful, an error is returned instead.