Jokes One API

by jokes.one

Overview

Joke of the day and large category of jokes accessible via REST API

Jokes One is a games & comics API from jokes.one. Requests are authenticated with an API key. It is served over HTTPS and allows browser requests (CORS). Its OpenAPI description documents 12 endpoints.

At a glance

Authentication: API key
HTTPS: Yes
CORS: Yes
Category: Games & Comics
Base URL: https://api.jokes.one
Version: 1.1
Endpoints: 12
OpenAPI: Specification ↗
Spec updated: 2021-06-21

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL

curl -X GET "https://api.jokes.one/jod" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript

const response = await fetch("https://api.jokes.one/jod", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
  },
});
const data = await response.json();
console.log(data);

Python

import requests

response = requests.request(
    "GET",
    "https://api.jokes.one/jod",
    headers={
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
    },
    timeout=30,
)
print(response.json())

Endpoints

Method	Path	What it does
GET	`/jod`	Gets `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 searching for th
POST	`/joke/tags/add`	Add a tag to a given Joke.
POST	`/joke/tags/remove`	Remove a tag from a given joke.