NewConnect Claude, Gemini, ChatGPT, and other AI agents to API Ninjas via our MCP server →

Jokes API

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

Available endpoints:

(4.4)

From 4,313 users

3,400+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
283ms318ms355ms629ms1005ms

Didn't find what you were looking for? Suggest an improvement

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

Response

A JSON array of objects, each containing the following field, or an error if the request is unsuccessful.

  • joke  string

    The joke text.

Sample Request Live Demo!

limit

Try our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

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

Headers

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

Sample Response

JSON
[
    {
      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), or an error if the request is unsuccessful.

Sample Request Live Demo!

Try our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

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

Headers

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

Sample Response

JSON
[
    {
      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"

Frequently Asked Questions

  • Yes, but you must have a premium subscription. Commercial use of the Jokes API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
  • Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
  • Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
  • The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
  • The /v1/jokes endpoint returns one or more random jokes and accepts an optional limit parameter, while /v1/jokeoftheday returns a single joke that stays the same for all requests on a given day and changes daily. If you want similar daily comedy content, compare with our Dad Jokes API.
  • Use the limit parameter on the /v1/jokes endpoint, which can be set between 1 and 100 (default is 1); note that limit is a premium-only feature, so check our pricing page for access.
  • Both endpoints return a JSON array of objects, each containing a single joke string field with the joke text, or an error if the request is unsuccessful. For more comedy content, see the related Chuck Norris API and Riddles API.
  • The Jokes API covers topics like pop culture, science, and history, with free users having access to 100 jokes and premium users getting access to over 20,000 jokes. Review the tiers on our pricing page or browse more options in the API catalog.