Chuck Norris Joke API - grjug/ChuckNorrisJokes GitHub Wiki

Operations

Categories

This operation returns a list of joke categories available through the joke API.

Joke list size

This operation returns the total number of jokes available through this API.

Get a joke by id

This operation returns a single job by the joke id passed in.

  • URL: http://api.icndb.com/jokes/<joke id>
  • Response:
    { "type": "success", "value": { "id": 15, "joke": "When Chuck Norris goes to donate blood, he
    declines the syringe, and instead requests a hand gun and a bucket.", "categories": [] } }

Fetching a random joke

This operation returns one or more random jokes

Single joke

  • URL: http://api.icndb.com/jokes/random
  • Sample Response:
    { "type": "success", "value": { "id": 340, "joke": "A man once claimed Chuck Norris
    kicked his ass twice, but it was promptly dismissed as false - no one could survive it the first time.",
    "categories": [] } }

Multiple jokes

  • URL: http://api.icndb.com/jokes/random/<number of jokes>
  • Sample Response:
    { "type": "success", "value": [ { "id": 507, "joke": "Chuck Norris can install iTunes
    without installing Quicktime.", "categories": ["nerdy"] }, { "id": 97, "joke": "Chuck Norris doesn't throw up if
    he drinks too much. Chuck Norris throws down!", "categories": [] }, { "id": 424, "joke": "Chuck Norris has
    volunteered to remain on earth after the Rapture; he will spend his time fighting the Anti-Christ.",
    "categories": [] } ]  }
⚠️ **GitHub.com Fallback** ⚠️