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: 3 months 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 (over 5 years ago)
• Default Branch: main
• Last Pushed: 2024-05-27T13:56:22.000Z (6 months ago)
• Last Synced: 2024-06-20T09:12:19.179Z (5 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

        


# [![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.](./.github/Contributing.md)





# 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](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/JokeAPI_ComputerCraft)                                  | [Sv443](https://github.com/Sv443)                          |

| [Dev Dad Jokes](https://github.com/jonathanbossenger/devdadjokes)                                        | [Jonathan Bossenger](https://github.com/jonathanbossenger) |




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)