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.

URL (copy to clipboard)
API query values

Primary category of each question (1 per question)

easy, medium or hard

Number of questions to return

Subcategories for this question, e.g. 'capital_cities', 'europe'

Secondary categories. These are more specific than categories and each question can have multiple.

Set to the ISO 3166-1 alpha-2 code for your country of choice. Doing this is recommended and will ensure that you don't receive questions that are unsuitable for the region you choose.

URL (copy to clipboard)

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.

URL (copy to clipboard)

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.

URL (copy to clipboard)

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

URL (copy to clipboard)

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"
]