Get Random 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": "Music",
    "id": "622a1c357cc59eab6f94ff18",
    "correctAnswer": "Madonna",
    "incorrectAnswers": [
      "Eric Clapton",
      "Nicki Minaj",
      "Alanis Morissette"
    ],
    "question": "Which American singer and songwriter released the studio album 'Erotica'?",
    "tags": [
      "albums",
      "musicians",
      "music"
    ],
    "type": "Multiple Choice",
    "difficulty": "medium",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "Sport & Leisure",
    "id": "62c92076a218dd4dc1ca17da",
    "correctAnswer": "Love",
    "incorrectAnswers": [
      "Egg",
      "Zilch",
      "Nil"
    ],
    "question": "What word is used for a score of 0 in a game of tennis?",
    "tags": [
      "sport",
      "tennis",
      "words"
    ],
    "type": "Multiple Choice",
    "difficulty": "easy",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "Geography",
    "id": "625e9e0d796f721e95543f3b",
    "correctAnswer": "Red",
    "incorrectAnswers": [
      "Green",
      "Yellow",
      "Gold"
    ],
    "question": "Which of these colors is included on the flag of Cambodia?",
    "tags": [
      "flags",
      "geography"
    ],
    "type": "Multiple Choice",
    "difficulty": "hard",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "General Knowledge",
    "id": "622a1c367cc59eab6f95038e",
    "correctAnswer": "Maurice Gibb",
    "incorrectAnswers": [
      "Tom Jones",
      "Paul McCartney",
      "Brian Wilson"
    ],
    "question": "Who did the singer Lulu marry in 1969?",
    "tags": [
      "general_knowledge"
    ],
    "type": "Multiple Choice",
    "difficulty": "hard",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "Food & Drink",
    "id": "63a03944c7d86251f9b65c2f",
    "correctAnswer": "Mozzarella",
    "incorrectAnswers": [
      "Gorgonzola",
      "Feta",
      "Camembert"
    ],
    "question": "Which of these cheeses would you be most likely to find in a lasagne?",
    "tags": [
      "cheese",
      "food_and_drink",
      "food"
    ],
    "type": "Multiple Choice",
    "difficulty": "medium",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "Arts & Literature",
    "id": "622a1c397cc59eab6f950f62",
    "correctAnswer": "Isaac Asimov",
    "incorrectAnswers": [
      "Ursula K. Le Guin",
      "Philip K. Dick",
      "Stephen King"
    ],
    "question": "Which author wrote 'Foundation'?",
    "tags": [
      "arts_and_literature"
    ],
    "type": "Multiple Choice",
    "difficulty": "medium",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "Geography",
    "id": "622a1c387cc59eab6f95080d",
    "correctAnswer": "Africa",
    "incorrectAnswers": [
      "South America",
      "Oceania",
      "Europe"
    ],
    "question": "The country of Equatorial Guinea is on which continent?",
    "tags": [
      "geography"
    ],
    "type": "Multiple Choice",
    "difficulty": "medium",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "Film & TV",
    "id": "622a1c377cc59eab6f950658",
    "correctAnswer": "Anthony Quinn",
    "incorrectAnswers": [
      "James Hong",
      "Gary Cooper",
      "Sam Shepard"
    ],
    "question": "Which actor has featued in films including Lawrence of Arabia and La Strada?",
    "tags": [
      "film",
      "acting",
      "film_and_tv"
    ],
    "type": "Multiple Choice",
    "difficulty": "hard",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "Film & TV",
    "id": "625fd6ecdc0dd3b72da64d15",
    "correctAnswer": "2009",
    "incorrectAnswers": [
      "2007",
      "2011",
      "2013"
    ],
    "question": "In which year was Up first released in the cinema?",
    "tags": [
      "film",
      "disney",
      "film_and_tv"
    ],
    "type": "Multiple Choice",
    "difficulty": "hard",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "Arts & Literature",
    "id": "622a1c397cc59eab6f950e39",
    "correctAnswer": "Lucy Maud Montgomery",
    "incorrectAnswers": [
      "Alice Munro",
      "Lewis Carroll",
      "Margaret Atwood"
    ],
    "question": "Which author wrote 'Anne of Avonlea'?",
    "tags": [
      "literature",
      "arts_and_literature"
    ],
    "type": "Multiple Choice",
    "difficulty": "hard",
    "regions": [],
    "isNiche": false
  }
]

