Joke of the day and large category of jokes accessible via REST API
Last verified: November 12, 2026
100% uptime: the documentation responded in 5 of 5 checks over the last 30 days. Median response time: 146 ms.
From Jokes One's OpenAPI specification (version 1.1), spec updated June 21, 2021, via APIs.guru.
Jokes One API offers a complete feature rich REST API access to its jokes platform. This is the documentation for the world famous jokes API. If you are a subscriber and you are trying this from a console add 'X-JokesOne-Api-Secret' header and add your api key as the header value. You can test and play with the API right here on this web page. For using the private end points and subscribing to the API please visit https://jokes.one/api/joke/.
Buy me a coffee
https://api.jokes.one| Method | Path | What it does |
|---|---|---|
| GET | /jod | Gets Joke of the Day . Optional category param determines the category of returned joke of the day |
| GET | /jod/categories | Gets a list of Joke of the Day Categories. |
| GET | /joke | Gets a Joke with a given id . |
| PUT | /joke | Add a new joke to your private collection. |
| PATCH | /joke | Update a joke |
| DELETE | /joke | Delete a joke. The user needs to be the owner of the joke to be able to delete it. |
| GET | /joke/categories/search | Gets a list of Joke Categories, based on a query term. |
| GET | /joke/list | Get the list of jokes in your private collection. |
| GET | /joke/random | Gets a Random Joke . When you are in a hurry this is what you call to get a random famous joke. |
| GET | /joke/search | Search for a Joke in Jokes One platform. Optional category , author , minlength , maxlength params determines the filters applied while sear… |
| POST | /joke/tags/add | Add a tag to a given Joke. |
| POST | /joke/tags/remove | Remove a tag from a given joke. |