Jokes API

The Jokes API provides funny jokes from the Internet about pop culture, science, history, and other awesome topics.

/v1/jokes GET

https://api.api-ninjas.com/v1/jokes

Returns one (or more) random funny jokes. Free users have access to 100 jokes - premium users have access to over 20,000 jokes.

Parameters

  • limit  optional premium only

    How many jokes to return. Must be between 1 and 100. Default is 1.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Sample Request Live Demo!

https://api.api-ninjas.com/v1/jokes

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
1 2 3 4 5 [ { "joke": "When putting cheese in a mousetrap, always leave room for the mouse." } ]

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/jokes?limit=3" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.