Get Questions
Send a GET request to /api/questions
to receive a random array of questions. Available query parameters are outlined in the form below.
[
{
"category": "Film & TV",
"id": "622a1c347cc59eab6f94f92c",
"correctAnswer": "The Good, the Bad, and the Ugly",
"incorrectAnswers": [
"Chinatown",
"Fast Times at Ridgemont High",
"The Silence of the Lambs"
],
"question": "Which film contains the character 'Blondie'?",
"tags": [
"film",
"fictitious_characters",
"film_and_tv"
],
"type": "Multiple Choice",
"difficulty": "hard",
"regions": [],
"isNiche": false
},
{
"category": "Film & TV",
"id": "622a1c377cc59eab6f9506c3",
"correctAnswer": "Reese Witherspoon",
"incorrectAnswers": [
"Kristin Scott Thomas",
"Naomi Watts",
"Penélope Cruz"
],
"question": "Which actor has featued in films including Walk the Line and Cruel Intentions?",
"tags": [
"film",
"acting",
"film_and_tv"
],
"type": "Multiple Choice",
"difficulty": "hard",
"regions": [],
"isNiche": false
},
{
"category": "Music",
"id": "639612d5e55fa75b149597bd",
"correctAnswer": "The Shaggs",
"incorrectAnswers": [
"The Velvet Underground ",
"The Vamps",
"Eagles"
],
"question": "Which American rock band is renowned for having music described as both ‘the worst of all time, yet a work of unintentional brilliance’?",
"tags": [
"music",
"bands"
],
"type": "Multiple Choice",
"difficulty": "hard",
"regions": [],
"isNiche": false
},
{
"category": "Film & TV",
"id": "622a1c377cc59eab6f9507c6",
"correctAnswer": "Arnold Schwarzenegger",
"incorrectAnswers": [
"Christopher Lee",
"Anthony Hopkins",
"Tom Hanks"
],
"question": "Which actor has featured in films including Batman & Robin and Predator?",
"tags": [
"acting",
"film",
"film_and_tv"
],
"type": "Multiple Choice",
"difficulty": "medium",
"regions": [],
"isNiche": false
},
{
"category": "General Knowledge",
"id": "622a1c3d7cc59eab6f951be3",
"correctAnswer": "LXIX",
"incorrectAnswers": [
"CXIX",
"LIXX",
"CIXX"
],
"question": "How do you write 69 in Roman numerals?",
"tags": [
"numbers",
"romans",
"general_knowledge"
],
"type": "Multiple Choice",
"difficulty": "medium",
"regions": [],
"isNiche": false
},
{
"category": "History",
"id": "622a1c367cc59eab6f9503c3",
"correctAnswer": "Raoul",
"incorrectAnswers": [
"Pedro",
"Mikel",
"Sergio"
],
"question": "What's fidel castro's brother's name? ",
"tags": [
"history"
],
"type": "Multiple Choice",
"difficulty": "medium",
"regions": [],
"isNiche": false
},
{
"category": "Geography",
"id": "623b57f0fd6c701a9211838a",
"correctAnswer": "Italy",
"incorrectAnswers": [
"Russia",
"New Zealand",
"France"
],
"question": "In which country would you find the city of Rome?",
"tags": [
"geography"
],
"type": "Multiple Choice",
"difficulty": "easy",
"regions": [],
"isNiche": false
},
{
"category": "Geography",
"id": "6233886a0161109f922aac86",
"correctAnswer": "Crete ",
"incorrectAnswers": [
"Corfu",
"Santorini",
"Rhodes"
],
"question": "Which Is The Largest Of The Greek Islands?",
"tags": [
"greece",
"geography"
],
"type": "Multiple Choice",
"difficulty": "hard",
"regions": [],
"isNiche": false
},
{
"category": "Arts & Literature",
"id": "622a1c367cc59eab6f95019e",
"correctAnswer": "Dr Zhivago",
"incorrectAnswers": [
"Lolita",
"The Brothers Karamazov",
"The Cherry Orchard"
],
"question": "For which novel was Boris Pasternak awarded the 1958 Nobel Prize, an award he declined?",
"tags": [
"arts_and_literature"
],
"type": "Multiple Choice",
"difficulty": "hard",
"regions": [],
"isNiche": false
},
{
"category": "History",
"id": "622a1c3c7cc59eab6f951ac4",
"correctAnswer": "Calypso",
"incorrectAnswers": [
"Discovery",
"Terra Nova",
"Beagle"
],
"question": "What was the name of Jacques Cousteau's research ship?",
"tags": [
"names",
"history"
],
"type": "Multiple Choice",
"difficulty": "hard",
"regions": [],
"isNiche": false
}
]
Search
Send a POST request to /api/questions/search
to search for questions. Unlike the /api/questions
endpoint, this is not random and will return the same questions to every request.
[
{
"category": "Film & TV",
"id": "622a1c347cc59eab6f94f92c",
"correctAnswer": "The Good, the Bad, and the Ugly",
"incorrectAnswers": [
"Chinatown",
"Fast Times at Ridgemont High",
"The Silence of the Lambs"
],
"question": "Which film contains the character 'Blondie'?",
"tags": [
"film",
"fictitious_characters",
"film_and_tv"
],
"type": "Multiple Choice",
"difficulty": "hard",
"regions": [],
"isNiche": false
},
{
"category": "Film & TV",
"id": "622a1c377cc59eab6f9506c3",
"correctAnswer": "Reese Witherspoon",
"incorrectAnswers": [
"Kristin Scott Thomas",
"Naomi Watts",
"Penélope Cruz"
],
"question": "Which actor has featued in films including Walk the Line and Cruel Intentions?",
"tags": [
"film",
"acting",
"film_and_tv"
],
"type": "Multiple Choice",
"difficulty": "hard",
"regions": [],
"isNiche": false
},
{
"category": "Music",
"id": "639612d5e55fa75b149597bd",
"correctAnswer": "The Shaggs",
"incorrectAnswers": [
"The Velvet Underground ",
"The Vamps",
"Eagles"
],
"question": "Which American rock band is renowned for having music described as both ‘the worst of all time, yet a work of unintentional brilliance’?",
"tags": [
"music",
"bands"
],
"type": "Multiple Choice",
"difficulty": "hard",
"regions": [],
"isNiche": false
},
{
"category": "Film & TV",
"id": "622a1c377cc59eab6f9507c6",
"correctAnswer": "Arnold Schwarzenegger",
"incorrectAnswers": [
"Christopher Lee",
"Anthony Hopkins",
"Tom Hanks"
],
"question": "Which actor has featured in films including Batman & Robin and Predator?",
"tags": [
"acting",
"film",
"film_and_tv"
],
"type": "Multiple Choice",
"difficulty": "medium",
"regions": [],
"isNiche": false
},
{
"category": "General Knowledge",
"id": "622a1c3d7cc59eab6f951be3",
"correctAnswer": "LXIX",
"incorrectAnswers": [
"CXIX",
"LIXX",
"CIXX"
],
"question": "How do you write 69 in Roman numerals?",
"tags": [
"numbers",
"romans",
"general_knowledge"
],
"type": "Multiple Choice",
"difficulty": "medium",
"regions": [],
"isNiche": false
},
{
"category": "History",
"id": "622a1c367cc59eab6f9503c3",
"correctAnswer": "Raoul",
"incorrectAnswers": [
"Pedro",
"Mikel",
"Sergio"
],
"question": "What's fidel castro's brother's name? ",
"tags": [
"history"
],
"type": "Multiple Choice",
"difficulty": "medium",
"regions": [],
"isNiche": false
},
{
"category": "Geography",
"id": "623b57f0fd6c701a9211838a",
"correctAnswer": "Italy",
"incorrectAnswers": [
"Russia",
"New Zealand",
"France"
],
"question": "In which country would you find the city of Rome?",
"tags": [
"geography"
],
"type": "Multiple Choice",
"difficulty": "easy",
"regions": [],
"isNiche": false
},
{
"category": "Geography",
"id": "6233886a0161109f922aac86",
"correctAnswer": "Crete ",
"incorrectAnswers": [
"Corfu",
"Santorini",
"Rhodes"
],
"question": "Which Is The Largest Of The Greek Islands?",
"tags": [
"greece",
"geography"
],
"type": "Multiple Choice",
"difficulty": "hard",
"regions": [],
"isNiche": false
},
{
"category": "Arts & Literature",
"id": "622a1c367cc59eab6f95019e",
"correctAnswer": "Dr Zhivago",
"incorrectAnswers": [
"Lolita",
"The Brothers Karamazov",
"The Cherry Orchard"
],
"question": "For which novel was Boris Pasternak awarded the 1958 Nobel Prize, an award he declined?",
"tags": [
"arts_and_literature"
],
"type": "Multiple Choice",
"difficulty": "hard",
"regions": [],
"isNiche": false
},
{
"category": "History",
"id": "622a1c3c7cc59eab6f951ac4",
"correctAnswer": "Calypso",
"incorrectAnswers": [
"Discovery",
"Terra Nova",
"Beagle"
],
"question": "What was the name of Jacques Cousteau's research ship?",
"tags": [
"names",
"history"
],
"type": "Multiple Choice",
"difficulty": "hard",
"regions": [],
"isNiche": false
}
]
Create a Session
Sessions are used to ensure that you don't receive duplicate questions. To create a session, send a GET request to /api/session
, passing your API key in the x-api-key header.
Once the session has been created, you can request questions from that session by passing the session ID as a query parameter to the getQuestions endpoint, e.g. /api/questions?session=<SESSION_ID>
. Subsequent requests to this endpoint will return different questions. Once all questions have been returned, you will receive no more questions.
You can find information on your session by sendinga GET request to /api/session/<SESSION_ID>
.
{
"remainingQuestions": 9032,
"categories": [],
"difficulty": null,
"id": "s0me_se55ion_k3y",
"tags": [],
"totalQuestions": 9062,
"region": null,
"createdAt": "2022-12-21T08:57:47.480Z",
"updatedAt": "2022-12-21T08:57:47.480Z"
}
Get Categories
Send a GET request to /api/categories
to receive information on the categories of question available to request. The keys of the returned object are the labels for each category, and the values can be sent in the comma-separated categories
query parameter when getting questions.
{
"Arts & Literature": [
"arts",
"literature",
"arts_and_literature"
],
"Film & TV": [
"movies",
"film",
"film_and_tv"
],
"Food & Drink": [
"food_and_drink",
"food",
"drink"
],
"General Knowledge": [
"general_knowledge"
],
"Geography": [
"geography"
],
"History": [
"history"
],
"Music": [
"music"
],
"Science": [
"science"
],
"Society & Culture": [
"society_and_culture",
"society",
"culture"
],
"Sport & Leisure": [
"sport_and_leisure",
"sports",
"sport"
]
}
Get Metadata
Send a GET request to /api/metadata
to receive information on the number of questions in the database and the distribution of questions across categories.
{
"byCategory": {
"General Knowledge": 231,
"Society & Culture": 343,
"History": 477,
"Sport & Leisure": 509,
"Geography": 1269,
"Music": 1119,
"Film & TV": 1271,
"Science": 960,
"Food & Drink": 484,
"Arts & Literature": 858
},
"byState": {
"rejected": 3511,
"approved": 7521,
"pending": 5024
},
"byDifficulty": {
"hard": 4239,
"null": 117,
"easy": 608,
"medium": 2557
},
"lastCreated": "2022-04-19T11:42:20.471+00:00",
"lastReviewed": "2022-04-19T20:57:47.644+00:00"
}
Get Tags
Send a GET request to /api/tags
to receive information on the set of all tags that have been added to questions. Each tag can be passed as a value to the tags
queryParameter of the getQuestions
endpoint, e.g. /api/questions?tags=mountains,medicine
[
"00's",
"1400's",
"1600's",
"1700's",
"1800's",
"1910's",
"1920's",
"1930's",
"1940's",
"1950's",
"1960's",
"1970's",
"1980's",
"1990's",
"2010's",
"academy_awards",
"acronyms",
"acting",
"actors",
"advertising",
"africa",
"albums",
"alcohol",
"american_football",
"anatomy",
"ancient_egypt",
"ancient_greece",
"animals",
"architecture",
"art",
"arts_and_literature",
"asia",
"assassinations",
"astronomy",
"athletics",
"australia",
"baltimore",
"bands",
"baseball",
"basketball",
"batman",
"battles",
"biology",
"birds",
"bodies_of_water",
"boston",
"boxing",
"bridges",
"buddhism",
"bugs",
"buildings",
"business",
"cambodia",
"canada",
"capital_cities",
"cartoons",
"central_america",
"cheese",
"chemistry",
"chicago",
"childrens_literature",
"china",
"christianity",
"christmas",
"cities",
"civil_rights",
"classic_novels",
"classical_music",
"classics",
"cocktails",
"cold_war",
"colours",
"comics",
"computing",
"countries",
"cover_song",
"cricket",
"crime",
"cuba",
"cult_films",
"currency",
"dallas",
"darts",
"dc",
"deserts",
"dinosaurs",
"disney",
"drink",
"drinks",
"empires",
"europe",
"events",
"exploration",
"fantasy",
"fashion",
"fiction",
"fictitious_characters",
"film",
"film_and_tv",
"firsts",
"fish",
"flags",
"food",
"food_and_drink",
"football",
"formula_1",
"france",
"games",
"general_knowledge",
"geography",
"geology",
"germany",
"golf",
"greece",
"halloween",
"harry_potter",
"hinduism",
"history",
"hock",
"hockey",
"horror",
"india",
"initials",
"inventions",
"iran",
"islam",
"islands",
"italy",
"james_bond",
"japan",
"jazz",
"judaism",
"kings",
"kpop",
"lakes",
"language",
"las_vegas",
"leaders",
"literature",
"liverpool",
"logos",
"london",
"lord_of_the_rings",
"lyrics",
"manchester",
"marketing",
"martial_arts",
"marvel",
"mathematics",
"mcu",
"medicine",
"medieval",
"mediterranean",
"meteorology",
"middle_ages",
"mlb",
"mls",
"moldova",
"motoring",
"motown",
"mountains",
"music",
"music_albums",
"musicals",
"musicians",
"mythology",
"names",
"natural_disasters",
"natural_wonders",
"nba",
"nbl",
"new_orleans",
"new_york",
"new_zealand",
"nfl",
"nhl",
"nicknames",
"numbers",
"oceans",
"olympics",
"one_hit_wonders",
"organisations",
"painting",
"paris",
"pastry",
"people",
"philosophy",
"physics",
"places",
"plants",
"politics",
"pop_music",
"presidents",
"previous_names",
"pseudonyms",
"quotes",
"racing",
"rap",
"rap_music",
"records",
"religion",
"revolutions",
"rivers",
"rock_music",
"romans",
"rugby",
"russia",
"salvador_dali",
"scandinavia",
"science",
"science_fiction",
"scientific_discoveries",
"shakespeare",
"soccer",
"society_and_culture",
"songs",
"soundtracks",
"south_america",
"southampton",
"southeast_asia",
"space",
"space_exploration",
"spain",
"sport",
"star_wars",
"statues",
"swimming",
"symbols",
"technology",
"tennis",
"the_ancient_world",
"the_beatles",
"the_human_body",
"the_internet",
"the_middle_east",
"the_netherlands",
"the_simpsons",
"the_solar_system",
"theater",
"tourist_attractions",
"toys",
"traditions",
"translations",
"tv",
"uk",
"ukraine",
"us_states",
"usa",
"video_games",
"vietnam",
"vikings",
"volcanoes",
"wars",
"waterfalls",
"wine",
"words",
"world_cup",
"world_war_1",
"world_war_2",
"young_adult"
]