Skip to main content

Facts

Retrieve random cat facts or facts about a specific breed.

Random facts​

Request one or more facts without filtering to a particular breed.

curl --location 'https://api.thecatapi.com/v1/facts?limit=1' \
  --header 'x-api-key: YOUR-API-KEY'

Example response:

[
  {
    "id": "NA9ERlO1n-",
    "title": "Exceptional Hunting Skills",
    "fact": "European Shorthairs are renowned for their agility, intelligence, and exceptional hunting instincts. Historically prized as working barn cats, they remain playful and active, requiring outlets for their natural prey drive.",
    "slug": "exceptional-hunting-skills",
    "category": null,
    "species_id": "1"
  }
]

Facts about a breed​

Supply the breed ID to scope the facts to a single breed. The limit and offset query parameters page through the results (see Paginating through any endpoint), and lang localises them.

curl --location 'https://api.thecatapi.com/v1/facts/breed/abys?limit=2&lang=en' \
  --header 'x-api-key: YOUR-API-KEY'

You can get the same result from the list endpoint with a breed_id filter:

curl --location 'https://api.thecatapi.com/v1/facts?breed_id=abys&limit=2' \
  --header 'x-api-key: YOUR-API-KEY'

Sample response:

[
  {
    "id": "j-ckSqB2BW",
    "title": "Sensitive to Anesthesia",
    "fact": "Abyssinians can be more sensitive to anesthesia than other breeds, requiring careful monitoring and dosage adjustments during procedures.",
    "slug": "sensitive-to-anesthesia",
    "category": null,
    "species_id": "1"
  },
  {
    "id": "TY0wQvvPlG",
    "title": "High Intelligence",
    "fact": "Abyssinians are considered one of the most intelligent cat breeds, easily trained and quick to learn tricks and commands.",
    "slug": "high-intelligence",
    "category": null,
    "species_id": "1"
  }
]

Breed abys corresponds to the Abyssinian, so each fact references that breed.

A random fact for a breed​

curl --location 'https://api.thecatapi.com/v1/facts/breed/abys/random' \
  --header 'x-api-key: YOUR-API-KEY'

Localised facts​

Set the optional lang parameter to retrieve translated facts. Supported values are en, de, es, fr and it.

curl --location 'https://api.thecatapi.com/v1/facts/breed/abys?limit=1&lang=it' \
  --header 'x-api-key: YOUR-API-KEY'

Response:

[
  {
    "id": "TY0wQvvPlG",
    "title": "Alta intelligenza",
    "fact": "Gli Abissini sono considerati una delle razze di gatti più intelligenti, facili da addestrare e veloci nell'apprendere trucchi e comandi.",
    "slug": "high-intelligence",
    "category": null,
    "species_id": "1"
  }
]

Any endpoint that supports pagination also returns pagination-count, pagination-page, and pagination-limit headers. In the example above, those headers contain the values 10, 0, and 1 respectively, indicating ten total facts, the first page, and a limit of one item per page.