eklavyadev / karljoke

A free and open-source API to fetch dad-jokes

KarlJoke

NOTE:- OUTDATED API, CURRENTLY INACTIVE. PLEASE MOVE TO https://github.com/15Dkatz/official_joke_api

A free and open-source API to fetch dadjokes

Inspired from https://github.com/15Dkatz/official_joke_api

Since the creators are not accepting PRs' and also the server is unavailable, we have a new system in place as an alternative 🚀

Public Endpoints

Get a random joke

  GET /jokes/random

Get ten random jokes

  GET /jokes/ten

Get number of random jokes

  GET /jokes/{number}

Parameter	Type	Description
number	int	Required. Number of jokes to fetch

Get random joke by type

  GET /jokes/{type}/random

Parameter	Type	Description
type	string	Required. Category of joke

Get number of random jokes by type

  GET /jokes/{type}/{number}

Parameter	Type	Description
type	string	Required. Category of joke
number	int	Required. Number of jokes to fetch

Authors

• Eklavya Chandra

Contributing

Contributions are always welcome!

Implement jokes.json with this structure

},
{
  "id": last joke id + 1,
  "type": "Your category here",
  "setup": "Your joke here",
  "punchline": "Your punchline here"
}

Please adhere to this project's code of conduct.

Run Locally

Clone the project

  git clone https://github.com/eklavyadev/karljoke.git

Go to the project directory

  cd karljoke

Install dependencies

  npm install

Start the server

  npm run start