Official Joke API

Endpoints:

Grab a random joke!

https://official-joke-api.wl.r.appspot.com/random_joke

https://official-joke-api.wl.r.appspot.com/jokes/random

Grab your number choice of random jokes!

https://official-joke-api.appspot.com/jokes/random/10 Replace 10 with your choices number. For example, for 50 random jokes, go to: https://official-joke-api.appspot.com/jokes/random/50

The number may not go over the number of jokes that are available inside the jokes API. In that scenario the request will be an error.

Grab ten random jokes!

https://official-joke-api.wl.r.appspot.com/random_ten

https://official-joke-api.wl.r.appspot.com/jokes/ten

Grab jokes by type!

The endpoints are jokes/:type/random or jokes/:type/ten. For example:

https://official-joke-api.wl.r.appspot.com/jokes/programming/random

https://official-joke-api.wl.r.appspot.com/jokes/programming/ten

How these jokes were collected

The majority of these jokes were contributed by joke-loving coders around the world!

Make a contribution!

Submit a Pull Request, with your joke added to the jokes/index.json file. Make sure the joke is in this format:

{
  "id": last joke id + 1,
  "type": "programming",
  "setup": "What's the best thing about a Boolean?",
  "punchline": "Even if you're wrong, you're only off by a bit."
}

Run Locally

Clone the repo
npm i && npm run dev
Visit localhost:3005/jokes/random or localhost:3005/jokes/ten on your browser!

rufai / official_joke_api