Jokes One API

jokes · Media

Media No Auth Free & Open entertainment

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](https://jokes.one/api/joke/). 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/.

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET GET /jod

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

https://api.apis.guru/v2/specs/jokes.one/1.1/jod?category=example

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/jokes.one/1.1/jod?category=example"

import requests
params = {
    "category": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/jokes.one/1.1/jod",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/jokes.one/1.1/jod');
url.searchParams.set('category', 'example');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/jokes.one/1.1/jod")
	q := baseURL.Query()
	q.Set("category", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/jokes.one/1.1/jod")
uri.query = URI.encode_www_form({
  "category" => "example"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/jokes.one/1.1/jod?" . http_build_query([
    "category" => "example"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET GET /joke

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

https://api.apis.guru/v2/specs/jokes.one/1.1/joke?id=1

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/jokes.one/1.1/joke?id=1"

import requests
params = {
    "id": "1"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/jokes.one/1.1/joke",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/jokes.one/1.1/joke');
url.searchParams.set('id', '1');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/jokes.one/1.1/joke")
	q := baseURL.Query()
	q.Set("id", "1")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/jokes.one/1.1/joke")
uri.query = URI.encode_www_form({
  "id" => "1"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/jokes.one/1.1/joke?" . http_build_query([
    "id" => "1"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET GET /joke/list

Get the list of jokes in your private collection.

https://api.apis.guru/v2/specs/jokes.one/1.1/joke/list?start=0

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/jokes.one/1.1/joke/list?start=0"

import requests
params = {
    "start": "0"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/jokes.one/1.1/joke/list",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/jokes.one/1.1/joke/list');
url.searchParams.set('start', '0');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/jokes.one/1.1/joke/list")
	q := baseURL.Query()
	q.Set("start", "0")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/jokes.one/1.1/joke/list")
uri.query = URI.encode_www_form({
  "start" => "0"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/jokes.one/1.1/joke/list?" . http_build_query([
    "start" => "0"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

See official documentation for authentication and setup.

What can you build with Jokes One API?

Jokes One API is a Media API. Developers commonly use media APIs for:

storing and delivering images, video, and audio
building digital asset management and media libraries
transcoding and optimising media for the web
adding video streaming and playback to your app
automating content tagging and metadata extraction

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Jokes One API is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide · Learn about API keys · What is REST?

Open documentation ↗