Dữ liệu quốc gia API
Mã quốc gia ISO 3166, tên tiếng Anh, tiếng Việt và bản địa, thủ đô, mã điện thoại, tiền tệ, ngôn ngữ, emoji cờ, tên miền và múi giờ.
Tra một quốc gia theo mã ISO 3166-1 alpha-2, alpha-3 hoặc mã số (/v1/countries/VN, code=VNM, code=704) hoặc tìm trong 250 quốc gia và vùng lãnh thổ: q khớp tên tiếng Anh, tiếng Việt (có hoặc không dấu: "Hàn Quốc", "han quoc", "Đức") và tên bản địa cùng các tên gọi khác; calling_code tìm theo mã quay số hoặc phần đầu số điện thoại đầy đủ (+1 876… → Jamaica, +1 → Mỹ, Canada); currency, language, continent (mã hoặc tên tiếng Anh / tiếng Việt) và timezone để lọc danh sách.
Mỗi quốc gia có các mã, tên tiếng Anh, tiếng Việt và bản địa, tên gọi khác, thủ đô, châu lục (kèm tên tiếng Việt), mã điện thoại, tiền tệ (mã ISO 4217, tên, ký hiệu, số chữ số thập phân), ngôn ngữ (ISO 639-1 kèm tên bản địa), emoji cờ, tên miền quốc gia và múi giờ IANA. Không có bộ lọc thì trả về toàn bộ danh sách dạng gọn (full=true để có đủ chi tiết).
Dữ liệu từ countries-list và i18n-iso-countries (MIT) cùng cơ sở dữ liệu múi giờ IANA (public domain), tên tiếng Việt thông dụng được rà soát thủ công, cập nhật hằng tuần. Cờ chỉ trả về dạng emoji (không dẫn ảnh từ nơi khác).
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
code | query|path | string | không | Mã ISO alpha-2, alpha-3 hoặc mã số (dùng được cả /v1/countries/VN). | |
q | query | string | không | Tìm theo tên (tiếng Anh, tiếng Việt có hoặc không dấu, tên bản địa). | |
calling_code | query | string | không | Mã quay số hoặc số điện thoại đầy đủ (+84, 1876). | |
currency | query | string | không | Mã tiền tệ ISO 4217 (EUR). | |
language | query | string | không | Mã ngôn ngữ ISO 639-1 (fr). | |
continent | query | string | không | AS, EU, AF, NA, SA, OC, AN hoặc tên (Asia, châu Á). | |
timezone | query | string | không | Múi giờ IANA (Europe/Berlin). | |
full | query | boolean | không | false | Đầy đủ chi tiết trong danh sách (object tiền tệ, ngôn ngữ, tên khác). |
limit | query | number | không | Số kết quả tối đa (1–300; 50 khi có lọc). |
Ví dụ
curl "https://apibox.io.vn/v1/countries?q=H%C3%A0n%20Qu%E1%BB%91c" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/countries?q=H%C3%A0n%20Qu%E1%BB%91c', {
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/countries?q=H%C3%A0n%20Qu%E1%BB%91c",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/countries?q=H%C3%A0n%20Qu%E1%BB%91c');
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ề
{
"count": 1,
"filters": {
"q": "Hàn Quốc"
},
"countries": [
{
"alpha2": "KR",
"alpha3": "KOR",
"numeric": "410",
"name": "South Korea",
"name_vi": "Hàn Quốc",
"native": "대한민국",
"flag": "🇰🇷",
"aliases": [
"Korea, Republic of",
"Republic of Korea",
"Nam Hàn",
"Đại Hàn Dân Quốc"
],
"capital": "Seoul",
"continent": "AS",
"continent_name": "Asia",
"continent_name_vi": "Châu Á",
"calling_codes": [
"+82"
],
"currencies": [
{
"code": "KRW",
"name": "South Korean Won",
"native": "대한민국 원",
"symbol": "₩",
"symbol_native": "₩",
"numeric": "410",
"decimals": 0
}
],
"languages": [
{
"code": "ko",
"name": "Korean",
"native": "한국어"
}
],
"tld": [
".kr"
],
"timezones": [
"Asia/Seoul"
],
"score": 100
}
],
"source": "Data: countries-list (MIT), i18n-iso-countries (MIT), IANA tz database (public domain)",
"updated": "2026-11-11"
}
Ứng dụng
- Làm ô chọn quốc gia song ngữ Anh - Việt
- Kiểm tra mã quốc gia ISO khi nhập dữ liệu, điền form
- Đoán quốc gia của số điện thoại theo đầu số
- Hiển thị tiền tệ và múi giờ theo quốc gia của khách hàng
Hỏi đáp
Có tên tiếng Việt không?
Có, name_vi cho mọi quốc gia (Hàn Quốc, Đức, Hoa Kỳ…), kèm tên khác như Mỹ, Nam Hàn trong aliases; tìm kiếm không cần gõ dấu.
Vì sao +1 trả về nhiều nước?
Khu vực Bắc Mỹ dùng chung mã +1; hãy gửi thêm chữ số (ví dụ +1876) để ra đúng nước như Jamaica.
Có Kosovo không?
Có, với mã tự gán XK (đánh dấu user_assigned_code), như EU và nhiều API khác vẫn dùng.
API liên quan
Kiểm tra JSON
Kiểm tra cú pháp JSON, báo đúng dòng và cột bị lỗi, và validate dữ liệu theo JSON Schema (draft 4, 7, 2019-09 hoặc 2020-12).
{ }Định dạng JSON
Làm đẹp JSON với thụt lề 0-8 dấu cách hoặc tab, rút gọn (minify) hoặc sắp xếp key theo bảng chữ cái. Báo lỗi cú pháp kèm dòng và cột.
CSVCSV sang JSON
Chuyển CSV thành mảng object JSON theo dòng tiêu đề, tự nhận dấu phân cách, tự chuyển số và boolean, báo lỗi từng dòng.