Data

Random setup/punchline joke (official-joke-api) API

Return a random setup-and-punchline joke, optionally filtered by type, from the official-joke-api. Answers 'tell me a joke','a programming joke','a knock-knock joke','give me a general joke'.

Price$0.01per request

MethodPOST

Route/v1/data/misc-joke

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

datajokehumorprogrammingofficial-joke-apifunpunchlinebot

API URLhttps://x402.hexl.dev/v1/data/misc-joke

Integration docs

Example request

{
  "type": "programming"
}

Example response

{
  "id": 1,
  "type": "programming",
  "setup": "Why do programmers prefer dark mode?",
  "punchline": "Because light attracts bugs.",
  "full": "Why do programmers prefer dark mode? Because light attracts bugs."
}

Input schema

{
  "type": "object",
  "required": [],
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "general",
        "programming",
        "knock-knock",
        "dad"
      ],
      "examples": [
        "programming"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}