{"openapi":"3.1.0","info":{"title":"Quiz & Trivia API","version":"1.0.0","description":"A ready-to-use trivia engine with more than 44,000 multiple-choice questions across 20 categories — animals, brain teasers, celebrities, entertainment, kids, general knowledge, geography, history, hobbies, humanities, literature, movies, music, people, religion, science & technology, sports, television, video games and world. Pull a random question or a batch (optionally filtered by category, with the answer hidden for gameplay and the options shuffled), fetch a specific question by id, verify a submitted answer, search questions by keyword, and list every category with its question count. Every endpoint accepts input via the query string or the request body and returns lean JSON. Pure server-side data (no third-party upstream), so responses are instant and always available. Ideal for quiz and trivia games, pub-quiz and party apps, learning tools, chatbots and Discord/Slack bots.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/quiz-api","description":"oanor gateway"}],"tags":[{"name":"Quiz"}],"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":["Quiz"],"summary":"All categories with counts","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"categories":[{"name":"animals","questions":1365},{"name":"brain-teasers","questions":198},{"name":"celebrities","questions":3160},{"name":"entertainment","questions":279},{"name":"for-kids","questions":751},{"name":"general","questions":3279},{"name":"geography","questions":842},{"name":"history","questions":1637},{"name":"hobbies","questions":1240},{"name":"humanities","questions":1092},{"name":"literature","questions":1269},{"name":"movies","questions":4256},{"name":"music","questions":5280},{"name":"people","questions":2739},{"name":"religion-faith","questions":638},{"name":"science-technology","questions":2484},{"name":"sports","questions":2840},{"name":"television","questions":5219},{"name":"video-games","questions":594},{"name":"world","questions":4862}],"total_questions":44024},"meta":{"timestamp":"2026-05-30T22:48:26.067Z","request_id":"ff984d05-1bc0-4b77-9707-c0351db1d3d8"},"status":"ok","message":"Categories retrieved","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/check":{"get":{"operationId":"get_v1_check","tags":["Quiz"],"summary":"Verify an answer","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Question id","schema":{"type":"string"},"example":"0"},{"name":"answer","in":"query","required":true,"description":"Submitted answer","schema":{"type":"string"},"example":"Sloth"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":0,"correct":true,"question":"Three of these animals hibernate. Which one does not?","your_answer":"Sloth","correct_answer":"Sloth"},"meta":{"timestamp":"2026-05-30T22:48:26.139Z","request_id":"739c7ac3-4f8c-4d37-8ac8-216bc1b9ff7e"},"status":"ok","message":"Answer checked","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/question":{"get":{"operationId":"get_v1_question","tags":["Quiz"],"summary":"Question by id","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Question id","schema":{"type":"string"},"example":"0"},{"name":"hide_answer","in":"query","required":false,"description":"Omit the correct answer","schema":{"type":"string"},"example":"false"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":0,"options":["Frog","Snake","Mouse","Sloth"],"category":"animals","question":"Three of these animals hibernate. Which one does not?","correct_answer":"Sloth"},"meta":{"timestamp":"2026-05-30T22:48:26.209Z","request_id":"f536c7f0-9e93-43fc-a30a-67ee84a69e00"},"status":"ok","message":"Question retrieved","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":["Quiz"],"summary":"Random question(s)","description":"","parameters":[{"name":"category","in":"query","required":false,"description":"Category slug","schema":{"type":"string"},"example":"science-technology"},{"name":"count","in":"query","required":false,"description":"1..50 (default 1)","schema":{"type":"string"},"example":"1"},{"name":"hide_answer","in":"query","required":false,"description":"Omit the correct answer","schema":{"type":"string"},"example":"true"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":29108,"options":["cytology","cellogy","ecology","protozoology"],"category":"science-technology","question":"Which of these is the study of cells?"},"meta":{"timestamp":"2026-05-30T22:48:26.278Z","request_id":"4e396c0c-0dbf-4f67-a3e6-c167671d3964"},"status":"ok","message":"Random question retrieved","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":["Quiz"],"summary":"Search questions","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Text query","schema":{"type":"string"},"example":"planet"},{"name":"category","in":"query","required":false,"description":"Category slug","schema":{"type":"string"},"example":"science-technology"},{"name":"limit","in":"query","required":false,"description":"1..100 (default 20)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Offset","schema":{"type":"string"},"example":"0"},{"name":"hide_answer","in":"query","required":false,"description":"Omit answers","schema":{"type":"string"},"example":"true"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"limit":20,"query":"planet","total":98,"offset":0,"results":[{"id":28052,"options":["Uranus","Mars","Saturn","Venus"],"category":"science-technology","question":"This planet is slightly smaller than Earth and its closest neighbor (excluding the Moon)."},{"id":28053,"options":["Neptune","Saturn","Venus","Mars"],"category":"science-technology","question":"This planet is has the largest  group of moons - 31, but it is best known for its ring system."},{"id":28054,"options":["Pluto","Uranus","Neptune","Mercury"],"category":"science-technology","question":"This planet of the Solar System was named after a Greek god of the sea and earthquakes. The name is actually the Roman translation of the gods name."},{"id":28055,"options":["Mercury","Venus","Neptune","Pluto"],"category":"science-technology","question":"As this is the closest planet to the Sun, its temperatures at the surface range between -300 and 800 F (hot enough for lead to melt)."},{"id":28056,"options":["Pluto","Mars","Saturn","Earth"],"category":"science-technology","question":"The surface of this planet is unique, it is the only one which has water in large quantities."},{"id":28058,"options":["Mars","Jupiter","Saturn","Neptune"],"category":"science-technology","question":"This is the largest planet in our solar system. It is most famous for its Great Red Spot."},{"id":28059,"options":["Uranus","Venus","Saturn","Jupiter"],"category":"science-technology","question":"Miranda, Ariel, Umbriel, Titania, Oberon, Caliban, and Sycorax are names of the icy moons of this planet."},{"id":28209,"options":["Atmospheric termoincrease","Global dimming","Ozone depletion","Greenhouse effect"],"category":"science-technology","question":"What term do scientists use to denote the gradual warming of the planet due to absorption of infrared radiation by the atmosphere?"},{"id":28423,"options":["True","False"],"category":"science-technology","question":"The mission statement of NASA is to understand and protect our home planet; to explore the Universe and search for life; and to inspire the next generation of explorers."},{"id":28424,"options":["Saturn","Jupiter","Mars","Venus"],"category":"science-technology","question":"Which is the largest planet in the Solar System?"},{"id":28425,"options":["Mars","Mercury","Saturn","Venus"],"category":"science-technology","question":"Which planet has been described as a sister planet to Earth?"},{"id":28426,"options":["Mercury","Uranus","Neptune","Pluto"],"category":"science-technology","question":"Which planet has been demoted from its planet status by scientists like Neil Tyson, Director of the Hayden Planetarium?"},{"id":28427,"options":["Mars","Saturn","Neptune","Jupiter"],"category":"science-technology","question":"Which planet was named after the ancient Romans’ king of the gods?"},{"id":28428,"options":["Neptune","Venus","Mars","Mercury"],"category":"science-technology","question":"Which planet of the Solar System has been nicknamed The Red Planet?"},{"id":28429,"options":["Saturn","Mercury","Mars","Uranus"],"category":"science-technology","question":"Which planet was named after the Roman god of war?"},{"id":28430,"options":["Saturn","Jupiter","Venus","Pluto"],"category":"science-technology","question":"Io and Europa are two of the larger satellites of which Solar System planet?"},{"id":28431,"options":["Saturn","Venus","Neptune","Earth"],"category":"science-technology","question":"Which planet of the Solar System is nicknamed the Blue Planet?"},{"id":28432,"options":["Mars","Mercury","Earth","Venus"],"category":"science-technology","question":"Which of the following planets is closest to the Sun?"},{"id":28433,"options":["Its active volcanoes","Its gigantic craters","Its equatorial rings","Its silver coloring"],"category":"science-technology","question":"What is the distinctive feature of the sixth planet of the Solar System (counted from the Sun)?"},{"id":28434,"options":["Neptune","All of these","Saturn","Jupiter and Neptune"],"category":"science-technology","question":"Which of the following Solar System planets are designated as gas planets?"}],"category":"science-technology"},"meta":{"timestamp":"2026-05-30T22:48:26.324Z","request_id":"f06c2d6b-465d-48b4-840a-ac888304a61b"},"status":"ok","message":"Search completed","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":20000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":390,"monthly_call_quota":280000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":990,"monthly_call_quota":2000000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":2700,"monthly_call_quota":10000000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/quiz-api"}