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.
Response:
[ { "category": "Geography", "id": "6233883c0161109f922aac74", "correctAnswer": "Asia", "incorrectAnswers": [ "North America", "Africa", "Antarctica" ], "question": "Which is the Earth's largest continent?", "tags": [ "geography" ], "type": "Multiple Choice", "difficulty": "easy", "regions": [] }, { "category": "History", "id": "622a1c367cc59eab6f95033f", "correctAnswer": "Harold Wilson", "incorrectAnswers": [ "Clement Atlee", "Anthony Eden", "Margaret Thatcher" ], "question": "Who Was The British Prime Minister Between 1964 & 1969?", "tags": [ "history" ], "type": "Multiple Choice", "difficulty": "hard", "regions": [] }, { "category": "Film & TV", "id": "622a1c377cc59eab6f9505f8", "correctAnswer": "Richard Burton", "incorrectAnswers": [ "Aaron Paul", "Mark Hamill", "Alan Cumming" ], "question": "Which actor has featued in films including Cleopatra and Who's Afraid of Virginia Woolf??", "tags": [ "film_and_tv" ], "type": "Multiple Choice", "difficulty": "hard", "regions": [] }, { "category": "Film & TV", "id": "622a1c377cc59eab6f9506b9", "correctAnswer": "Kristin Scott Thomas", "incorrectAnswers": [ "Glenn Close", "Reese Witherspoon", "Melissa Leo" ], "question": "Which actor has featued in films including The English Patient and Gosford Park?", "tags": [ "film_and_tv" ], "type": "Multiple Choice", "difficulty": "hard", "regions": [] }, { "category": "Food & Drink", "id": "624c613abadf21197f98f76d", "correctAnswer": "Thailand", "incorrectAnswers": [ "Uzbekistan", "Barbados", "The Middle East" ], "question": "Pad Thai is a dish that is most associated with which part of the world?", "tags": [ "food", "food_and_drink" ], "type": "Multiple Choice", "difficulty": "medium", "regions": [] }, { "category": "Geography", "id": "623741c8cb85f7ce9e949d89", "correctAnswer": "Oman", "incorrectAnswers": [ "Cabo Verde", "Belize", "Timor-Leste" ], "question": "Muscat is the capital city of which country?", "tags": [ "geography" ], "type": "Multiple Choice", "difficulty": "hard", "regions": [] }, { "category": "Music", "id": "622a1c397cc59eab6f950c24", "correctAnswer": "The Who", "incorrectAnswers": [ "Deep Purple", "Travis", "Spandau Ballet" ], "question": "Which English rock band released the studio album 'Who's Next'?", "tags": [ "music" ], "type": "Multiple Choice", "difficulty": "hard", "regions": [] }, { "category": "General Knowledge", "id": "622a1c367cc59eab6f95031a", "correctAnswer": "Robert Burns", "incorrectAnswers": [ "JM Barrie", "Robert Louis Stevenson", "James Hogg" ], "question": "Who wrote Auld Lange Syne?", "tags": [ "general_knowledge" ], "type": "Multiple Choice", "difficulty": "medium", "regions": [] }, { "category": "Film & TV", "id": "622a1c367cc59eab6f9503c8", "correctAnswer": "Mrs Robinson", "incorrectAnswers": [ "Mrs Bouvier", "Mrs Church", "Mrs Sleet" ], "question": "What Was The Name Of The Character Played By Anne Bancroft In The 1967 Film 'The Graduate'?", "tags": [ "fictitious_characters", "film", "acting", "film_and_tv" ], "type": "Multiple Choice", "difficulty": "medium", "regions": [] }, { "category": "Film & TV", "id": "622a1c347cc59eab6f94fb29", "correctAnswer": "Green Book", "incorrectAnswers": [ "Black Panther", "BlacKkKlansman", "Bohemian Rhapsody" ], "question": "Which film won the Academy Award for Best Picture in 2018?", "tags": [ "academy_awards", "film" ], "type": "Multiple Choice", "difficulty": "hard", "regions": [] } ]
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.
Response:
{ "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.
Response:
{ "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
Response:
[ "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" ]