How to hit the Chuck Norris Jokes API

api.chucknorris.io serves hand-curated Chuck Norris facts: random, by category, or by full-text search.

Authentication

None — no key, no signup. Every example runs as-is.

Full reference: https://api.chucknorris.io/

Random joke

curl https://api.chucknorris.io/jokes/random
Run in PostTaco
Example response (trimmed)
{
  "categories": [],
  "created_at": "2020-01-05 13:42:20.568859",
  "icon_url": "https://api.chucknorris.io/img/avatar/chuck-norris.png",
  "id": "qF6bzfl3QF6i-hik0dhnng",
  "updated_at": "2020-01-05 13:42:20.568859",
  "url": "https://api.chucknorris.io/jokes/qF6bzfl3QF6i-hik0dhnng",
  "value": "Chuck Norris goes bob-sledding in a coffin. It's the only time he can get some private time on the snow fields to have his threesomes."
}

Random joke from a category

See the categories call for the list.

curl "https://api.chucknorris.io/jokes/random?category=dev"
Run in PostTaco
Example response (trimmed)
{
  "categories": [
    "dev"
  ],
  "created_at": "2020-01-05 13:42:19.324003",
  "icon_url": "https://api.chucknorris.io/img/avatar/chuck-norris.png",
  "id": "1jgggc4rruety6zvlvb5ag",
  "updated_at": "2020-01-05 13:42:19.324003",
  "url": "https://api.chucknorris.io/jokes/1jgggc4rruety6zvlvb5ag",
  "value": "Google won't search for Chuck Norris because it knows you don't find Chuck Norris, he finds you."
}

List categories

curl https://api.chucknorris.io/jokes/categories
Run in PostTaco
Example response (trimmed)
[
  "animal",
  "career"
]