https://github.com/Sv443-Network/JokeAPI
REST API that serves uniformly and well formatted jokes in JSON, XML, YAML or plain text format that also offers a great variety of filtering methods
https://github.com/Sv443-Network/JokeAPI
api entertainment humor humor-api joke jokes jokes-api js json rest-api restful-api xml yaml
Last synced: 13 days ago
JSON representation
REST API that serves uniformly and well formatted jokes in JSON, XML, YAML or plain text format that also offers a great variety of filtering methods
- Host: GitHub
- URL: https://github.com/Sv443-Network/JokeAPI
- Owner: Sv443-Network
- License: mit
- Created: 2019-03-19T11:10:57.000Z (about 6 years ago)
- Default Branch: main
- Last Pushed: 2024-05-27T13:56:22.000Z (12 months ago)
- Last Synced: 2024-06-20T09:12:19.179Z (11 months ago)
- Topics: api, entertainment, humor, humor-api, joke, jokes, jokes-api, js, json, rest-api, restful-api, xml, yaml
- Language: TypeScript
- Homepage: https://v2.jokeapi.dev
- Size: 8.86 MB
- Stars: 233
- Watchers: 5
- Forks: 44
- Open Issues: 55
-
Metadata Files:
- Readme: README.md
- Changelog: changelog.md
- Contributing: .github/Contributing.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt
- Code of conduct: .github/Code_of_Conduct.md
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
# The code in this repo moved
The latest source code of JokeAPI lives on my own Git server for now: https://git.sv443.net/sv443/JokeAPI-v2
If you have any issues, please still use this repository on GitHub to submit them.
For pull requests however, please use the new repo.
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 [`?blacklistFlags`](https://jokeapi.dev/#flags-param) and [`?safe-mode`](https://jokeapi.dev/#safe-mode).
> Still, use this API at your own risk!
> [!NOTE]
> JokeAPI is free to use, so it relies on donations to cover the costs.
> If you enjoy using it, [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)
> Also make sure to use 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)