POST qbreader.org/api/random-question

Get random questions from the database.

• questionType: "tossup" | "bonus" required
  The type of question to search for.

  • "tossup" - only tossups
  • "bonus" - only bonuses
• difficulties: number[] | number | string default: undefined
  The difficulties to search for.

  • If undefined then all difficulties are allowed.
  • Can also be a string or number if there is only 1 difficulty.
• categories: string[] | string default: undefined
  The categories to search for.

  • If undefined then all categories are allowed.
  • Can also be a string if there is only 1 category.
  • Take special care to ensure that the first letter of each word of the category is capitalized.
• subcategories: string[] | string default: undefined
  The subcategories to search for.

  • If undefined then all subcategories are allowed.
  • Can also be a string if there is only 1 subcategory.
  • Take special care to ensure that the first letter of each word of the subcategory is capitalized.
  • This API endpoint does not check for consistency between categories and subcategories.
  • For example, requesting the "History" and the "Biology" and "Chemistry" subcategories will return no questions.
• number: number default: 1
  How many questions to return.
• minYear: number default: 2010
  The oldest year to search for.
• maxYear: number default: 2023
  The most recent year to search for.