JokeAPI

JokeAPI is a free, open-source REST API that delivers consistently formatted jokes with no authentication, registration, or payment required. It provides over 1,368 jokes across categories including Programming, Misc, Dark, Pun, Spooky, and Christmas in 6 languages. The API supports rich filtering by category, language, content flags (NSFW, Religious, Political, Racist, Sexist, Explicit), and joke type (single or two-part). Response formats include JSON, XML, YAML, and plain text. A safe mode ensures family-friendly content for appropriate applications.

JokeAPI publishes 1 API on the APIs.io network: JokeAPI. Tagged areas include Jokes, Humor, Entertainment, Programming Jokes, and Dark Humor.

JokeAPI’s developer surface includes documentation and 7 more developer resources.

🌐 Visit website 📡 Source on GitHub

27.9/100 emerging ▬ flat Agent 19/100 agent aware Full breakdown ↓
scored 2026-08-05 · rubric v0.9.1

AccessFreeOpen⚡ Free to try

1 APIs

JokesHumorEntertainmentProgramming JokesDark HumorPunsFree APIOpen Source

Kin Score

Kin Score How this is scored →
scored 2026-08-05 · rubric v0.9.1

Composite quality — 27.9/100 · emerging

Contract Quality 8.1 / 25

Developer Ergonomics 1.7 / 20

Commercial Clarity 5.8 / 20

Operational Transparency 5.5 / 13

Governance 0.0 / 12

Discoverability 6.9 / 10

Agent readiness — 19/100 · agent aware

Machine-Readable Contract 18 / 18

Agentic Access Contract 0 / 10

MCP Server 0 / 12

Machine-Readable Auth 0 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 7 / 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/joke-api: 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 1

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

Rate Limits 1

Documented rate limits and quota policies.

Joke Api Rate Limits

2 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Documentation 1

Reference material describing how the API behaves

Documentation

Documentation

Build 1

SDKs, sample code, and the tooling you integrate with

GitHubOrg

GitHubOrg

Access & Security 1

Authentication, authorization, and security posture

DomainSecurity

DomainSecurity

Operate 2

Status, limits, changes, and where to get help

StatusPage

StatusPage

RateLimits

RateLimits

Commercial 2

Pricing, plans, and the legal terms of use

Plans

Plans

FinOps

FinOps

Company 1

The organization behind the API

Website

Website

Source (apis.yml)

aid: joke-api
name: JokeAPI
description: JokeAPI is a free, open-source REST API that delivers consistently formatted jokes with no authentication, registration,
  or payment required. It provides over 1,368 jokes across categories including Programming, Misc, Dark, Pun, Spooky, and
  Christmas in 6 languages. The API supports rich filtering by category, language, content flags (NSFW, Religious, Political,
  Racist, Sexist, Explicit), and joke type (single or two-part). Response formats include JSON, XML, YAML, and plain text.
  A safe mode ensures family-friendly content for appropriate applications.
accessModel:
  pricing: free
  onboarding: open
  trial: false
  try_now: true
  public: true
  label: Free · Open access
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/joke-api.png
url: https://raw.githubusercontent.com/api-evangelist/joke-api/refs/heads/main/apis.yml
created: '2026-06-13'
modified: '2026-06-13'
specificationVersion: '0.19'
tags:
- Jokes
- Humor
- Entertainment
- Programming Jokes
- Dark Humor
- Puns
- Free API
- Open Source
apis:
- aid: joke-api:joke-api
  name: JokeAPI
  description: A REST API delivering consistently formatted jokes with filtering by category, language, content flags, and
    joke type. Supports multiple response formats and requires no authentication.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://jokeapi.dev/
  baseURL: https://v2.jokeapi.dev
  tags:
  - Jokes
  - Humor
  - Entertainment
  - Programming
  - Dark Humor
  - Puns
  properties:
  - type: Documentation
    url: https://jokeapi.dev/
  - type: OpenAPI
    url: https://raw.githubusercontent.com/Sv443-Network/JokeAPI/master/openapi.json
  - type: GitHubOrg
    url: https://github.com/Sv443-Network
  - type: GitHubRepository
    url: https://github.com/Sv443-Network/JokeAPI
  - type: StatusPage
    url: https://status.sv443.net/
  - type: ChangeLog
    url: https://github.com/Sv443-Network/JokeAPI/blob/master/changelog.md
  - type: Discord
    url: https://sv443.net/discord
  - type: Plans
    url: plans/joke-api-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/joke-api-rate-limits.yml
  - type: FinOps
    url: finops/joke-api-finops.yml
common:
- type: DomainSecurity
  url: security/joke-api-domain-security.yml
- type: Website
  url: https://jokeapi.dev/
- type: Documentation
  url: https://jokeapi.dev/
- type: GitHubOrg
  url: https://github.com/Sv443-Network
- type: StatusPage
  url: https://status.sv443.net/
- type: Plans
  url: plans/joke-api-plans-pricing.yml
- type: RateLimits
  url: rate-limits/joke-api-rate-limits.yml
- type: FinOps
  url: finops/joke-api-finops.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com

JokeAPI

Kin Score

APIs 1

JokeAPI

Pricing Plans 1

Joke Api Plans Pricing

Rate Limits 1

Joke Api Rate Limits

FinOps 1

Joke Api Finops

Security Posture 1

Joke Api Domain Security

Resources

Documentation 1

Build 1

Access & Security 1

Operate 2

Commercial 2

Company 1

Source (apis.yml)