Vietnamese quiz parser API

Read a Vietnamese multiple-choice exam from Word or text ("Câu 1. … A. … B. …") with its answers and export JSON, GIFT, Aiken, Moodle XML or Quizizz CSV.

Parameters

Example

curl -X POST "https://apibox.io.vn/v1/vn-quiz-parse" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Câu 1. Thủ đô của Việt Nam là\nA. TP. Hồ Chí Minh\t*B. Hà Nội\nC. Đà Nẵng\tD. Huế\nCâu 2. 2 + 2 = ?\nA. 3\nB. 4\nC. 5\nD. 6\nĐáp án: B\nLời giải: 2 + 2 = 4."}'

const res = await fetch('https://apibox.io.vn/v1/vn-quiz-parse', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "text": "Câu 1. Thủ đô của Việt Nam là\nA. TP. Hồ Chí Minh\t*B. Hà Nội\nC. Đà Nẵng\tD. Huế\nCâu 2. 2 + 2 = ?\nA. 3\nB. 4\nC. 5\nD. 6\nĐáp án: B\nLời giải: 2 + 2 = 4."
  }),
});
const data = await res.json();
console.log(data);

import requests

res = requests.post(
    "https://apibox.io.vn/v1/vn-quiz-parse",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"text": "Câu 1. Thủ đô của Việt Nam là\nA. TP. Hồ Chí Minh\t*B. Hà Nội\nC. Đà Nẵng\tD. Huế\nCâu 2. 2 + 2 = ?\nA. 3\nB. 4\nC. 5\nD. 6\nĐáp án: B\nLời giải: 2 + 2 = 4."},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-quiz-parse');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"text":"Câu 1. Thủ đô của Việt Nam là\\nA. TP. Hồ Chí Minh\\t*B. Hà Nội\\nC. Đà Nẵng\\tD. Huế\\nCâu 2. 2 + 2 = ?\\nA. 3\\nB. 4\\nC. 5\\nD. 6\\nĐáp án: B\\nLời giải: 2 + 2 = 4."}',
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Response

{
  "question_count": 2,
  "by_type": {
    "multiple_choice": 2
  },
  "answered": 2,
  "sections": [
    {
      "index": 0,
      "title": "",
      "type": null
    }
  ],
  "groups": [],
  "warnings": [],
  "answer_keys": [],
  "questions": [
    {
      "number": 1,
      "section": 0,
      "type": "multiple_choice",
      "points": null,
      "stem": "Thủ đô của Việt Nam là",
      "options": [
        {
          "label": "A",
          "text": "TP. Hồ Chí Minh"
        },
        {
          "label": "B",
          "text": "Hà Nội"
        },
        {
          "label": "C",
          "text": "Đà Nẵng"
        },
        {
          "label": "D",
          "text": "Huế"
        }
      ],
      "answer": [
        "B"
      ],
      "answer_text": null,
      "answer_source": "asterisk",
      "explanation": null,
      "group": null
    },
    {
      "number": 2,
      "section": 0,
      "type": "multiple_choice",
      "points": null,
      "stem": "2 + 2 = ?",
      "options": [
        {
          "label": "A",
          "text": "3"
        },
        {
          "label": "B",
          "text": "4"
        },
        {
          "label": "C",
          "text": "5"
        },
        {
          "label": "D",
          "text": "6"
        }
      ],
      "answer": [
        "B"
      ],
      "answer_text": null,
      "answer_source": "answer_line",
      "explanation": "2 + 2 = 4.",
      "group": null
    }
  ]
}

Use cases

• Import Word exams into an LMS or exam app
• Turn a teacher’s .docx into Quizizz, Kahoot or Moodle quizzes
• Check an exam for missing answers before printing
• Build a question bank from existing Word files

FAQ

Related APIs