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

Cats API

The Cats API provides detailed, qualitative information on every recognized cat breed.

Available endpoints:

  • /v1/cats - Get a list of cat breeds matching specified parameters
  • /v1/allcats - Get a list of all cat breed names
(4.2)

From 2,753 users

4,300+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
266ms286ms362ms742ms1131ms

Similar APIs

Didn't find what you were looking for? Suggest an improvement

/v1/cats GET

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.

Parameters

At least one of the following parameters (other than offset) must be set:

  • name  optional

    The name of cat breed.

  • 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 cat sheds. Possible values: 1, 2, 3, 4, 5, where 1 indicates no shedding and 5 indicates maximum shedding.

  • family_friendly  optional

    How affectionate the cat is to family. Possible values: 1, 2, 3, 4, 5, where 1 indicates minimal affection and 5 indicates maximum affection.

  • playfulness  optional

    How playful the cat is. Possible values: 1, 2, 3, 4, 5, where 1 indicates serious and stern and 5 indicates maximum playfulness.

  • grooming  optional

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

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

    How 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  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 cat breed.

  • image_link

    URL to an image of the breed.

  • length

    Length range of the cat breed.

  • origin

    Geographic origin of the breed.

  • family_friendly

    How affectionate the cat is to family. Rating from 1-5, where 5 indicates maximum affection.

  • children_friendly

    How well the cat gets along with children. Rating from 1-5, where 5 indicates the cat is very kid-friendly.

  • other_pets_friendly

    How well the cat gets along with other pets in the household (for example, dogs). Rating from 1-5, where 5 indicates the cat gets along very well with other pets.

  • shedding

    How much hair the cat sheds. Rating from 1-5, where 1 indicates no shedding and 5 indicates maximum shedding.

  • grooming

    How much work is required to properly groom the cat. Rating from 1-5, where 1 indicates maximum grooming effort and 5 indicates minimum grooming effort.

  • general_health

    General health rating of the cat breed. Rating from 1-5.

  • playfulness

    How playful the cat is. Rating from 1-5, where 1 indicates serious and stern and 5 indicates maximum playfulness.

  • intelligence

    Intelligence rating of the cat breed. Rating from 1-5.

  • min_weight

    Minimum weight in pounds.

  • max_weight

    Maximum weight in pounds.

  • min_life_expectancy

    Minimum life expectancy in years.

  • max_life_expectancy

    Maximum life expectancy in years.

Sample Request Live Demo!

name

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/cats?name=abyssinian

Headers

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

Sample Response

JSON
[
    {
      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"
    }
]

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/cats?name=persian" \ -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/allcats GET

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

Returns a list of all cat 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

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

Sample Response

JSON
[
    "Abyssinian",
    "Aegean",
    "American Bobtail",
    "..."
]

Frequently Asked Questions

  • Yes, but you must have a premium subscription. Commercial use of the Cats 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.
  • Each result is a JSON object with detailed, qualitative information for a cat breed, including origin, length, min_weight, max_weight, min_life_expectancy, max_life_expectancy, an image_link, and 1-to-5 trait ratings such as family_friendly, children_friendly, shedding, grooming, playfulness, and intelligence. If you also work with dogs, see the Dogs API for the equivalent canine data.
  • Send a GET request to the /v1/cats endpoint with any combination of optional filters such as name, min_weight, max_weight, min_life_expectancy, max_life_expectancy, shedding, family_friendly, playfulness, grooming, other_pets_friendly, or children_friendly (rating filters accept values 1 through 5). At least one of these parameters must be set, and you can register for a free API key to start querying.
  • The /v1/cats endpoint returns at most 20 results per request, so to retrieve additional breeds you make multiple calls while increasing the offset parameter for pagination. Higher request volumes may require a paid plan, which you can review on the pricing page.
  • The /v1/cats endpoint returns full breed objects matching your filter parameters, while the /v1/allcats endpoint takes no parameters and simply returns a JSON array of all cat breed names. The /v1/allcats endpoint is available to premium subscribers only, so check the pricing page for access details.