Developer · Address API Beta

Address API

Chuẩn hoá, tách, kiểm tra, so sánh và tra lịch sử địa chỉ Việt Nam qua REST. Cùng bộ dữ liệu và cùng kết quả với các công cụ trên web.

Gọi thử API Tài liệu

Endpoint

Endpoint	Chức năng	Trạng thái
`POST /v1/address/normalize`	Chuẩn hoá địa chỉ	Beta
`POST /v1/address/parse`	Tách địa chỉ	Beta
`POST /v1/address/validate`	Kiểm tra địa chỉ	Beta
`POST /v1/address/compare`	So sánh 2 địa chỉ	Beta
`POST /v1/address/history`	Lịch sử hành chính	Beta
`GET /v1/address/autocomplete`	Gợi ý đơn vị hành chính	Beta
`API key, hạn mức riêng, batch`	Cho gói trả phí	Sắp ra mắt

Beta nghĩa là

Miễn phí, chưa cần API key; giới hạn 30 yêu cầu/phút cho mỗi IP (header RateLimit-*).
Định dạng phản hồi { apiVersion, status, data | error, meta } giữ ổn định trong v1; có thể thêm trường mới, không đổi nghĩa trường cũ.
Không có “% tin cậy”: confidence.level là exact | fuzzy | ambiguous | not_found.

Bắt đầu nhanh

cURL

curl -X POST https://tradiachi.com/v1/address/normalize \
  -H 'content-type: application/json' \
  -d '{"address":"12 nguyen hue p ben nghe q1 tphcm"}'

Phản hồi thật · HTTP 200

{
  "apiVersion": "1",
  "status": "beta",
  "data": {
    "address": {
      "input": "12 nguyen hue p ben nghe q1 tphcm",
      "sources": [
        {
          "id": "gso-2025",
          "name": "Danh mục đơn vị hành chính – Tổng cục Thống kê",
          "asOf": "2025-03-01"
        },
        {
          "id": "nq-202-2025",
          "name": "Nghị quyết 202/2025/QH15 và các nghị quyết sắp xếp cấp xã năm 2025",
          "asOf": "2025-07-01"
        }
      ],
      "confidence": {
        "level": "exact",
        "ai": false
      },
      "dataUpdated": "2026-09-30",
      "normalized": "12 nguyen hue, Phường Sài Gòn, Thành phố Hồ Chí Minh",
      "houseNumber": "12",
      "street": "nguyen hue",
      "ward": {
        "name": "Phường Sài Gòn",
        "code": "26740",
        "slug": "phuong-sai-gon"
      },
      "province": {
        "name": "Thành phố Hồ Chí Minh",
        "code": "79",
        "slug": "ho-chi-minh"
      },
      "historical": {
        "oldWard": {
          "name": "Phường Bến Nghé",
          "code": "26740",
          "slug": "phuong-ben-nghe"
        },
        "oldDistrict": {
          "name": "Quận 1",
          "code": "760",
          "slug": "quan-1"
        },
        "oldProvince": {
          "name": "Thành phố Hồ Chí Minh",
          "code": "79",
          "slug": "thanh-pho-ho-chi-minh"
        }
      }
    },
    "candidates": []
  },
  "meta": {
    "requestId": "req-6y",
    "tookMs": 20,
    "sources": [
      {
        "id": "gso-2025",
        "name": "Danh mục đơn vị hành chính – Tổng cục Thống kê",
        "asOf": "2025-03-01"
      },
      {
        "id": "nq-202-2025",
        "name": "Nghị quyết 202/2025/QH15 và các nghị quyết sắp xếp cấp xã năm 2025",
        "asOf": "2025-07-01"
      }
    ]
  }
}

Cần xử lý lớn, API key hoặc hạn mức riêng? Xem giải pháp doanh nghiệp và bảng giá.