Cat Facts (catfact.ninja) website screenshot

Cat Facts (catfact.ninja)

Cat Facts is a free, no-authentication community REST API at catfact.ninja that serves random cat trivia and a catalog of cat breeds. It exposes three documented endpoints — a single random fact, a paginated list of facts, and a paginated list of breeds — and ships a Swagger UI based OpenAPI 3.0 document at /docs. The service is widely used in API onboarding tutorials, demos, and sample apps because it requires no API key and returns small, predictable JSON payloads.

Cat Facts (catfact.ninja) publishes 2 APIs on the APIs.io network: Breeds API and Facts API. Tagged areas include Animals, Cats, Trivia, Public APIs, and Community.

The Cat Facts (catfact.ninja) catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

Cat Facts (catfact.ninja)’s developer surface includes authentication, tooling, and 12 more developer resources.

31.2/100 thin ▼ -6.6 Agent 34/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessOpen
2 APIs
AnimalsCatsTriviaPublic APIsCommunityNo AuthenticationREST

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 31.2/100 · thin
Contract Quality 13.1 / 25
Developer Ergonomics 2.2 / 20
Commercial Clarity 0.0 / 20
Operational Transparency 0.0 / 13
Governance 8.3 / 12
Discoverability 7.6 / 10
Agent readiness — 34/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 0 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/cat-facts-catfact: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 2

Individual APIs this provider publishes, each with its own machine-readable definition.

Cat Facts (catfact.ninja) Breeds API

Catalog of cat breeds with country, origin, coat, and pattern.

Cat Facts (catfact.ninja) Facts API

Random cat trivia, individually or in paginated lists.

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Cat Facts API

OPEN COLLECTION

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Cat Facts Catfact Context

9 classes · 22 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Cat Facts (catfact.ninja) API Rules

5 rules · 4 warnings 1 info

SPECTRAL

Cat Facts (catfact.ninja) API Rules

37 rules · 8 errors 25 warnings 4 info

SPECTRAL

JSON Schema 5

Standalone JSON Schema definitions for this provider's data models.

BreedList

13 properties

JSON SCHEMA

Breed

5 properties

JSON SCHEMA

CatFactList

13 properties

JSON SCHEMA

CatFact

2 properties

JSON SCHEMA

PaginationLink

3 properties

JSON SCHEMA

JSON Structure 5

JSON Structure definitions describing this provider's data shapes.

Cat Facts Catfact Breed List Structure

13 properties

JSON STRUCTURE

Cat Facts Catfact Breed Structure

5 properties

JSON STRUCTURE

Cat Facts Catfact Cat Fact List Structure

13 properties

JSON STRUCTURE

Cat Facts Catfact Cat Fact Structure

2 properties

JSON STRUCTURE

Examples 5

Example request and response payloads for these APIs.

Security Posture 1

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Cat Facts Catfact Agentic Access

3 operations

3 operations · 0 acting

AGENTIC

Resources

Documentation 2

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 3

Pagination, idempotency, versioning, errors, and events

Build 3

SDKs, sample code, and the tooling you integrate with

Access & Security 2

Authentication, authorization, and security posture

Operate 1

Status, limits, changes, and where to get help

Company 1

The organization behind the API

Other 1

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: cat-facts-catfact
name: Cat Facts (catfact.ninja)
description: Cat Facts is a free, no-authentication community REST API at catfact.ninja that serves random cat trivia and
  a catalog of cat breeds. It exposes three documented endpoints — a single random fact, a paginated list of facts, and a
  paginated list of breeds — and ships a Swagger UI based OpenAPI 3.0 document at /docs. The service is widely used in API
  onboarding tutorials, demos, and sample apps because it requires no API key and returns small, predictable JSON payloads.
url: https://catfact.ninja/
accessModel:
  pricing: unknown
  onboarding: open
  trial: false
  try_now: false
  public: true
  label: Open access
  confidence: medium
  source: []
  generated: '2026-07-22'
  method: derived
image: https://catfact.ninja/docs/asset/favicon-32x32.png
specificationVersion: '0.20'
created: '2026-05-28'
modified: '2026-05-30'
x-source: public-apis/public-apis
x-type: opensource
x-category: Animals
x-tier: 3
x-tier-reason: bulk-registered-from-public-apis
tags:
- Animals
- Cats
- Trivia
- Public APIs
- Community
- No Authentication
- REST
apis:
- aid: cat-facts-catfact:cat-facts-catfact-breeds-api
  name: Cat Facts (catfact.ninja) Breeds API
  description: Catalog of cat breeds with country, origin, coat, and pattern.
  humanURL: https://catfact.ninja/
  baseURL: https://catfact.ninja
  tags:
  - Breeds
  properties:
  - type: OpenAPI
    url: openapi/cat-facts-catfact-breeds-api-openapi.yml
  - type: Documentation
    url: https://catfact.ninja/
  - type: SwaggerUI
    url: https://catfact.ninja/
  - type: OpenAPISource
    url: https://catfact.ninja/docs?api-docs.json
