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ờ.

GEThttps://apibox.io.vn/v1/countries
Dữ liệu & JSON▶ Dùng thử online

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ênVị tríKiểuBắt buộcMặc định
codequery|pathstringkhôngMã ISO alpha-2, alpha-3 hoặc mã số (dùng được cả /v1/countries/VN).
qquerystringkhôngTìm theo tên (tiếng Anh, tiếng Việt có hoặc không dấu, tên bản địa).
calling_codequerystringkhôngMã quay số hoặc số điện thoại đầy đủ (+84, 1876).
currencyquerystringkhôngMã tiền tệ ISO 4217 (EUR).
languagequerystringkhôngMã ngôn ngữ ISO 639-1 (fr).
continentquerystringkhôngAS, EU, AF, NA, SA, OC, AN hoặc tên (Asia, châu Á).
timezonequerystringkhôngMúi giờ IANA (Europe/Berlin).
fullquerybooleankhôngfalseĐầy đủ chi tiết trong danh sách (object tiền tệ, ngôn ngữ, tên khác).
limitquerynumberkhôngSố 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"

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

Bắt đầu với 1.000 request miễn phí mỗi tháng. Nhận API key miễn phí →