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.

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)
[
  {
    "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

(Requires subscription)

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

(Requires subscription)

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.

URL (copy to clipboard)
{
  "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)
[
  "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"
]