- aid: cat-facts-catfact:cat-facts-catfact-facts-api
  name: Cat Facts (catfact.ninja) Facts API
  description: Random cat trivia, individually or in paginated lists.
  humanURL: https://catfact.ninja/
  baseURL: https://catfact.ninja
  tags:
  - Facts
  properties:
  - type: OpenAPI
    url: openapi/cat-facts-catfact-facts-api-openapi.yml
  - type: Documentation
    url: https://catfact.ninja/
  - type: SwaggerUI
    url: https://catfact.ninja/
  - type: OpenAPISource
    url: https://catfact.ninja/docs?api-docs.json
common:
- type: AgenticAccess
  url: agentic-access/cat-facts-catfact-agentic-access.yml
- type: DomainSecurity
  url: security/cat-facts-catfact-domain-security.yml
- type: Website
  url: https://catfact.ninja/
- type: SwaggerUI
  url: https://catfact.ninja/
- type: OpenAPI
  url: https://catfact.ninja/docs?api-docs.json
- type: ContactEmail
  url: mailto:contact@catfact.ninja
- type: PublicAPIsListing
  url: https://github.com/public-apis/public-apis
- type: Authentication
  title: No Authentication Required
  url: https://catfact.ninja/
- type: Tools
  title: MCP Server (Community — cursethevulgar)
  url: https://github.com/cursethevulgar/catfact-mcp-server
- type: Tools
  title: MCP Server (Community — mtrmarko)
  url: https://github.com/mtrmarko/cat-facts-mcp
- type: Tools
  title: MCP Server (Community — Volspan)
  url: https://github.com/volspan-deployments/cat-facts-mcp
- type: SpectralRules
  url: rules/cat-facts-catfact-rules.yml
- type: Vocabulary
  url: vocabulary/cat-facts-catfact-vocabulary.yml
- type: JSONLDContext
  url: json-ld/cat-facts-catfact-context.jsonld
features:
- name: Free and Open
  description: No API key, no signup, no quota header. Anyone can hit catfact.ninja and start getting JSON back. Ideal for
    first-class onboarding examples in tutorials and SDK quickstarts.
- name: Paginated Listings
  description: The /facts and /breeds endpoints return Laravel-style paginated responses with current_page, last_page, per_page,
    total, and a links array suitable for "next/prev" UI patterns.
- name: Length-Filtered Facts
  description: Both /fact and /facts accept a max_length query parameter, letting clients restrict trivia length for SMS-friendly,
    push-notification-friendly, or banner use cases.
- name: Self-Describing OpenAPI
  description: A live OpenAPI 3.0 document is published at /docs?api-docs.json and rendered as Swagger UI at /docs — usable
    directly by codegen tools, Postman import, and AI agent toolkits.
useCases:
- name: API Onboarding Tutorials
  description: Used in countless "hello-world" REST tutorials because it returns small JSON, requires no auth, and is CORS-friendly.
    A canonical first call for browsers, mobile apps, and SDKs.
- name: SMS and Chatbot Daily Facts
  description: The original Cat Facts service became a meme around texting friends a daily cat fact. catfact.ninja is the
    easiest backend for any "daily fact" bot, including SMS, Discord, and Slack integrations.
- name: Load Testing and Demo Apps
  description: Engineering teams point load generators, screen-recording demos, and observability sample apps at catfact.ninja
    because it tolerates traffic, returns tiny payloads, and never requires credential rotation.
- name: MCP and Agent Tool Demos
  description: Several community Model Context Protocol servers wrap catfact.ninja as a "hello world" tool because the surface
    is small, safe, and read-only — perfect for showing Claude using a tool.
integrations:
- name: Public APIs Index
  description: Listed in the popular public-apis/public-apis index as a free, no-auth Animals API.
- name: Community MCP Servers
  description: At least three community-built MCP servers wrap the catfact.ninja endpoints as Claude tools.
- name: Swagger UI
  description: Ships a live Swagger UI at https://catfact.ninja/ that imports the OpenAPI spec from /docs.
solutions:
- name: Lowest-Friction Demo API
  description: When you need a public, free, no-auth REST API to demo SDK generation, OpenAPI tooling, mock servers, or agent
    tool calls, catfact.ninja is the smallest acceptable surface area.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com