The Joke API

How to Use This API

1. Random Programming Joke (Single Line)

https://v2.jokeapi.dev/joke/Programming?type=single

Returns a single programming joke. Example: {"joke":"There are only 10 kinds of people in this world: those who know binary and those who don't.","safe":true}

2. Two-Part Joke (Setup + Delivery)

https://v2.jokeapi.dev/joke/Programming?type=twopart

Returns {"setup":"Why do programmers prefer dark mode?","delivery":"Because light attracts bugs."}

3. Safe Jokes Only (No NSFW)

https://v2.jokeapi.dev/joke/Any?safe-mode

Filters out dark, NSFW, religious, political, and racist jokes. Great for public-facing displays.

4. JavaScript — Random Joke Button

async function getJoke(category = 'Programming') {
  const resp = await fetch(
    `https://v2.jokeapi.dev/joke/${category}?safe-mode`
  );
  const joke = await resp.json();
  
  if (joke.type === 'single') {
    return joke.joke;
  } else {
    return `${joke.setup} ... ${joke.delivery}`;
  }
}

document.getElementById('joke-btn').onclick = async () => {
  document.getElementById('joke-display').textContent =
    await getJoke('Programming');
};

5. Python — Multi-Category Joke Fetcher

import requests

def get_joke(categories='Programming', safe=True):
    url = f'https://v2.jokeapi.dev/joke/{categories}'
    params = {'safe-mode': ''} if safe else {}
    params['type'] = 'single'
    resp = requests.get(url, params=params)
    data = resp.json()
    
    if data['type'] == 'single':
        return data['joke']
    else:
        return f"{data['setup']}\n{data['delivery']}"

# Get a few programming jokes
for i in range(3):
    print(f"Joke {i+1}: {get_joke()}\n")