Polemia

Make a new live multiple-choice quiz on Polemia about any topic, ready to play on phones with a join code. Use it when the user wants a quiz, trivia game or icebreaker for a class, party, family, team or pub quiz. Takes 10 to 60 seconds. Returns join_url and code (for the players), host_url (for the person running the game: opening it makes that browser the host, and it works once), qr_url (a QR code image of the join link) and an instructions sentence to pass on. Always give the user both host_url and join_url. "facts" quizzes have right answers; "opinions" quizzes are scored by what the majority picks. Topics that target people, politics, war or adult material are refused.

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "minLength": 2,
      "maxLength": 80,
      "description": "What the quiz is about, e.g. \"volcanoes\", \"Harry Potter\", \"the human body for 9 year olds\"."
    },
    "questions": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 10,
      "description": "How many questions, 1 to 25."
    },
    "kind": {
      "type": "string",
      "enum": [
        "facts",
        "opinions"
      ],
      "default": "facts",
      "description": "\"facts\": questions with a right answer. \"opinions\": fun questions where the most popular answer scores."
    },
    "language": {
      "type": "string",
      "description": "Write the quiz in this language (BCP-47, e.g. \"es\", \"de\", \"pt-BR\"). Leave out to use the language the topic is written in."
    },
    "for_children_under": {
      "type": "integer",
      "minimum": 3,
      "maximum": 17,
      "description": "Make every question suitable for children under this age."
    }
  },
  "required": [
    "topic"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "The join code players type at polemia.ai."
    },
    "join_url": {
      "type": "string",
      "format": "uri"
    },
    "host_url": {
      "type": "string",
      "format": "uri"
    },
    "qr_url": {
      "type": "string",
      "format": "uri"
    },
    "questions": {
      "type": "integer"
    },
    "kind": {
      "type": "string",
      "enum": [
        "facts",
        "opinions"
      ]
    },
    "language": {
      "type": "string"
    },
    "topic": {
      "type": "string"
    },
    "host_link_expires_at": {
      "type": "string",
      "format": "date-time"
    },
    "instructions": {
      "type": "string"
    }
  },
  "required": [
    "code",
    "join_url",
    "host_url",
    "qr_url",
    "questions",
    "kind",
    "language",
    "topic",
    "host_link_expires_at",
    "instructions"
  ]
}

Search Polemia's free public library of ready-made quizzes. Instant and free. Use it when the user wants a quiz on a common topic and does not need a new one written. Returns up to 10 quizzes, each with a title, question count, kind, language and play_url (the quiz's page, where the user starts a live game with it).

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "A word or two about the topic, e.g. \"space\", \"football\", \"Christmas\"."
    },
    "language": {
      "type": "string",
      "description": "Only quizzes in this language (BCP-47). Leave out for every language."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "total": {
      "type": "integer",
      "description": "How many quizzes match in all."
    },
    "quizzes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string"
          },
          "questions": {
            "type": "integer"
          },
          "kind": {
            "type": "string",
            "enum": [
              "facts",
              "opinions"
            ]
          },
          "language": {
            "type": "string"
          },
          "for_children_under": {
            "type": [
              "integer",
              "null"
            ]
          },
          "sample_question": {
            "type": [
              "string",
              "null"
            ]
          },
          "play_url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "title",
          "questions",
          "kind",
          "language",
          "play_url"
        ]
      }
    },
    "browse_url": {
      "type": "string",
      "format": "uri"
    },
    "instructions": {
      "type": "string"
    }
  },
  "required": [
    "total",
    "quizzes",
    "browse_url",
    "instructions"
  ]
}

Today's Polemia question: one opinion question a day, answered anonymously by people all over the world. Free. Use it when the user wants a question of the day, a conversation starter, or to see what the world thinks. Returns the question, its answer options and answer_url, where the user votes and then sees everyone's results.

{
  "type": "object",
  "properties": {
    "language": {
      "type": "string",
      "description": "Show the question in this language when a translation exists (BCP-47). Default English."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string"
    },
    "question": {
      "type": [
        "string",
        "null"
      ]
    },
    "options": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string"
      }
    },
    "language": {
      "type": "string"
    },
    "answer_url": {
      "type": "string",
      "format": "uri"
    },
    "past_results_url": {
      "type": "string",
      "format": "uri"
    },
    "instructions": {
      "type": "string"
    }
  },
  "required": [
    "date",
    "question",
    "options",
    "language",
    "answer_url",
    "past_results_url",
    "instructions"
  ]
}