Skip to content
Official Joke API!
JavaScript
Branch: master
Clone or download
Pull request Compare This branch is even with 15Dkatz:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
jokes
.gcloudignore
.gitignore
.npmignore
README.md
app.yaml
handler.js
index.js
package-lock.json
package.json
test.js

README.md

Official Joke API

Endpoints:

Grab a random joke!

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

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

Grab ten random jokes!

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

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

Grab jokes by type!

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

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

https://official-joke-api.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!
You can’t perform that action at this time.