Save over 30% when you subscribe to an annual subscription plan!

Jokes API

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

Please note: The jokes returned by this API are not all safe for work (SFW). If you need family-friendly or workplace-safe jokes, please use our Dad Jokes API.

Available endpoints:

/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.

/v1/jokeoftheday GET

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

Returns a single joke for the current day. The same joke is returned for all requests on the same day, and changes each day. Perfect for displaying on your website or app. No parameters are available for this endpoint to ensure everyone sees the same joke of the day.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

Same response format as /v1/jokes (always returns a single joke)

Sample Request Live Demo!

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

Headers

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

Sample Response

JSON
1 2 3 4 5 [ { "joke": "Why did the scarecrow win an award? He was outstanding in his field." } ]

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/jokeoftheday" \ -H "X-Api-Key: YOUR_API_KEY"