FreeAPIHub
HomeAPIsAI ModelsAI ToolsBlog
Favorites
FreeAPIHub

The central hub for discovering, testing, and integrating the world's best AI models and APIs.

Platform

  • Categories
  • AI Models
  • APIs

Company

  • About Us
  • Contact
  • FAQ

Help

  • Terms of Service
  • Privacy Policy
  • Cookies

© 2026 FreeAPIHub. All rights reserved.

GitHubTwitterLinkedIn
  1. Home
  2. Categories
  3. Fun & Entertainment
  4. JokeAPI
published

JokeAPI

JokeAPI offers developers a free, categorized jokes API suitable for applications like chatbots and websites without the need for authentication.

Developed by Sv443

Live API
99.90%Uptime
150msLatency
4.1kStars
No AuthAuth
NoCredit Card
RESTStyle
v2Version

Reference

API Endpoints

Endpoints

Available routes, request structures, and code examples.

Returns a random joke from all categories

Endpoint URL
https://v2.jokeapi.dev/Any
Code Example
curl -X GET 'https://v2.jokeapi.dev/Any'
Request Payload
{
  "safe-mode": true
}
Expected Response
{
  "type": "twopart",
  "setup": "Why do programmers prefer dark mode?",
  "category": "Programming",
  "delivery": "Because light attracts bugs!"
}
Version:v2

Integration

Quick Start

cURL ExampleREST
curl -X GET "https://v2.jokeapi.dev/joke/Programming"

Docs

Technical Documentation

What this API does

JokeAPI is a flexible and open-source API that delivers jokes across various categories including programming, general, pun, spooky, and dark humor. It provides advanced filtering options that allow developers to blacklist certain types of content to ensure suitability for their audience. The API supports multiple joke formats such as single-line and two-part jokes, facilitating diverse integration into applications.

How it works

Developers can access jokes by sending simple HTTP GET requests to the API. The API allows fetching jokes based on categories, enabling specific jokes tailored to user preferences. The responses are in JSON format, making it straightforward to integrate with various programming environments.

Authentication

No authentication is required to use JokeAPI. Developers can start making requests immediately, allowing for quick integration in applications without the overhead of handling API keys.

Example usage

  • /joke/Programming - Retrieves a programming joke.
  • /joke/Spooky - Fetches a spooky joke.
  • /joke/Any?blacklistFlags=nsfw,religious - Retrieves a joke while excluding NSFW and religious jokes.

Limits

JokeAPI allows up to 120 requests per minute, enabling developers to implement jokes into their applications efficiently.

Ideal use cases

  • Developing chatbots for platforms like Slack or Discord.
  • Creating engaging web applications that require humor.
  • Integrating jokes in mobile applications for entertainment.
  • Providing a humor feature in online games or interactive platforms.

Examples

Real-World Applications

  • Integrating jokes into Slack and Discord chatbots for engaging and entertaining conversations.
  • Building humor sections in web and mobile apps using diverse joke categories.
  • Adding dynamic funny content to community forums and social media platforms.
  • Creating lighthearted notification messages within developer tools or IDE extensions.

Evaluation

Advantages & Limitations

Advantages
  • ✓ No signup or API key required for immediate access.
  • ✓ Wide range of joke categories with flexible filtering options.
  • ✓ Supports content safety flags to exclude inappropriate jokes.
  • ✓ Simple JSON responses enable easy integration in most programming environments.
Limitations
  • ✗ Rate limit of 120 requests per minute may restrict very high volume applications.
  • ✗ No support for XML or other response formats besides JSON.
  • ✗ Lacks official SDKs which means developers must implement API calls themselves.
  • ✗ No authentication could limit fine-grained usage control or analytics.

Support

Frequently Asked Questions

Important Notice

Verify Before You Decide

Last verified · Apr 30, 2026

The details on this page — including pricing, features, and availability — are based on our last review and may not reflect the provider's current offering. Providers update their products frequently, sometimes without prior notice.

What may have changed

Pricing Plans
Features & Limits
Availability
Terms & Policies

Always visit the official provider website to confirm the latest pricing, terms, and feature availability before subscribing or integrating.

Check official site

External Resources

Documentation Official Website Pricing Details Postman Collection

API Specifications

v2
Pricing Model
Free
Credit Card
Not Required
Response Formats
JSON
Supported Languages
8 Languages
SDK Support
REST Only
Rate Limit

120 requests per minute

Time to Hello World

Less than 5 minutes

Free Tier

Free usage with up to 120 requests per minute and no signup required.

Best For

Developers building fun chatbot integrations and entertainment apps seeking easy access to categorized jokes.

Not Ideal For

Enterprise applications requiring strict content control or high request volumes beyond 120 rpm.

Tags

#programming-jokes#jokeapi#bots#no-auth#free-api#entertainment#jokes#fun

You Might Also Like

More APIs Similar to JokeAPI

Giphy API

The Giphy API provides developers with access to over 10 billion GIFs and stickers, facilitating easy integration of animated content into various applications.

PublicREST

Studio Ghibli API

The Studio Ghibli API provides free and open access to extensive datasets from Studio Ghibli films, suitable for developers building applications related to Ghibli content.

publicREST

TVMaze API

The TVMaze API provides developers with free access to over 25,000 TV shows, including episode schedules, cast, crew, and ratings data, making it suitable for TV tracking applications.

PublicREST