RESTful API từ điển tiếng Việt và đa ngôn ngữ miễn phí. Hệ thống cung cấp dữ liệu tra cứu chi tiết, phát âm IPA, từ đồng nghĩa và ví dụ minh họa cho hàng trăm ngàn từ vựng.
🔗 Website & Documentation: dict.minhqnd.com
Hệ thống được vận hành trên nền tảng dữ liệu lớn và tối ưu:
- Tổng số từ vựng: 357,729+
- Định nghĩa chi tiết: 443,116+
- Từ vựng có ví dụ: 169,931+
- Tổng số ngôn ngữ: > 1,500 (Tiếng Việt, Anh, Trung, Nhật, Hàn, Pháp, Đức...)
Bạn có thể tải xuống toàn bộ dữ liệu từ điển dưới dạng file SQLite (dictionary.db) tại phần Releases của repository này để sử dụng offline hoặc tích hợp vào dự án cá nhân.
- 🔍 Tìm kiếm thông minh: Không phân biệt hoa thường, tự động chuẩn hoá diacritic tiếng Việt (ví dụ:
hoá↔hóa,kì↔kỳ). - 🔊 Phát âm TTS: Tích hợp Google TTS chuẩn cao.
- ⚡ Siêu nhanh: Kiến trúc Next.js 15 kết hợp SQLite và Vercel Edge Cache cho tốc độ phản hồi < 100ms.
- 🌐 CORS Ready: Hỗ trợ gọi API từ browser trực tiếp mà không bị chặn Cross-Origin.
- 📱 SEO Toàn diện: Metadata động và OpenGraph Image tự động tạo cho từng mục từ.
GET https://dict.minhqnd.com/api/v1/lookup?word={word}&lang={lang}&def_lang={def_lang}
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
word |
Yes | Từ cần tra cứu (ví dụ: học sinh) |
lang |
No | Mã ngôn ngữ nguồn (vi, en, zh...) |
def_lang |
No | Lọc ngôn ngữ định nghĩa (vi hoặc en) |
GET https://dict.minhqnd.com/api/v1/suggest?q={prefix}&limit={limit}
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
q |
Yes | Chuỗi prefix cần gợi ý (ví dụ: học) |
limit |
No | Giới hạn kết quả (1-20, mặc định: 5) |
GET https://dict.minhqnd.com/api/v1/tts?word={word}&lang={lang}
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
word |
Yes | Từ cần phát âm |
lang |
No | Mã ngôn ngữ (mặc định: vi) |
{
"exists": true,
"word": "học sinh",
"results": [{
"lang_code": "vi",
"lang_name": "Tiếng Việt",
"audio": "/api/v1/tts?word=h%E1%BB%8Dc%20sinh&lang=vi",
"meanings": [
{
"definition": "người học ở bậc phổ thông",
"definition_lang": "vi",
"example": "học sinh tiểu học ~ thời học sinh",
"pos": "Danh từ",
"sub_pos": "Danh từ chỉ vật, hiện tượng",
"source": "Tiếng Việt Thông Dụng",
"links": []
},
{
"definition": "Trẻ em học tập ở nhà trường.",
"definition_lang": "vi",
"example": "Học sinh trung học.",
"pos": "Danh từ",
"source": "Wiktionary",
"links": []
},
{
"definition": "a student",
"definition_lang": "en",
"pos": "Danh từ",
"source": "Wiktionary EN",
"links": []
}
],
"pronunciations": [
{ "ipa": "[hawk͡p̚˧˨ʔ sïŋ˧˧]", "region": "Hà-Nội" },
{ "ipa": "[hawk͡p̚˨˩ʔ sɨn˧˧]", "region": "Huế" },
{ "ipa": "[hawk͡p̚˨˩˨ sɨn˧˧]", "region": "Saigon" }
],
"translations": [
{ "lang_code": "en", "translation": "student", "lang_name": "Tiếng Anh" },
{ "lang_code": "en", "translation": "pupil", "lang_name": "Tiếng Anh" },
{ "lang_code": "zh", "translation": "學生", "lang_name": "Tiếng Trung Quốc" }
],
"relations": [
{ "related_word": "học viên", "relation_type": "Đồng nghĩa" },
{ "related_word": "sinh viên", "relation_type": "Đồng nghĩa" }
]
}]
}Dữ liệu được tổng hợp từ các dự án mã nguồn mở:
- vntk/dictionary: MIT License
- Hồ Ngọc Đức (Free Vietnamese Dictionary Project): GNU GPL
- Vietnamese Explanatory Dictionary: GNU GPL
- tudientv.com: GNU GPL
- Wiktionary & Wikipedia Tiếng Việt: CC BY-SA 4.0
Note
Một số câu ví dụ được bổ sung tự động bằng AI (LLM) để tăng tính ứng dụng cho các từ vựng chưa có ví dụ gốc.
Dự án này sử dụng mô hình Giấy phép kép (Dual Licensing) để phân tách rõ ràng giữa mã nguồn và dữ liệu:
Toàn bộ mã nguồn trong repository này (Next.js, API logic, UI components) được phát hành dưới giấy phép MIT. Bạn có quyền tự do sử dụng, sao chép và chỉnh sửa cho cả mục đích cá nhân và thương mại.
Dữ liệu từ điển (bao gồm file dictionary.db) được cung cấp bởi @minhqnd theo giấy phép Creative Commons Attribution-ShareAlike 4.0 (CC BY-SA 4.0).
Tip
Điều này đảm bảo dữ liệu từ điển luôn được mở và cộng đồng có thể kế thừa, phát triển tiếp. Dữ liệu được tổng hợp từ nhiều nguồn mở (Wiktionary, Hồ Ngọc Đức, vntk...). Vui lòng tuân thủ các điều khoản ghi công khi sử dụng lại bộ dữ liệu này.
Khi sử dụng dữ liệu này, bạn có thể tự do:
- ✅ Chia sẻ: Sao chép và phân phối lại dữ liệu từ điển, kể cả thương mại.
- ✅ Chuyển thể: Chỉnh sửa, bổ sung và xây dựng dựa trên dữ liệu từ điển.
Với các điều kiện
- 📌 Ghi công: Ghi rõ nguồn
@minhqnd, liên kết đến dict.minhqnd.com. - 📌 Chia sẻ tương tự: Nếu bạn chỉnh sửa và phân phối lại dữ liệu, bạn phải sử dụng cùng giấy phép CC BY-SA 4.0.
Important
Khi sử dụng dữ liệu này, vui lòng ghi công và dẫn nguồn về dict.minhqnd.com theo đúng điều khoản của giấy phép để người dùng có thể tra cứu được nguồn từ điển gốc.
git clone https://github.com/minhqnd/dictionary.git
cd dictionary
pnpm install
# Download database từ Releases (bắt buộc)
pnpm install-db
pnpm devNote
File dictionary.db không được lưu trong Git để giảm dung lượng repository. Bạn cần tải về từ Releases trước khi chạy. (Hết quota LFS nên phải dùng cách này :)) )
minhqnd - minhqnd.com