Teencode Normaliser API

Normalise Vietnamese teencode and chat abbreviations (ko, dc, j, z, ntn, iu…), repeated letters and leftover Telex, keeping case. Changes listed.

Parameters

Example

curl "https://apibox.io.vn/v1/vn-teencode?text=ko%20dc%20j%20%E1%BA%A1%2C%20shop%20%C6%A1iiii%2C%20sp%20n%C3%A0yyy%20bn%20z" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/vn-teencode?text=ko%20dc%20j%20%E1%BA%A1%2C%20shop%20%C6%A1iiii%2C%20sp%20n%C3%A0yyy%20bn%20z', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
  },
});
const data = await res.json();
console.log(data);

import requests

res = requests.get(
    "https://apibox.io.vn/v1/vn-teencode?text=ko%20dc%20j%20%E1%BA%A1%2C%20shop%20%C6%A1iiii%2C%20sp%20n%C3%A0yyy%20bn%20z",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-teencode?text=ko%20dc%20j%20%E1%BA%A1%2C%20shop%20%C6%A1iiii%2C%20sp%20n%C3%A0yyy%20bn%20z');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Response

{
  "input": "ko dc j ạ, shop ơiiii, sp nàyyy bn z",
  "text": "không được gì ạ, shop ơi, sản phẩm này bao nhiêu vậy",
  "changes": [
    {
      "from": "ko",
      "to": "không",
      "start": 0,
      "end": 2,
      "rule": "abbreviation"
    },
    {
      "from": "dc",
      "to": "được",
      "start": 3,
      "end": 5,
      "rule": "abbreviation"
    },
    {
      "from": "j",
      "to": "gì",
      "start": 6,
      "end": 7,
      "rule": "abbreviation"
    },
    {
      "from": "ơiiii",
      "to": "ơi",
      "start": 16,
      "end": 21,
      "rule": "repeated letters"
    },
    {
      "from": "sp",
      "to": "sản phẩm",
      "start": 23,
      "end": 25,
      "rule": "abbreviation (context)"
    },
    {
      "from": "nàyyy",
      "to": "này",
      "start": 26,
      "end": 31,
      "rule": "repeated letters"
    },
    {
      "from": "bn",
      "to": "bao nhiêu",
      "start": 32,
      "end": 34,
      "rule": "abbreviation (context)"
    },
    {
      "from": "z",
      "to": "vậy",
      "start": 35,
      "end": 36,
      "rule": "abbreviation"
    }
  ],
  "count": 8,
  "emojis": 0,
  "dictionary_size": 273,
  "note": "Rule-based: ambiguous short forms (k, v, bn, ck, s, h…) are replaced only in clear contexts. Add diacritics with /v1/vn-diacritics if the text has none."
}

Use cases

• Pre-process comments for sentiment analysis or moderation
• Normalise chatbot input before intent matching
• Clean livestream comments before order extraction
• Improve search on informal product reviews

FAQ

Related APIs