Tra ngược từ cả câu địa chỉ ra mã hành chính HIỆN HÀNH

Tự tách câu thành tỉnh và phường/xã, trả về tỉnh khớp cùng danh sách phường/xã khớp, ưu tiên kết quả khớp chính xác tên.

GET https://api-tools.hitechcloud.vn/api/vn/lookup Đã chép

Cần khoá API

Tham số

q string · truy vấn

Cả câu địa chỉ theo địa giới HIỆN HÀNH, ví dụ Phường Cửa Nam, Hà Nội. Bắt buộc nếu không truyền ward/province.

ward string · truy vấn

Tên phường/xã khi đã tách sẵn; ưu tiên hơn phần tách được từ q.

province string · truy vấn

Tên tỉnh/thành hiện hành khi đã tách sẵn; ưu tiên hơn phần tách được từ q.

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/vn/lookup?q=GIA_TRI&ward=GIA_TRI&province=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/vn/lookup', [
    'q' => 'GIA_TRI',
    'ward' => 'GIA_TRI',
    'province' => 'GIA_TRI',
]);

$data = $response->json();

javascript

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

const res = await fetch(`https://api-tools.hitechcloud.vn/api/vn/lookup?${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/vn/lookup",
    headers={"X-API-Key": os.environ["HITECH_API_KEY"]},
    params={
        "q": "GIA_TRI",
        "ward": "GIA_TRI",
        "province": "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 truy vấn

ward truy vấn

province 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ự...