Get Question

Send a GET request to /api/question/{id} to receive that question.

[
  {
    "category": "Music",
    "id": "622a1c357cc59eab6f94ff18",
    "correctAnswer": "Madonna",
    "incorrectAnswers": [
      "Eric Clapton",
      "Nicki Minaj",
      "Alanis Morissette"
    ],
    "question": "Which American singer and songwriter released the studio album 'Erotica'?",
    "tags": [
      "albums",
      "musicians",
      "music"
    ],
    "type": "Multiple Choice",
    "difficulty": "medium",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "Sport & Leisure",
    "id": "62c92076a218dd4dc1ca17da",
    "correctAnswer": "Love",
    "incorrectAnswers": [
      "Egg",
      "Zilch",
      "Nil"
    ],
    "question": "What word is used for a score of 0 in a game of tennis?",
    "tags": [
      "sport",
      "tennis",
      "words"
    ],
    "type": "Multiple Choice",
    "difficulty": "easy",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "Geography",
    "id": "625e9e0d796f721e95543f3b",
    "correctAnswer": "Red",
    "incorrectAnswers": [
      "Green",
      "Yellow",
      "Gold"
    ],
    "question": "Which of these colors is included on the flag of Cambodia?",
    "tags": [
      "flags",
      "geography"
    ],
    "type": "Multiple Choice",
    "difficulty": "hard",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "General Knowledge",
    "id": "622a1c367cc59eab6f95038e",
    "correctAnswer": "Maurice Gibb",
    "incorrectAnswers": [
      "Tom Jones",
      "Paul McCartney",
      "Brian Wilson"
    ],
    "question": "Who did the singer Lulu marry in 1969?",
    "tags": [
      "general_knowledge"
    ],
    "type": "Multiple Choice",
    "difficulty": "hard",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "Food & Drink",
    "id": "63a03944c7d86251f9b65c2f",
    "correctAnswer": "Mozzarella",
    "incorrectAnswers": [
      "Gorgonzola",
      "Feta",
      "Camembert"
    ],
    "question": "Which of these cheeses would you be most likely to find in a lasagne?",
    "tags": [
      "cheese",
      "food_and_drink",
      "food"
    ],
    "type": "Multiple Choice",
    "difficulty": "medium",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "Arts & Literature",
    "id": "622a1c397cc59eab6f950f62",
    "correctAnswer": "Isaac Asimov",
    "incorrectAnswers": [
      "Ursula K. Le Guin",
      "Philip K. Dick",
      "Stephen King"
    ],
    "question": "Which author wrote 'Foundation'?",
    "tags": [
      "arts_and_literature"
    ],
    "type": "Multiple Choice",
    "difficulty": "medium",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "Geography",
    "id": "622a1c387cc59eab6f95080d",
    "correctAnswer": "Africa",
    "incorrectAnswers": [
      "South America",
      "Oceania",
      "Europe"
    ],
    "question": "The country of Equatorial Guinea is on which continent?",
    "tags": [
      "geography"
    ],
    "type": "Multiple Choice",
    "difficulty": "medium",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "Film & TV",
    "id": "622a1c377cc59eab6f950658",
    "correctAnswer": "Anthony Quinn",
    "incorrectAnswers": [
      "James Hong",
      "Gary Cooper",
      "Sam Shepard"
    ],
    "question": "Which actor has featued in films including Lawrence of Arabia and La Strada?",
    "tags": [
      "film",
      "acting",
      "film_and_tv"
    ],
    "type": "Multiple Choice",
    "difficulty": "hard",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "Film & TV",
    "id": "625fd6ecdc0dd3b72da64d15",
    "correctAnswer": "2009",
    "incorrectAnswers": [
      "2007",
      "2011",
      "2013"
    ],
    "question": "In which year was Up first released in the cinema?",
    "tags": [
      "film",
      "disney",
      "film_and_tv"
    ],
    "type": "Multiple Choice",
    "difficulty": "hard",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "Arts & Literature",
    "id": "622a1c397cc59eab6f950e39",
    "correctAnswer": "Lucy Maud Montgomery",
    "incorrectAnswers": [
      "Alice Munro",
      "Lewis Carroll",
      "Margaret Atwood"
    ],
    "question": "Which author wrote 'Anne of Avonlea'?",
    "tags": [
      "literature",
      "arts_and_literature"
    ],
    "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": "Music",
    "id": "622a1c357cc59eab6f94ff18",
    "correctAnswer": "Madonna",
    "incorrectAnswers": [
      "Eric Clapton",
      "Nicki Minaj",
      "Alanis Morissette"
    ],
    "question": "Which American singer and songwriter released the studio album 'Erotica'?",
    "tags": [
      "albums",
      "musicians",
      "music"
    ],
    "type": "Multiple Choice",
    "difficulty": "medium",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "Sport & Leisure",
    "id": "62c92076a218dd4dc1ca17da",
    "correctAnswer": "Love",
    "incorrectAnswers": [
      "Egg",
      "Zilch",
      "Nil"
    ],
    "question": "What word is used for a score of 0 in a game of tennis?",
    "tags": [
      "sport",
      "tennis",
      "words"
    ],
    "type": "Multiple Choice",
    "difficulty": "easy",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "Geography",
    "id": "625e9e0d796f721e95543f3b",
    "correctAnswer": "Red",
    "incorrectAnswers": [
      "Green",
      "Yellow",
      "Gold"
    ],
    "question": "Which of these colors is included on the flag of Cambodia?",
    "tags": [
      "flags",
      "geography"
    ],
    "type": "Multiple Choice",
    "difficulty": "hard",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "General Knowledge",
    "id": "622a1c367cc59eab6f95038e",
    "correctAnswer": "Maurice Gibb",
    "incorrectAnswers": [
      "Tom Jones",
      "Paul McCartney",
      "Brian Wilson"
    ],
    "question": "Who did the singer Lulu marry in 1969?",
    "tags": [
      "general_knowledge"
    ],
    "type": "Multiple Choice",
    "difficulty": "hard",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "Food & Drink",
    "id": "63a03944c7d86251f9b65c2f",
    "correctAnswer": "Mozzarella",
    "incorrectAnswers": [
      "Gorgonzola",
      "Feta",
      "Camembert"
    ],
    "question": "Which of these cheeses would you be most likely to find in a lasagne?",
    "tags": [
      "cheese",
      "food_and_drink",
      "food"
    ],
    "type": "Multiple Choice",
    "difficulty": "medium",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "Arts & Literature",
    "id": "622a1c397cc59eab6f950f62",
    "correctAnswer": "Isaac Asimov",
    "incorrectAnswers": [
      "Ursula K. Le Guin",
      "Philip K. Dick",
      "Stephen King"
    ],
    "question": "Which author wrote 'Foundation'?",
    "tags": [
      "arts_and_literature"
    ],
    "type": "Multiple Choice",
    "difficulty": "medium",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "Geography",
    "id": "622a1c387cc59eab6f95080d",
    "correctAnswer": "Africa",
    "incorrectAnswers": [
      "South America",
      "Oceania",
      "Europe"
    ],
    "question": "The country of Equatorial Guinea is on which continent?",
    "tags": [
      "geography"
    ],
    "type": "Multiple Choice",
    "difficulty": "medium",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "Film & TV",
    "id": "622a1c377cc59eab6f950658",
    "correctAnswer": "Anthony Quinn",
    "incorrectAnswers": [
      "James Hong",
      "Gary Cooper",
      "Sam Shepard"
    ],
    "question": "Which actor has featued in films including Lawrence of Arabia and La Strada?",
    "tags": [
      "film",
      "acting",
      "film_and_tv"
    ],
    "type": "Multiple Choice",
    "difficulty": "hard",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "Film & TV",
    "id": "625fd6ecdc0dd3b72da64d15",
    "correctAnswer": "2009",
    "incorrectAnswers": [
      "2007",
      "2011",
      "2013"
    ],
    "question": "In which year was Up first released in the cinema?",
    "tags": [
      "film",
      "disney",
      "film_and_tv"
    ],
    "type": "Multiple Choice",
    "difficulty": "hard",
    "regions": [],
    "isNiche": false
  },
  {
    "category": "Arts & Literature",
    "id": "622a1c397cc59eab6f950e39",
    "correctAnswer": "Lucy Maud Montgomery",
    "incorrectAnswers": [
      "Alice Munro",
      "Lewis Carroll",
      "Margaret Atwood"
    ],
    "question": "Which author wrote 'Anne of Avonlea'?",
    "tags": [
      "literature",
      "arts_and_literature"
    ],
    "type": "Multiple Choice",
    "difficulty": "hard",
    "regions": [],
    "isNiche": false
  }
]

