# JokeAPI

**Canonical:** https://apis.io/providers/jokeapi/  
**Website:** https://jokeapi.dev/  
**APIs profiled:** 3

JokeAPI is a free, open source REST API that delivers consistently formatted jokes in JSON, XML, YAML, or plain text. It exposes seven joke categories (Any, Misc, Programming, Dark, Pun, Spooky, Christmas), six blacklist content flags (nsfw, religious, political, racist, sexist, explicit), and filters for language, joke type, ID range, contains-text search, amount, and safe-mode. No sign-up is required and CORS is enabled. The service is rate-limited at 120 requests per minute per IP (5 per minute on submissions) and is maintained by Sv443 under the MIT license. The canonical source lives on Sv443's own Git server, with this GitHub repo kept open for issues and the community wrapper-library index.

## Kin Score — 29.9 / 100 (thin)

Scored 2026-08-20 under rubric 0.12.0. Trend: flat (+0.0 from 29.9).

| Facet | Score |
|---|---|
| Discoverability | 74.1 |
| Contract Quality | 21.4 |
| Governance | 25.0 |
| Contract Governance | 25.0 |
| Operational Transparency | 42.1 |
| Developer Ergonomics | 14.3 |
| Commercial Clarity | 28.9 |
| Access Clarity | 28.9 |

## Agent readiness — 36.8 (agent-ready)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | derived |
| Reversibility Documented | no |
| MCP Server | no |
| Auth Clarity | no |
| Idempotency | no |
| Error Semantics | verified |
| OpenAPI Examples | verified |
| Rate Limit Signal | documented |
| Event Surface Described | no |
| Agent Skills | no |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | yes |

## Access

Free · Open access — onboarding: open, pricing: free, trial: no (confidence: medium).

## APIs (3)

- **JokeAPI Jokes API** — Operations for retrieving and submitting jokes.
- **JokeAPI Metadata API** — Operations describing the API surface — categories, flags, formats, languages.
- **JokeAPI System API** — Health and discovery endpoints.

## Agentic access (1)

- **Jokeapi Agentic Access** — 10 operations · 1 acting

## Security (1)

- **Jokeapi Domain Security** — TLSv1.3 · HSTS · DNSSEC · DMARC

## Plans (1)

- **Jokeapi Plans Pricing**

## Tags

Jokes, Humor, Entertainment, Open-Source, REST API, Games And Comics, Public APIs

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/jokeapi/). Scores are computed from the provider's own public artifacts under a published rubric.