Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Cat Facts (catfact.ninja) Facts API

Random cat trivia, individually or in paginated lists.

Cat Facts (catfact.ninja) Facts API is one of 2 APIs that Cat Facts (catfact.ninja) publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Facts. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 2 operations across 2 paths, and defines 4 schemas. It is described by OpenAPI 3.0.3, at version 1.0.0.

Requests are made against a single base URL, https://catfact.ninja.

2 operations 2 paths 4 schemas 2 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0.0
Base URL
https://catfact.ninja
Resource Areas
1

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 GET. Each is listed below with its method, path, parameters, and response codes.

Facts 2

Random cat trivia, individually or in paginated lists.

GET
/fact
Get Random Fact
getRandomFact 1 param → 200404
GET
/facts
Get a List of Facts
getFacts 2 params → 200

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are CatFactList (13 properties), PaginationLink (3 properties), CatFact (2 properties), Error (1 property). Each schema is shown below with its type and property counts.

PaginationLink
object
A single navigation link in a Laravel-style paginator response.
3 properties
Error
object
Generic error response payload.
1 property
CatFact
object
A single cat trivia fact and its character length.
2 properties 2 required
CatFactList
object
Laravel-style paginated wrapper around a list of CatFact objects.
13 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cat-facts-catfact-facts-api-openapi.yml Raw ↑

Other APIs Cat Facts (catfact.ninja) publishes across the network.

Cat Facts (catfact.ninja) Breeds API