Tra cứu ngay:
Tài liệu API
Dữ liệu hệ thống
- Tổng số từ vựng:357,729
- Định nghĩa chi tiết:443,116
- Từ vựng có ví dụ minh họa:169,931
- Tổng số ngôn ngữ:> 1,500
Đặc điểm nổi bật
- ●Tìm kiếm không phân biệt hoa thường
- ●Chuẩn hoá tiếng Việt (hoá/hóa, kì/kỳ)
- ●Tốc độ phản hồi nhanh (SQLite)
- ●Hỗ trợ RESTful API & JSON
- ●Tra cứu đa ngôn ngữ (Anh, Trung, Nhật, Hàn...)
https://dict.minhqnd.com/api/v1/lookupTham số truy vấn (Query)
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
| word | YES | Từ cần tra cứu. Ví dụ: "học sinh" |
| lang | NO | Ngôn ngữ của từ. Ví dụ: "vi", "en", "zh" |
| def_lang | NO | Lọc theo ngôn ngữ định nghĩa. Ví dụ: "en" để chỉ lấy nghĩa tiếng Anh (hiện chỉ có vi/en) |
Ví dụ triển khai
const word = "học sinh";
const url = `https://dict.minhqnd.com/api/v1/lookup?word=${encodeURIComponent(word)}`;
fetch(url)
.then(res => res.json())
.then(data => {
if (data.exists) {
console.log(`Từ: ${data.word}`);
data.results.forEach(lang => {
console.log(`\n[${lang.lang_name}]`);
lang.meanings.forEach((m, i) => {
console.log(` ${i + 1}. [${m.pos}] ${m.definition}`);
if (m.example) console.log(` Ví dụ: ${m.example}`);
});
if (lang.pronunciations?.length) {
console.log(` IPA: ${lang.pronunciations[0].ipa} (${lang.pronunciations[0].region})`);
}
});
}
});Tìm thấy từ (200 Found)
{
"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" }
]
}]
}Không tìm thấy (404 Not Found)
{
"exists": false
}Cấu trúc dữ liệu JSON
| Trường | Kiểu | Mô tả |
|---|---|---|
| exists | boolean | Dữ liệu có tồn tại trong từ điển không. |
| word | string | Từ gốc được chuẩn hóa. |
| results | LanguageResult[] | Danh sách kết quả theo từng ngôn ngữ. |
| Trường | Kiểu | Mô tả |
|---|---|---|
| lang_code | string | Mã ngôn ngữ (ISO 639): vi, en, zh... |
| lang_name | string | Tên ngôn ngữ: Tiếng Việt, English... |
| audio | string | URL endpoint phát âm TTS. |
| meanings | Meaning[] | Danh sách định nghĩa. |
| pronunciations | Pronunciation[] | Phiên âm IPA theo vùng miền. |
| translations | Translation[] | Bản dịch sang các ngôn ngữ khác. |
| relations | Relation[] | Từ liên quan (đồng nghĩa, trái nghĩa). |
| Trường | Kiểu | Mô tả |
|---|---|---|
| definition | string | Nội dung định nghĩa. |
| definition_lang | string | Ngôn ngữ định nghĩa: vi, en... |
| example | string? | Ví dụ minh hoạ (null nếu không có). |
| pos | string? | Từ loại: Danh từ, Động từ, Tính từ... |
| sub_pos | string? | Từ loại phụ chi tiết hơn. |
| source | string | Nguồn dữ liệu: Wiktionary, TVTD... |
| links | string[] | Các từ liên quan trong định nghĩa. |
| ipa | string | Phiên âm IPA |
| region | string | Vùng miền |
| lang_code | string | Mã ngôn ngữ |
| lang_name | string | Tên ngôn ngữ |
| translation | string | Bản dịch |
| related_word | string | Từ liên quan |
| relation_type | string | Loại quan hệ |
Mã lỗi HTTP
| Mã | Trạng thái | Mô tả |
|---|---|---|
| 200 | OK | Tìm thấy từ, trả về định nghĩa. |
| 400 | Bad Request | Thiếu tham số word. |
| 404 | Not Found | Từ không tồn tại trong từ điển. |
Lưu ý về Encoding
Tiếng Việt có dấu cần được encode theo chuẩn UTF-8 URL encoding:
CORS (Cross-Origin)
API hỗ trợ CORS. Bạn có thể gọi API từ bất kỳ domain nào.
https://dict.minhqnd.com/api/v1/suggestAPI gợi ý từ dựa trên prefix. Trả về danh sách các từ khớp với chuỗi tìm kiếm.
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
| q | YES | Chuỗi prefix (ví dụ: "học") |
https://dict.minhqnd.com/api/v1/ttsEndpoint tạo file âm thanh (TTS) cho từ vựng. Trả về file định dạng audio/mpeg.
| 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) |
Nguồn dữ liệu & Giấy phép
Nguồn từ: github.com/vntk/dictionary
Từ 'The Free Vietnamese Dictionary Project'
Từ điển giải thích tiếng Việt
Nguồn từ: tudientv.com
Dữ liệu từ Wiktionary và Wikipedia tiếng Việt
Một số câu ví dụ được tạo bởi AI/LLM để bổ sung cho các mục từ chưa có ví dụ minh họa.
Điều khoản sử dụng
API từ điển được cung cấp bởi @minhqnd theo giấy phépCC BY-SA 4.0.
Bạn được 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.
Người cấp phép không thể thu hồi những quyền tự do này chừng nào bạn còn tuân thủ các điều khoản.
Với điều kiện:
- •Ghi công — ghi nguồn
@minhqnd, liên kết đến dict.minhqnd.com và ghi chú nếu có thay đổi. - •Chia sẻ tương tự — phân phối bản chỉnh sửa theo cùng giấy phép CC BY-SA 4.0.
- •Không hạn chế bổ sung — không được áp dụng điều khoản pháp lý hoặc biện pháp công nghệ hạn chế người khác.
📌 Lưu ý: Khi sử dụng API, vui lòng dẫn link đến dict.minhqnd.com để người dùng có thể xem các nguồn và giấy phép chi tiết của từng nguồn dữ liệu gốc.