Phân tích họ tên người Việt API

Tách họ tên người Việt thành họ, tên đệm, tên; chuẩn hoá viết hoa, đoán giới tính kèm xác suất, gợi ý xưng hô anh / chị và địa chỉ email.

Tham số

Ví dụ

curl "https://apibox.io.vn/v1/vn-name?name=nguy%E1%BB%85n%20%20th%E1%BB%8B%20thu%20H%C6%AF%C6%A0NG" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/vn-name?name=nguy%E1%BB%85n%20%20th%E1%BB%8B%20thu%20H%C6%AF%C6%A0NG', {
  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-name?name=nguy%E1%BB%85n%20%20th%E1%BB%8B%20thu%20H%C6%AF%C6%A0NG",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-name?name=nguy%E1%BB%85n%20%20th%E1%BB%8B%20thu%20H%C6%AF%C6%A0NG');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Kết quả trả về

{
  "input": "nguyễn  thị thu HƯƠNG",
  "full_name": "Nguyễn Thị Thu Hương",
  "family_name": "Nguyễn",
  "middle_name": "Thị Thu",
  "given_name": "Hương",
  "first_name": "Thị Thu Hương",
  "last_name": "Nguyễn",
  "order_detected": "family_first",
  "word_count": 4,
  "unaccented": "Nguyen Thi Thu Huong",
  "upper_unaccented": "NGUYEN THI THU HUONG",
  "initials": "NTTH",
  "gender": "female",
  "gender_probability_female": 1,
  "gender_confidence": 1,
  "gender_evidence": [
    "middle name \"Thị\" (female)",
    "given name \"hương\": 0 male / 25 female names"
  ],
  "salutation": {
    "informal": "chị",
    "formal": "bà",
    "greeting_vi": "Chào chị Hương",
    "letter_vi": "Kính gửi Bà Nguyễn Thị Thu Hương"
  },
  "slug": "nguyen-thi-thu-huong",
  "email_local_parts": [
    "huongntt",
    "huong.nguyen",
    "nguyenthithuhuong"
  ],
  "sort_key": "kzspj xkl xky pjy}ip~11111111611111111141",
  "warnings": [],
  "source": "Gender statistics: duyet/vietnamese-namedb (MIT, © Van-Duyet Le), 1230 male / 1303 female names; updated 2026-11-11",
  "note": "Gender is a statistical guess from the name only; do not use it for decisions about a person."
}

Ứng dụng

• Cá nhân hoá email, SMS (“Chào chị Hương”)
• Tách họ tên đầy đủ thành trường họ / tên trong CRM
• Sắp xếp danh sách lớp, nhân viên theo tên
• Tạo địa chỉ email công ty và tên in thẻ không dấu

Hỏi đáp

API liên quan