Developer Beta

API Playground

Chọn endpoint, sửa tham số, gửi yêu cầu thật tới Address API v1 và copy mã tương ứng.

RequestGET /v1/address/autocomplete

Tham số query (JSON)

Cần JavaScript để gửi từ trang này; phản hồi bên cạnh là kết quả thật của ví dụ.

ResponseHTTP 200

{
  "apiVersion": "1",
  "status": "beta",
  "data": {
    "items": [
      {
        "type": "ward_new",
        "model": "new",
        "name": "Phường Vườn Lài",
        "label": "Phường Vườn Lài, Thành phố Hồ Chí Minh",
        "code": "27190",
        "slug": "phuong-vuon-lai",
        "dissolved": false
      },
      {
        "type": "ward_old",
        "model": "old",
        "name": "Xã Lai Vu",
        "label": "Xã Lai Vu, Huyện Kim Thành, Tỉnh Hải Dương",
        "code": "10753",
        "slug": "xa-lai-vu",
        "dissolved": true
      },
      {
        "type": "ward_new",
        "model": "new",
        "name": "Xã Lai Vung",
        "label": "Xã Lai Vung, Tỉnh Đồng Tháp",
        "code": "30226",
        "slug": "xa-lai-vung",
        "dissolved": false
      },
      {
        "type": "district_old",
        "model": "old",
        "name": "Huyện Lai Vung",
        "label": "Huyện Lai Vung, Tỉnh Đồng Tháp",
        "code": "876",
        "slug": "huyen-lai-vung",
        "dissolved": false
      },
      {
        "type": "ward_old",
        "model": "old",
        "name": "Thị trấn Lai Vung",
        "label": "Thị trấn Lai Vung, Huyện Lai Vung, Tỉnh Đồng Tháp",
        "code": "30208",
        "slug": "thi-tran-lai-vung",
        "dissolved": false
      }
    ]
  },
  "meta": {
    "requestId": "req-72",
    "tookMs": 434,
    "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"
      }
    ]
  }
}

cURL

curl 'https://tradiachi.com/v1/address/autocomplete?q=vuon+lai&limit=5&scope=all'

JavaScript

const res = await fetch('https://tradiachi.com/v1/address/autocomplete?q=vuon+lai&limit=5&scope=all');
const { data, error } = await res.json();

Python

import requests

res = requests.get('https://tradiachi.com/v1/address/autocomplete?q=vuon+lai&limit=5&scope=all', timeout=10)
print(res.json())

PHP

<?php
$res = file_get_contents('https://tradiachi.com/v1/address/autocomplete?q=vuon+lai&limit=5&scope=all');
var_dump(json_decode($res, true));