search

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://v2.jokeapi.dev
MIT License
248 stars 46 forks source link
api entertainment humor humor-api joke jokes jokes-api js json rest-api restful-api xml yaml

readme

# The code in this repo moved What you see in this repo is very outdated code and is probably not going to run. The latest source code of JokeAPI now lives on my own Git server: 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.




# [![icon](https://sv443.net/cdn/jokeapi/icon_readme.png)](#readme)
JokeAPI ### A REST API that serves uniformly and well formatted jokes and offers a great variety of filtering methods and response customization [![GitHub](https://img.shields.io/github/license/Sv443/JokeAPI)](https://sv443.net/LICENSE) [![Uptime / 7 Days](https://img.shields.io/uptimerobot/ratio/7/m784261094-bff76b959ebb8fc39f7eb2d0)](https://status.sv443.net/) [![Open Issues](https://img.shields.io/github/issues/Sv443/JokeAPI)](https://github.com/Sv443/JokeAPI/issues) [![Actions Status](https://github.com/Sv443/JokeAPI/workflows/build/badge.svg)](https://github.com/Sv443/JokeAPI/actions) [![Known Vulnerabilities](https://snyk.io/test/github/Sv443/JokeAPI/badge.svg)](https://snyk.io/test/github/Sv443/JokeAPI) [![Discord](https://img.shields.io/discord/565933531214118942)](https://discord.gg/aBH4uRG) [![GitHub stars](https://img.shields.io/github/stars/Sv443/JokeAPI?style=social)](https://github.com/Sv443/JokeAPI/stargazers)

# [Documentation](https://jokeapi.dev/) ## [Try it out](https://jokeapi.dev/#try-it) • [Changelog](./changelog.md) • [Discord Server](https://dc.sv443.net/)



Note: due to the different types of humor, JokeAPI contains a wide variety of jokes, of which some are very offensive. They can be filtered out using the ?blacklistFlags or ?safe-mode parameters, but use this API at your own risk!

If you want to contribute to JokeAPI (code, jokes or translations), please refer to the contributing guide.



Community-made wrapper libraries:

- Rust - Python - Node.js - Dart - Go - Java (com.simtechdata.jokeapi) - Java (uz.khurozov.jokeapi-java) - Kotlin, Java & Android - Jokes4J - C#


Projects that use JokeAPI:

Project Author
dozens Advices ZephyrVentum
Shadow QGIsK
Jokepy aksty
Dark1 whiteadi
Prejudice Networks Liam Townsley
https://irshad.ml/humour.html draco-malfoy
Random Joke Generator with Flutter variousnabil
comma ThatCopy
Joke Teller AlHood77
Jokes plugin for Craft CMS 3.x remcoov
PoshBot.Joker ToastIT-dev
JokeAPI_ComputerCraft Sv443
Dev Dad Jokes Jonathan Bossenger


Project submissions are paused for the foreseeable future.



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