README.md 8.7 KB
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.
[](https://status.sv443.net/) [](https://snyk.io/test/github/Sv443-Network/JokeAPI) [](https://sv443.net/LICENSE)
[](https://dc.sv443.net/) [](https://github.com/Sv443-Network/JokeAPI/issues) [](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?blacklistFlagsand?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.[!NOTE]
If you want to contribute to JokeAPI (code, jokes or translations), please refer to the contributing guide.
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:
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)