icanhazdadjoke API

Base URL

https://icanhazdadjoke.com

Authentication

No key. The maintainer asks that you send a descriptive User-Agent with a contact URL.

Rate limit

No published limit; fair use expected.

Pricing

Free.

CORS

Enabled — callable directly from browser JavaScript

Official docs

Read the docs

Every request below was executed against the live API on 19 Aug 2026, and the response shown is the real body it returned — not an illustration.

curl 'https://icanhazdadjoke.com/' \
  -H 'Accept: application/json'

const res = await fetch("https://icanhazdadjoke.com/", {
  headers: {
    "Accept": "application/json",
  },
});
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

import requests

headers = {
    "Accept": "application/json",
}

res = requests.get("https://icanhazdadjoke.com/", headers=headers, timeout=20)
res.raise_for_status()
print(res.json())

{
  "id": "wXDIB5h3wc",
  "joke": "I used to have a job at a calendar factory but I got the sack because I took a couple of days off.",
  "status": 200
}

idstring

Joke identifier, usable with /j/{id} to fetch it again.

jokestring

The joke text as a single string — no setup/punchline split.

statusinteger

HTTP status echoed in the body.

• Teach HTTP content negotiation with a single memorable example
• Add a random joke command to a Slack or Discord bot
• Search a joke corpus by keyword with the /search endpoint
• Generate joke images for social posts using the image representation

If icanhazdadjoke does not fit, these entertainment apis cover similar ground. Every one was called before publishing, and each links to its own reference page with a working curl command and the response it returned.