Tìm đơn vị hành chính theo tên

KHÔNG phân biệt dấu và không phân biệt hoa thường. Chấp nhận cả tên có dấu (`Ba Đình`), tên không dấu (`ba dinh`), tên tiếng Anh (`Ba Dinh`) và chuỗi định danh (`ba_dinh`). Lọc thêm được theo cấp (`level=province|ward`) và theo tỉnh (`province=01`). Kết quả xếp theo độ khớp: khớp trọn tên lên trước, rồi khớp từ đầu, rồi khớp giữa chuỗi. Trường `truncated` cho biết danh sách đã bị cắt hay chưa.

GET https://api-tools.hitechcloud.vn/api/opendata/admin/search Đã chép

Cần khoá API

Tham số

q string · truy vấn bắt buộc

Từ khoá tên đơn vị, tối thiểu 2 ký tự. Có dấu, không dấu, tiếng Anh hay chuỗi định danh đều được.

level string · truy vấn

Lọc theo cấp: province hoặc ward. Bỏ trống thì tìm cả hai cấp.

province string · truy vấn

Chỉ tìm trong một tỉnh, truyền mã tỉnh hai chữ số.

limit string · truy vấn

Số kết quả tối đa, 1–200, mặc định 30.

Mã trả về

200 Thành công.

401 Thiếu hoặc sai khoá API. Gửi kèm header X-API-Key.

404 Không tìm thấy dữ liệu tương ứng.

429 Vượt hạn mức của khoá. Xem header Retry-After.

Ví dụ gọi

bash

curl --location 'https://api-tools.hitechcloud.vn/api/opendata/admin/search?q=GIA_TRI&level=GIA_TRI&province=GIA_TRI&limit=GIA_TRI' \
--header 'X-API-Key: $HITECH_API_KEY' \
--header 'Accept: application/json'

php

$response = Http::withHeaders([
    'X-API-Key' => env('HITECH_API_KEY'),
])->get('https://api-tools.hitechcloud.vn/api/opendata/admin/search', [
    'q' => 'GIA_TRI',
    'level' => 'GIA_TRI',
    'province' => 'GIA_TRI',
    'limit' => 'GIA_TRI',
]);

$data = $response->json();

javascript

const q = new URLSearchParams({
  q: 'GIA_TRI',
  level: 'GIA_TRI',
  province: 'GIA_TRI',
  limit: 'GIA_TRI',
});

const res = await fetch(`https://api-tools.hitechcloud.vn/api/opendata/admin/search?${q}`, {
  headers: { 'X-API-Key': process.env.HITECH_API_KEY },
});

const data = await res.json();

python

import os, requests

res = requests.get(
    "https://api-tools.hitechcloud.vn/api/opendata/admin/search",
    headers={"X-API-Key": os.environ["HITECH_API_KEY"]},
    params={
        "q": "GIA_TRI",
        "level": "GIA_TRI",
        "province": "GIA_TRI",
        "limit": "GIA_TRI",
    },
)
data = res.json()

Đã chép mã

Thử ngay

X-API-Key

Khoá chỉ lưu trong trình duyệt của bạn. Lấy khoá →

q bắt buộc truy vấn

level truy vấn

province truy vấn

limit truy vấn

Cùng nhóm

GET Danh sách quốc gia kèm mã ISO và mã điện thoại GET Tra ngược từ mã bưu chính năm chữ số ra các xã... GET Danh sách 34 tỉnh và thành phố trực thuộc trun... GET Chi tiết một tỉnh hoặc thành phố trực thuộc tr... GET Toàn bộ xã GET Đoán tỉnh và xã/phường từ một chuỗi địa chỉ tự...