Vietnamese Spell Checker API

Check Vietnamese spelling: invalid syllables, c/k, g/gh, ng/ngh rules, frequent mistakes (xử dụng, sử lý, nghành) and punctuation, with suggestions.

Parameters

Example

curl -X POST "https://apibox.io.vn/v1/vn-spellcheck" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Chúng tôi xử dụng công nghệ để sử lý dữ liệu ,giúp doanh nghiệp phát triễn. kết quả rất tốt."}'

const res = await fetch('https://apibox.io.vn/v1/vn-spellcheck', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "text": "Chúng tôi xử dụng công nghệ để sử lý dữ liệu ,giúp doanh nghiệp phát triễn. kết quả rất tốt."
  }),
});
const data = await res.json();
console.log(data);

import requests

res = requests.post(
    "https://apibox.io.vn/v1/vn-spellcheck",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"text": "Chúng tôi xử dụng công nghệ để sử lý dữ liệu ,giúp doanh nghiệp phát triễn. kết quả rất tốt."},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-spellcheck');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"text":"Chúng tôi xử dụng công nghệ để sử lý dữ liệu ,giúp doanh nghiệp phát triễn. kết quả rất tốt."}',
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Response

{
  "errors": 3,
  "warnings": 0,
  "info": 2,
  "issues": [
    {
      "start": 10,
      "end": 17,
      "text": "xử dụng",
      "type": "common_misspelling",
      "severity": "error",
      "message_vi": "Viết đúng là \"sử dụng\"",
      "message_en": "The correct spelling is \"sử dụng\"",
      "suggestions": [
        "sử dụng"
      ]
    },
    {
      "start": 31,
      "end": 36,
      "text": "sử lý",
      "type": "common_misspelling",
      "severity": "error",
      "message_vi": "Viết đúng là \"xử lý\"",
      "message_en": "The correct spelling is \"xử lý\"",
      "suggestions": [
        "xử lý"
      ]
    },
    {
      "start": 44,
      "end": 46,
      "text": " ,",
      "type": "punctuation",
      "severity": "info",
      "message_vi": "Không đặt dấu cách trước dấu câu",
      "message_en": "No space before punctuation",
      "suggestions": [
        ", "
      ]
    },
    {
      "start": 69,
      "end": 74,
      "text": "triễn",
      "type": "unknown_syllable",
      "severity": "error",
      "message_vi": "Âm tiết không tồn tại trong tiếng Việt",
      "message_en": "Not a Vietnamese syllable",
      "suggestions": [
        "triển",
        "triền",
        "tiền"
      ]
    },
    {
      "start": 76,
      "end": 77,
      "text": "k",
      "type": "capitalization",
      "severity": "info",
      "message_vi": "Viết hoa chữ cái đầu câu",
      "message_en": "Capitalise the first letter of the sentence",
      "suggestions": [
        "K"
      ]
    }
  ],
  "corrected": "Chúng tôi sử dụng công nghệ để xử lý dữ liệu, giúp doanh nghiệp phát triển. Kết quả rất tốt.",
  "note": "Spelling check: syllables, spelling rules and frequent mistakes. Grammar and word choice (e.g. dành / giành) are not checked."
}

Use cases

• Check product descriptions and articles before publishing
• Proofread customer-facing e-mails and notifications
• Clean user-generated content in forms and reviews
• Quality checks on translated or AI-generated Vietnamese

FAQ

Related APIs