Random Joke

This is a simple API that returns a random joke. You can filter the jokes by tags and keywords. To make sure they are safe for work, you could use the exclude-tags parameter to exclude jokes with certain tags such as "nsfw" or "religious".

If you want to filter the jokes using include-tags or exclude-tags you can use one or more of the following:

This API wraps the random jokes endpoint by Humor API. Check out the tutorial about writing a joke and meme app using this API.

  • animal
  • clean
  • one_liner
  • food
  • sexual
  • relationship
  • religious
  • racist
  • sport
  • kids
  • holiday
  • knock_knock
  • nerdy
  • law
  • political
  • q_a
  • school
  • christmas
  • chuck_norris
  • dark
  • nsfw
  • analogy
  • jewish
  • yo_mama
  • sexist
  • blondes
  • deep_thoughts
  • insults
  • animal
  • clean
  • one_liner
  • food
  • sexual
  • relationship
  • religious
  • racist
  • sport
  • kids
  • holiday
  • knock_knock
  • nerdy
  • law
  • political
  • q_a
  • school
  • christmas
  • chuck_norris
  • dark
  • nsfw
  • analogy
  • jewish
  • yo_mama
  • sexist
  • blondes
  • deep_thoughts
  • insults
GET
https://api.apileague.com/retrieve-random-joke
Example Request and Response
GET
https://api.apileague.com/{{ examples.getRandomJoke }}
{
    "joke": "What do you call a boxing match between two aardvarks?\nA snout bout!"
}
cURL
Java
Javascript
Python
Go
C#
 {{ codeCopyText }}
 {{ codeCopyText }}
 {{ codeCopyText }}
 {{ codeCopyText }}
 {{ codeCopyText }}
 {{ codeCopyText }}