{"openapi":"3.1.0","info":{"title":"Chuck Norris Jokes API","version":"1.0.0","description":"The famous Chuck Norris joke collection via the open chucknorris.io API — no key. The random endpoint returns a random Chuck Norris joke and can be filtered to a category (e.g. dev, food, sport, money, science); the categories endpoint lists every available category; and the search endpoint runs a full-text query across the whole collection. Each joke carries its id, text, categories and a permalink. Real jokes, with categories cached for speed — no key. 4 endpoints. Ideal for chatbots, Slack/Discord bots, 404 pages, loading screens and developer-fun easter eggs.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/chucknorris-api","description":"oanor gateway"}],"tags":[{"name":"Jokes"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/categories":{"get":{"operationId":"get_v1_categories","tags":["Jokes"],"summary":"All joke categories","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":16,"categories":["animal","career","celebrity","dev","explicit","fashion","food","history","money","movie","music","political","religion","science","sport","travel"]},"meta":{"timestamp":"2026-06-08T09:48:46.033Z","request_id":"9cc3f04e-84df-43dd-a8b5-1c9e189e651d"},"status":"ok","message":"Categories retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/random":{"get":{"operationId":"get_v1_random","tags":["Jokes"],"summary":"A random joke","description":"","parameters":[{"name":"category","in":"query","required":false,"description":"Category to draw from (see /v1/categories)","schema":{"type":"string"},"example":"dev"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"joke":{"id":"i8k15bwdq4iwpdz3__u8fg","url":"https://api.chucknorris.io/jokes/i8k15bwdq4iwpdz3__u8fg","joke":"Chuck Norris' programs never exit, they terminate.","icon_url":"https://api.chucknorris.io/img/avatar/chuck-norris.png","categories":["dev"]}},"meta":{"timestamp":"2026-06-08T09:48:46.331Z","request_id":"ec848dc9-8de3-43fd-812d-be600977f332"},"status":"ok","message":"Joke retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Jokes"],"summary":"Search the collection","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search query (min 3 chars)","schema":{"type":"string"},"example":"computer"},{"name":"limit","in":"query","required":false,"description":"Max results (1-100, default 20)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"jokes":[{"id":"y-b7g8trr96pfmopdplf4g","url":"https://api.chucknorris.io/jokes/y-b7g8trr96pfmopdplf4g","joke":"Chuck Norris doesn't use a computer because a computer does everything slower than Chuck Norris.","icon_url":"https://api.chucknorris.io/img/avatar/chuck-norris.png","categories":[]},{"id":"AN7_hBUjSW-Fnbn-28jaVQ","url":"https://api.chucknorris.io/jokes/AN7_hBUjSW-Fnbn-28jaVQ","joke":"When Chuck Norris wants cookies, he crashes open a computer.","icon_url":"https://api.chucknorris.io/img/avatar/chuck-norris.png","categories":[]},{"id":"mHaLxKzVRjiBLgE1KhEZ_g","url":"https://api.chucknorris.io/jokes/mHaLxKzVRjiBLgE1KhEZ_g","joke":"Chuck Norris can build a computer with Windows 7.","icon_url":"https://api.chucknorris.io/img/avatar/chuck-norris.png","categories":[]},{"id":"9oOcprOiRh6ucQj0Lr8dHw","url":"https://api.chucknorris.io/jokes/9oOcprOiRh6ucQj0Lr8dHw","joke":"There is no 'ctrl' button on Chuck Norris's computer. Chuck Norris is always in control.","icon_url":"https://api.chucknorris.io/img/avatar/chuck-norris.png","categories":[]},{"id":"rK7dA5D7TZWxY8kpvFRHXQ","url":"https://api.chucknorris.io/jokes/rK7dA5D7TZWxY8kpvFRHXQ","joke":"Chuck Norris can gag you with a horrendous stinch simply by typing the word \"fart\" on his computer keyboard.","icon_url":"https://api.chucknorris.io/img/avatar/chuck-norris.png","categories":[]},{"id":"ImGRzzshSbSsfV-q_k9z_A","url":"https://api.chucknorris.io/jokes/ImGRzzshSbSsfV-q_k9z_A","joke":"Chuck Norris' computer boots up in under 4 seconds. The \"Welcome\" sound is the Walker: Texas Ranger theme song.","icon_url":"https://api.chucknorris.io/img/avatar/chuck-norris.png","categories":[]},{"id":"GMupjWhgSCWlGxhJmNHBww","url":"https://api.chucknorris.io/jokes/GMupjWhgSCWlGxhJmNHBww","joke":"When Steve Jobs booted up his first computer, his background was a picture of Chuck Norris taking a bite out of an apple.","icon_url":"https://api.chucknorris.io/img/avatar/chuck-norris.png","categories":[]},{"id":"_x1zyhYNRsOW9fNKSyD7FA","url":"https://api.chucknorris.io/jokes/_x1zyhYNRsOW9fNKSyD7FA","joke":"The F1 button on Chuck Norris' computer works.","icon_url":"https://api.chucknorris.io/img/avatar/chuck-norris.png","categories":[]},{"id":"p8M1o6MORbmhbYW-990d2w","url":"https://api.chucknorris.io/jokes/p8M1o6MORbmhbYW-990d2w","joke":"Chuck Norris gives computers viruses","icon_url":"https://api.chucknorris.io/img/avatar/chuck-norris.png","categories":[]},{"id":"Fi7I2cQzTeiysPsfHKLCqg","url":"https://api.chucknorris.io/jokes/Fi7I2cQzTeiysPsfHKLCqg","joke":"Chuck Norris once stumbled upon a website with random facts about himself. Although he was flattered, he sent an email to each person who submitted an untrue fact. Upon opening the email, a leather cowboy boot came through each computer screen and roundhouse kicked everyone within a 30 meter radius.","icon_url":"https://api.chucknorris.io/img/avatar/chuck-norris.png","categories":[]},{"id":"KowpxjBZSmSm58hlkkhk7A","url":"https://api.chucknorris.io/jokes/KowpxjBZSmSm58hlkkhk7A","joke":"In every computer game, the final level is Chuck Norris. If you don't beat those before, he does.","icon_url":"https://api.chucknorris.io/img/avatar/chuck-norris.png","categories":[]},{"id":"RxXqiBlkQJK7-fPLvlxllg","url":"https://api.chucknorris.io/jokes/RxXqiBlkQJK7-fPLvlxllg","joke":"Chuck Norris dosnt need a keyboard he tells the computer to write something and it does","icon_url":"https://api.chucknorris.io/img/avatar/chuck-norris.png","categories":[]},{"id":"mEX4q-ycTR2R1bZomiRs4A","url":"https://api.chucknorris.io/jokes/mEX4q-ycTR2R1bZomiRs4A","joke":"Humans start counting from 1. Computers start counting from 0. Chuck Norris starts counting from negative infinity.","icon_url":"https://api.chucknorris.io/img/avatar/chuck-norris.png","categories":[]},{"id":"vK5gw8GVQAuHSiyPyri23g","url":"https://api.chucknorris.io/jokes/vK5gw8GVQAuHSiyPyri23g","joke":"Chuck Norris is so strong, he can roundhouse a bubbled paladin and blow his computer up.","icon_url":"https://api.chucknorris.io/img/avatar/chuck-norris.png","categories":[]},{"id":"gFgcEnubTeO2muXDROgA0w","url":"https://api.chucknorris.io/jokes/gFgcEnubTeO2muXDROgA0w","joke":"Apple Computer was formed in 1976 by Steve Jobs, Steve Wozniak and Chuck Norris. When Steve Jobs suggested they use an apple as their logo, Chuck Norris bit off a chunk of the apple Jobs was holding, including his index and middle fingers. Jobs has prosthetic fingers on his right hand.","icon_url":"https://api.chucknorris.io/img/avatar/chuck-norris.png","categories":[]},{"id":"lbPwoc98Qmu_ewhrZJ3CRg","url":"https://api.chucknorris.io/jokes/lbPwoc98Qmu_ewhrZJ3CRg","joke":"Whenever Chuck Norris watches pornography, his computer gets an erection.","icon_url":"https://api.chucknorris.io/img/avatar/chuck-norris.png","categories":[]},{"id":"F6CxYDlJRv-iy83fa3wKUQ","url":"https://api.chucknorris.io/jokes/F6CxYDlJRv-iy83fa3wKUQ","joke":"Chuck Norris is the only computer system that beats a Mac or a PC. Too bad all it does is round house kicks the user.","icon_url":"https://api.chucknorris.io/img/avatar/chuck-norris.png","categories":[]},{"id":"Ji4dajbjSMOQIOF_btqK-g","url":"https://api.chucknorris.io/jokes/Ji4dajbjSMOQIOF_btqK-g","joke":"Chuck Norris drugged Bill Cosby. Cosby woke up nine hours later in front of his computer, where he realized he just told the net to meme him.","icon_url":"https://api.chucknorris.io/img/avatar/chuck-norris.png","categories":[]},{"id":"P9g3DgctQgyGaEftWsrw7A","url":"https://api.chucknorris.io/jokes/P9g3DgctQgyGaEftWsrw7A","joke":"When Chuck Norris switches on his computer, it skips the bootup process and goes straight to the desktop.","icon_url":"https://api.chucknorris.io/img/avatar/chuck-norris.png","categories":[]},{"id":"D1JcDT75QvqaxlApjlZm5A","url":"https://api.chucknorris.io/jokes/D1JcDT75QvqaxlApjlZm5A","joke":"Chuck Norris can roundhouse kick you over the internet. Even if your computer is turned off. Or you don't have one.","icon_url":"https://api.chucknorris.io/img/avatar/chuck-norris.png","categories":[]}],"query":"computer","total":26},"meta":{"timestamp":"2026-06-08T09:48:46.510Z","request_id":"e517e710-c1ea-4116-9de4-931d778b60ae"},"status":"ok","message":"Search results retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"service":"chucknorris-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/random":"A random Chuck Norris joke (category=optional, e.g. dev).","GET /v1/search":"Full-text search the collection (q=, min 3 chars, limit=).","GET /v1/categories":"All joke categories."},"description":"The famous Chuck Norris joke collection via the open chucknorris.io API: pull a random joke (optionally from a category like dev, food or sport), list the available categories, or full-text search the collection. Real jokes, no key."},"meta":{"timestamp":"2026-06-08T09:48:46.607Z","request_id":"49995389-1924-454c-bad3-a5c3f35e26eb"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":7000,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":550,"monthly_call_quota":94500,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2200,"monthly_call_quota":557500,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6600,"monthly_call_quota":2720000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/chucknorris-api"}