APIHub
Back to Explore

Jokes One

Offers REST endpoints to fetch the joke of the day (optionally filtered by category) and its category list, as well as to retrieve, search, and manage jokes—including random jokes and CRUD operations—in a user's private collection.

Games & Comics
apiKey
HTTPS
CORS: Yes
Description enriched
Visit official documentation

Latency

1944ms p95

Uptime

100.0% 30d

Playground

Verified

live

Endpoints

REST · JSON
PATCH

/joke

Update a joke

  • id (query, required) — Joke ID
  • title (query) — title
  • text (query) — text
  • author (query) — Joke Author
  • tags (query) — Comma Separated tags
GET

/jod

Gets `Joke of the Day`. Optional `category` param determines the category of returned joke of the day

  • category (query) — JOD Category
GET

/jod/categories

Gets a list of `Joke of the Day` Categories.

DELETE

/joke

Delete a joke. The user needs to be the owner of the joke to be able to delete it.

  • id (query, required) — Joke ID
GET

/joke

Gets a `Joke` with a given `id`.

  • id (query) — Joke ID
PUT

/joke

Add a new joke to your private collection.

  • title (query, required) — Joke Title
  • text (query, required) — Joke Text
  • author (query) — Joke Author
  • tags (query) — Comma Separated tags
GET

/joke/categories/search

Gets a list of `Joke` Categories, based on a query term.

  • query (query, required) — Search Query
  • start (query) — Response is paged. This parameter controls where response starts the listing at
GET

/joke/list

Get the list of jokes in your private collection.

  • start (query) — Response is paged. This parameter controls where response starts the listing at
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 searching for the joke.

  • category (query) — Joke Category
  • query (query) — keyword to search for in the joke
  • minlength (query) — Joke minimum Length
  • maxlength (query) — Joke maximum Length
  • author (query) — Joke Author
  • private (query) — Should search private collection? Default searches public collection.
POST

/joke/tags/add

Add a tag to a given Joke.

  • id (query, required) — Joke ID
  • tags (query, required) — Comma Separated tags
POST

/joke/tags/remove

Remove a tag from a given joke.

  • id (query, required) — Joke ID
  • tags (query, required) — Comma Separated tags

12 endpoints auto-detected

Authentication

This API requires authentication: apiKey.

curl -X PATCH \
  "https://jokes.one/api/joke//joke"

jokes.one · HTTPS only