Create a Quiz

(Requires subscription)

Quizzes are collections of questions (with a user-friendly title) that can be used to give end users a repeatable set of questions to answer.

To create a quiz, send a POST request to /api/quiz, passing your API key in the x-api-key header, and a request body containing:

  • The quiz title in the title property
  • An array of question IDs in the questionIds property

The response will contain an ID that you can use to get the quiz.

{
  "id": "622a1c3c7cc59eab6f9519ab"
}

Get a Quiz

Quizzes are collections of questions (with a user-friendly title) that can be used to give end users a repeatable set of questions to answer.

To get a quiz, send a GET request to /api/quiz/{id}. The response will contain the quiz title and all of the questions on the quiz.

{
  "id": "someQuizId",
  "title": "A fun quiz",
  "questions": [
    {
      "category": "Film & TV",
      "correctAnswer": "Marlon Brando",
      "difficulty": "hard",
      "id": "622a1c347cc59eab6f94f8fb",
      "incorrectAnswers": [
        "Humphrey Bogart",
        "Harrison Ford",
        "Robert Shaw"
      ],
      "isNiche": false,
      "question": "Which actor played the role of Stanley Kowalski in A Streetcar Named Desire?",
      "regions": [],
      "tags": [
        "acting",
        "film",
        "film_and_tv"
      ],
      "type": "Multiple Choice"
    },
    {
      "category": "Music",
      "correctAnswer": "The Beach Boys",
      "difficulty": "hard",
      "id": "622a1c397cc59eab6f950d9b",
      "incorrectAnswers": [
        "Swans",
        "Three 6 Mafia",
        "The Velvet Underground"
      ],
      "isNiche": false,
      "question": "Which band includes 'Dennis Wilson'?",
      "regions": [],
      "tags": [
        "music"
      ],
      "type": "Multiple Choice"
    }
  ]
}

Get All of Your Quizzes

To get all quizzes you have created, send a GET request to /api/quizzes, including your API key in the x-api-key header. The response will be an array of all of your quizzes.

[
  {
    "id": "someQuizId",
    "title": "A fun quiz",
    "numberOfQuestions": 2
  },
  {
    "id": "someOtherQuizId",
    "title": "Another quiz",
    "questions": 1
  }
]

Delete a Quiz

To delete a quiz, send a DELETE request to /api/quiz/{id}, including your API key in the x-api-key header. The response code will be 204, with no data.

{}

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