JokeAPI

> Documentation • Try it out • Changelog • Discord Server <

A free and open REST API that delivers consistently formatted jokes in JSON, XML, YAML, or plain text. Powerful filters allow you to get just the jokes you want - no sign-up needed. Comes with CORS support.
[![API uptime the last 7 days](https://img.shields.io/uptimerobot/ratio/7/m784261094-bff76b959ebb8fc39f7eb2d0)](https://status.sv443.net/) [![Known vulnerabilities](https://snyk.io/test/github/Sv443-Network/JokeAPI/badge.svg)](https://snyk.io/test/github/Sv443-Network/JokeAPI) [![License on GitHub](https://img.shields.io/github/license/Sv443-Network/JokeAPI)](https://sv443.net/LICENSE) [![Join the Discord server](https://badgen.net/discord/online-members/aBH4uRG?icon=discord)](https://dc.sv443.net/) [![Open issueson GitHub](https://img.shields.io/github/issues/Sv443-Network/JokeAPI)](https://github.com/Sv443-Network/JokeAPI/issues) [![GitHub stargazers](https://img.shields.io/github/stars/Sv443-Network/JokeAPI?style=social)](https://github.com/Sv443-Network/JokeAPI/stargazers)

> [!WARNING] > JokeAPI contains a very wide variety of jokes, some of which can be seen as quite offensive. > They can be reliably filtered out using the parameters [`?blacklistFlags`](https://jokeapi.dev/#flags-param) and [`?safe-mode`](https://jokeapi.dev/#safe-mode). > Still, use this API at your own risk! > [!NOTE] > Enjoying JokeAPI? It's free to use, but if you want to support the development, [please consider supporting the development.](https://github.com/sponsors/Sv443) > [!NOTE] > If you want to contribute to JokeAPI (code, jokes or translations), please refer to the [contributing guide.](./.github/Contributing.md) > For code contributions, please refer to the repo at https://git.sv443.net/sv443/JokeAPI-v2
## Community-made wrapper libraries: - C# - Dart - Go - Java (com.github.the-codeboy.Jokes4J) - Java (com.simtechdata.jokeapi) - Kotlin, Java & Android (net.thauvin.erik.jokeapi) - Java (uz.khurozov.jokeapi-java) - Node.js - Odin - PHP - Python - Rust - TypeScript
## Some projects that use JokeAPI: | Project | Author | | -------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- | | [dozens Advices](https://github.com/ZephyrVentum/dozens-Advices) | [ZephyrVentum](https://github.com/ZephyrVentum) | | [Shadow](https://github.com/QGIsK/Shadow) | [QGIsK](https://github.com/QGIsK) | | [Jokepy](https://github.com/aksty/Jokepy) | [aksty](https://github.com/aksty) | | [Dark1](https://github.com/whiteadi/Dark1) | [whiteadi](https://github.com/whiteadi) | | [Prejudice Networks](https://github.com/LiamTownsley/Prejudice-Networks) | [Liam Townsley](https://github.com/LiamTownsley) | | [https://irshad.ml/humour.html](https://irshad.ml/humour.html) | [draco-malfoy](https://github.com/draco-malfoy) | | [Random Joke Generator with Flutter](https://github.com/variousnabil/Random-Joke-Generator-with-Flutter) | [variousnabil](https://github.com/variousnabil) | | [comma](https://thatcopy.pw/comma) | [ThatCopy](https://github.com/ThatCopy) | | [Joke Teller](https://github.com/AlHood77/Joke_Teller) | [AlHood77](https://github.com/AlHood77) | | [Jokes plugin for Craft CMS 3.x](https://github.com/remcoov/jokes) | [remcoov](https://github.com/remcoov) | | [PoshBot.Joker](https://github.com/ToastIT-dev/PoshBot.Joker) | [ToastIT-dev](https://github.com/ToastIT-dev) | | [JokeAPI_ComputerCraft](https://github.com/Sv443-Network/JokeAPI_ComputerCraft) | [Sv443](https://github.com/Sv443) | | [Dev Dad Jokes](https://github.com/jonathanbossenger/devdadjokes) | [Jonathan Bossenger](https://github.com/jonathanbossenger) |

Made with ❤️ by [Sv443](https://github.com/Sv443) and [contributors](https://github.com/Sv443-Network/JokeAPI/graphs/contributors) Like JokeAPI? Please consider [supporting the development](https://github.com/sponsors/Sv443)