GET qbreader.org/api/random-bonus

Get random bonuses from the database.

• 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.

  • To pass multiple categories, separate values by a comma.
  • If undefined then all categories are allowed / match this field.
  • Can also be a string if there is only 1 category.
  • Take special care to ensure that the first letter of each word of each category is capitalized.
• subcategories: string | string[] default: undefined
  The subcategories to search for. All of the bullet points above apply here, plus:

  • This endpoint returns all questions that match both the categories AND subcategories field.
  • This API endpoint does not check for consistency between categories and subcategories.
  • For example, requesting the "History" category and the "Biology" and "Chemistry" subcategories will return no questions.
• alternateSubcategories: string | string[] default: undefined
  The alternate subcategories to search for. All of the bullet points above apply here, plus:

  • This endpoint returns all questions that match the categories AND subcategories AND alternateSubcategories fields.
  • This endpoint does not check for consistency between categories and subcategories and alternate subcategories.
  • Categories or subcategories that do not have corresponding alternate subcategories can never be excluded by specifying values for alternateSubcategories.
  • For example, requesting the "Science" category and the "Biology" and "Other Science" subcategories and the "Math" alternate subcategory will return questions in both Biology and Math, since Biology questions don't have alternate subcategories.
• number: number default: 1
  How many questions to return.
• minYear: number default: 2010
  The oldest year to search for.
• maxYear: number default: 2024
  The most recent year to search for.
• threePartBonuses: boolean default: false
  Whether to only return bonuses with 3 parts.
• standardOnly: boolean default: "false"
  Whether or not to only return questions from standard quizbowl formats. Broadly, non-standard formats include anything that's not designed for use at an academic quizbowl tournament. Think trash packets, single-packet sets, and side events. Single-subject full-length tournaments (think DECAF and Lederberg) still count as "standard-format".

• bonuses: Bonus[]
  An array of random Bonuses.