APIHub - Tài Liệu Tích Hợp API

Danh Mục API

1. Xác Thực (Auth)
2. Dự Báo Thời Tiết
3. XS Truyền Thống
4. XS Điện Toán
5. Tỷ Giá Ngoại Tệ
6. Giá Xăng Dầu
7. Giá Vàng Hôm Nay
8. Giá Nông Sản
9. Lãi Suất Tiết Kiệm
10. Lãi Suất Vay
11. Mã Số Thuế
12. Khung Giá Đất Nhà Nước
🧪 API Playground (Live)
Tạo Khóa API Key Miễn Phí

Trạng Thái Hệ Thống

API Server: Hoạt động (Online)

Xác thực: X-API-KEY / Demo

CSDL Offline: 11,518 Vị trí / JSON

Phương Thức Xác Thực API (Authentication)

Tất cả request cần kèm theo API Key để được xác thực và xử lý phản hồi.

Bạn có thể tự đăng ký tài khoản tại Cổng API để tạo API Key miễn phí. Hoặc dùng thử khóa demo công khai: xs_public_demo_key_2026.

Hai cách truyền khóa API Key:

Query Parameter: Thêm tham số api_key=your_key vào URL.

GET https://pha.vn/api/v1/thoitiet/forecast?api_key=xs_public_demo_key_2026&id=8789

HTTP Headers: Truyền trong header X-API-KEY.
```
X-API-KEY: xs_public_demo_key_2026
```

API Dự Báo Thời Tiết Việt Nam (11,518 Địa Danh)

CSDL local tự động đồng bộ dự báo thời tiết 7 ngày cho toàn bộ 11,518 Tỉnh, Thành phố, Quận, Huyện, Xã, Phường tại Việt Nam.

Endpoint 1: Tra cứu 11,518 Vị trí

GET /api/v1/thoitiet/locations

Tham số	Loại	Bắt buộc	Mô tả
`q`	string	Không	Từ khóa vị trí (Ví dụ: `Bảo Lộc`, `Phường 2`, `Hà Nội`).
`limit` / `page`	number	Không	Phân trang kết quả tra cứu (mặc định: page=1, limit=25).

Endpoint 2: Dự báo thời tiết 7 ngày từ CSDL Local

GET /api/v1/thoitiet/forecast

Tham số	Loại	Bắt buộc	Mô tả
`id` / `term`	number	Không	Mã Code ID vị trí (Ví dụ: `8789` - Phường 2, Bảo Lộc). Mặc định: 8789.
`q`	string	Không	Hoặc nhập tên vị trí (Tự động tra CSDL khớp ID vị trí phù hợp nhất).

Kết quả phản hồi mẫu (JSON 200 OK từ CSDL Local):

{
  "success": true,
  "data": {
    "termId": 8789,
    "location": {
      "id": 8789,
      "name": "Phường 2",
      "fullName": "Phường 2, Bảo Lộc, Lâm Đồng"
    },
    "current": {
      "temperature": "33°",
      "feelsLike": "32°",
      "condition": "Mây thưa",
      "iconUrl": "/images/weather/04d.png"
    },
    "forecast7Days": [
      {
        "dayDate": "T4 Ngày 22/07",
        "icon": "/images/weather/10d.png",
        "temperatureRange": "19° | 35°",
        "condition": "mưa nhẹ"
      }
    ]
  }
}

API Xổ Số Truyền Thống (63 Tỉnh Thành)

Dữ liệu kết quả xổ số kiến thiết Miền Bắc, Miền Trung, Miền Nam thời gian thực.

GET /api/v1/traditional

Tham số Query:

Tham số	Loại	Bắt buộc	Mô tả
`province`	string	Không	Mã tỉnh hoặc miền (mặc định: `mien-bac`). Ví dụ: `mien-nam`, `tp-hcm`, `an-giang`.
`date`	string	Không	Ngày cần xem, định dạng `dd-mm-yyyy` (mặc định: ngày quay mới nhất).

Kết quả phản hồi mẫu (JSON 200 OK):

{
  "province": "mien-bac",
  "title": "KQXS Miền Bắc",
  "date": "20-07-2026",
  "dayOfWeek": "Thứ hai",
  "prizes": {
    "db": ["39128"],
    "g1": ["66850"],
    "g7": ["01", "44", "89", "63"]
  }
}

API Xổ Số Điện Toán & Vietlott

Kết quả Vietlott Mega 6/45, Power 6/55, Max 3D và Điện Toán Thủ Đô.

GET /api/v1/dientoan

Tham số Query:

Tham số	Loại	Bắt buộc	Mô tả
`game`	string	Không	Mã trò chơi (mặc định: `vietlott-mega645`). Ví dụ: `vietlott-power655`, `vietlott-max3d`, `dien-toan-chung`.

Kết quả phản hồi mẫu (JSON 200 OK):

{
  "date": "19-07-2026",
  "title": "Kết quả xổ số Mega 6/45",
  "balls": ["03", "12", "22", "34", "39", "45"]
}

API Tỷ Giá Ngoại Tệ Vietcombank

Dữ liệu tỷ giá hối đoái 21 đồng tiền tệ niêm yết chính thức bởi Ngân hàng Vietcombank thời gian thực.

GET /api/v1/exchange-rates

Tham số Query:

Tham số	Loại	Bắt buộc	Mô tả
`code`	string	Không	Mã ngoại tệ chuẩn ISO (Ví dụ: `USD`, `EUR`, `JPY`, `GBP`, `AUD`, `SGD`). Để trống lấy toàn bộ 21 ngoại tệ.
`date`	string	Không	Ngày tra cứu, định dạng `dd-mm-yyyy` (Mặc định: Tỷ giá hôm nay).

Ví Dụ Yêu Cầu cURL / Fetch:

curl -X GET "https://pha.vn/api/v1/exchange-rates?api_key=xs_public_demo_key_2026&code=USD"

Kết quả phản hồi mẫu (JSON 200 OK):

{
  "date": "21-07-2026",
  "totalItems": 21,
  "source": {
    "name": "Ngân hàng Thương mại Cổ phần Ngoại thương Việt Nam (Vietcombank)",
    "url": "https://www.vietcombank.com.vn/KHCN/Cong-cu-tien-ich/Ty-gia",
    "citation": "Tỷ giá hối đoái niêm yết chính thức bởi Vietcombank"
  },
  "rates": [
    {
      "currencyCode": "USD",
      "currencyName": "DO LA MY",
      "buyCash": "25,120.00",
      "buyTransfer": "25,150.00",
      "sell": "25,480.00"
    },
    {
      "currencyCode": "EUR",
      "currencyName": "EURO",
      "buyCash": "27,045.12",
      "buyTransfer": "27,318.30",
      "sell": "28,528.16"
    }
  ]
}

API Giá Xăng Dầu (Petrolimex & PVOIL)

Bảng giá bán lẻ nhiên liệu niêm yết theo Vùng 1 và Vùng 2 cập nhật thời gian thực từ Petrolimex & PVOIL.

GET /api/v1/fuel-prices

Tham số Query:

Tham số	Loại	Bắt buộc	Mô tả
`brand`	string	Không	Nhà cung cấp: `petrolimex` (Tập đoàn Xăng dầu Việt Nam) hoặc `pvoil` (Tổng công ty Dầu Việt Nam). Mặc định: lấy cả 2.

Ví Dụ Yêu Cầu cURL / Fetch:

curl -X GET "https://pha.vn/api/v1/fuel-prices?api_key=xs_public_demo_key_2026&brand=petrolimex"

Kết quả phản hồi mẫu (JSON 200 OK):

{
  "updatedDate": "21-07-2026",
  "source": {
    "name": "Tập đoàn Xăng dầu Việt Nam (Petrolimex) & PVOIL",
    "citation": "Giá bán lẻ xăng dầu niêm yết chính thức Vùng 1 & Vùng 2"
  },
  "data": [
    {
      "brand": "Petrolimex",
      "fuelName": "Xăng RON 95-V",
      "priceZone1": "21,990",
      "priceZone2": "22,420",
      "unit": "Đồng/Lít"
    },
    {
      "brand": "Petrolimex",
      "fuelName": "Xăng E5 RON 92-II",
      "priceZone1": "20,490",
      "priceZone2": "20,890",
      "unit": "Đồng/Lít"
    },
    {
      "brand": "Petrolimex",
      "fuelName": "Dầu DO 0.001S-V",
      "priceZone1": "19,890",
      "priceZone2": "20,280",
      "unit": "Đồng/Lít"
    }
  ]
}

API Giá Vàng Hôm Nay (SJC, PNJ, DOJI, BTMC, Thế Giới)

Bảng giá vàng miếng SJC, vàng nhẫn 9999, vàng nữ trang 24K/18K và giá vàng Kitco thế giới.

GET /api/v1/gold-prices

Tham số Query:

Tham số	Loại	Bắt buộc	Mô tả
`brand`	string	Không	Mã thương hiệu: `sjc`, `pnj`, `doji`, `btmc` (Bảo Tín Minh Châu), `world` (Thế giới). Để trống lấy toàn bộ.
`q`	string	Không	Từ khóa lọc tên loại vàng (Ví dụ: `nhẫn trơn`, `9999`, `vàng miếng`).

Ví Dụ Yêu Cầu cURL / Fetch:

curl -X GET "https://pha.vn/api/v1/gold-prices?api_key=xs_public_demo_key_2026&brand=sjc"

Kết quả phản hồi mẫu (JSON 200 OK):

{
  "updatedTime": "21-07-2026 15:30:00",
  "source": {
    "name": "Công ty Vàng Bạc Đá Quý Sài Gòn (SJC), PNJ, DOJI, BTMC",
    "citation": "Bảng giá vàng niêm yết thời gian thực"
  },
  "goldPrices": [
    {
      "brand": "SJC",
      "typeName": "Vàng miếng SJC 1L - 10L",
      "buyPrice": "78,500,000",
      "sellPrice": "80,500,000",
      "unit": "VND/Lượng"
    },
    {
      "brand": "PNJ",
      "typeName": "Vàng Nữ Trang 999.9 (24K)",
      "buyPrice": "75,200,000",
      "sellPrice": "76,100,000",
      "unit": "VND/Lượng"
    }
  ]
}

API Giá Nông Sản (Sầu Riêng, Cà Phê, Hồ Tiêu, Hạt Điều)

Dữ liệu giá thu mua nông sản theo vùng trồng và cơ quan quản lý nông nghiệp (Sở Công Thương Đắk Lắk & Bảng Giá Nông Sản).

GET /api/v1/nongsan

Tham số Query:

Tham số	Loại	Bắt buộc	Mô tả
`category`	string	Không	Mã danh mục: `sau-rieng`, `ca-phe`, `ho-tieu`, `hat-dieu`, `mat-ong`.
`source`	string	Không	Nguồn dữ liệu: `banggianongsan` hoặc `socongthuongdaklak`.
`q`	string	Không	Từ khóa tìm kiếm tên nông sản hoặc tỉnh/thành phố thu mua.

Ví Dụ Yêu Cầu cURL / Fetch:

curl -X GET "https://pha.vn/api/v1/nongsan?api_key=xs_public_demo_key_2026&category=sau-rieng"

Kết quả phản hồi mẫu (JSON 200 OK):

{
  "success": true,
  "total": 19,
  "page": 1,
  "limit": 20,
  "data": [
    {
      "id": "sau-rieng-ri6-a-dbscl-banggianongsan",
      "category": "sau-rieng",
      "categoryName": "Sầu Riêng",
      "itemName": "Ri6 loại A",
      "region": "Đồng bằng sông Cửu Long",
      "priceMin": 35000,
      "priceMax": 40000,
      "priceAvg": 37500,
      "unit": "đồng/kg",
      "change": "+1.000",
      "updatedDate": "2026-07-21",
      "source": {
        "id": "banggianongsan",
        "name": "Bảng Giá Nông Sản",
        "url": "https://banggianongsan.com/",
        "citation": "Dữ liệu được trích dẫn từ banggianongsan.com"
      }
    }
  ]
}

API Lãi Suất Tiết Kiệm Ngân Hàng

Bảng so sánh lãi suất gửi tiết kiệm tại quầy và online của 4 ngân hàng lớn (Vietcombank, Techcombank, MB, Laisuat.vn).

GET /api/v1/laisuat

Tham số Query:

Tham số	Loại	Bắt buộc	Mô tả
`source`	string	Không	Mã ngân hàng: `vietcombank`, `techcombank`, `mbbank`, `laisuatvn`.
`term`	string	Không	Kỳ hạn: `1m`, `3m`, `6m`, `12m`, `24m`.

Ví Dụ Yêu Cầu cURL / Fetch:

curl -X GET "https://pha.vn/api/v1/laisuat?api_key=xs_public_demo_key_2026&source=vietcombank"

Kết quả phản hồi mẫu (JSON 200 OK):

{
  "success": true,
  "totalBanks": 4,
  "updatedDate": "2026-07-21",
  "banks": [
    {
      "bankCode": "VCB",
      "bankName": "Vietcombank",
      "rates": {
        "1m": "1.6%",
        "3m": "1.9%",
        "6m": "2.9%",
        "12m": "4.6%",
        "24m": "4.7%"
      },
      "source": {
        "name": "Ngân hàng Thương mại Cổ phần Ngoại thương Việt Nam (Vietcombank)",
        "url": "https://www.vietcombank.com.vn/KHCN/Cong-cu-tien-ich/Lai-suat"
      }
    }
  ]
}

API Lãi Suất Vay Ngân Hàng

Dữ liệu gói vay mua nhà, mua xe, sản xuất kinh doanh và vay tiêu dùng của các ngân hàng thương mại.

GET /api/v1/laisuatvay

Tham số Query:

Tham số	Loại	Bắt buộc	Mô tả
`source`	string	Không	Mã nguồn: `vietcombank`, `techcombank`, `mbbank`, `tphcm_lgsp`.
`loanType`	string	Không	Gói vay: `mua-nha`, `mua-xe`, `kinh-doanh`, `tieu-dung`.

Ví Dụ Yêu Cầu cURL / Fetch:

curl -X GET "https://pha.vn/api/v1/laisuatvay?api_key=xs_public_demo_key_2026&source=vietcombank"

Kết quả phản hồi mẫu (JSON 200 OK):

{
  "success": true,
  "updatedDate": "2026-07-21",
  "loanRates": [
    {
      "bankCode": "VCB",
      "bankName": "Vietcombank",
      "loanType": "Vay Mua Nhà Bất Động Sản",
      "preferentialRate": "6.0%/năm",
      "preferentialTerm": "Ưu đãi 12 tháng đầu",
      "floatingRate": "Lãi suất cơ sở + 3.5%",
      "maxTerm": "25 năm",
      "source": {
        "name": "Vietcombank & Cổng Dịch vụ công TP.HCM (LGSP)",
        "citation": "Bảng lãi suất cho vay niêm yết tham khảo"
      }
    }
  ]
}

API Tra Cứu Mã Số Thuế Doanh Nghiệp & Chi Nhánh

Tra cứu thông tin hồ sơ thuế doanh nghiệp, đại diện pháp luật, địa chỉ đăng ký và ngày thành lập thời gian thực.

GET /api/v1/tax

Tham số Query:

Tham số	Loại	Bắt buộc	Mô tả
`mst`	string	Có	Mã số thuế doanh nghiệp 10 số (Ví dụ: `0109220490`) hoặc mã số thuế chi nhánh 13 số (Ví dụ: `0315588681-001`).

Ví Dụ Yêu Cầu cURL / Fetch:

curl -X GET "https://pha.vn/api/v1/tax?api_key=xs_public_demo_key_2026&mst=0109220490"

Kết quả phản hồi mẫu (JSON 200 OK kèm Trích dẫn Đa nguồn):

{
  "success": true,
  "data": {
    "mst": "0109220490",
    "companyName": "CÔNG TY TNHH CÔNG NGHỆ VÀ TRUYỀN THÔNG APIHUB",
    "internationalName": "APIHUB MEDIA AND TECHNOLOGY COMPANY LIMITED",
    "shortName": "APIHUB CO., LTD",
    "address": "Số 10 Phố Lý Thường Kiệt, Phường Phan Chu Trinh, Quận Hoàn Kiếm, Hà Nội",
    "representative": "NGUYỄN VĂN A",
    "status": "Đang hoạt động (đã được cấp GCN ĐKT)",
    "foundingDate": "15-06-2020",
    "managedBy": "Chi cục Thuế Quận Hoàn Kiếm",
    "sources": [
      {
        "name": "Mã Số Thuế Doanh Nghiệp (masothue.com)",
        "url": "https://masothue.com/0109220490"
      },
      {
        "name": "Hồ Sơ Công Ty Việt Nam (hosocongty.vn)",
        "url": "https://hosocongty.vn/0109220490"
      }
    ]
  }
}

API Tra Cứu Khung Giá Đất Nhà Nước (Hà Nội & Các Tỉnh)

Bảng giá đất chính thức ban hành bởi UBND TP. Hà Nội. Tra cứu giá đất Vị trí 1, Vị trí 2, Vị trí 3, Vị trí 4 theo tuyến đường và quận/huyện.

GET /api/v1/giadat/search

Tham số Query:

Tham số	Loại	Bắt buộc	Mô tả
`q` / `street`	string	Không	Từ khóa tên đường, phố hoặc đoạn đường (Ví dụ: `Bà Triệu`, `Nguyễn Trãi`, `Cầu Giấy`).
`district`	string	Không	Tên Quận/Huyện hoặc Khu vực (Ví dụ: `Ba Đình`, `Hoàn Kiếm`, `Cầu Giấy`).
`type`	string	Không	Loại đất: `Đất ở`, `Đất thương mại`, `Đất sản xuất`.
`sort`	string	Không	Sắp xếp: `price_desc` (Giá Vị trí 1 giảm dần), `price_asc`, `street_asc`.
`page` / `limit`	number	Không	Phân trang kết quả (Mặc định: page=1, limit=20).

Ví Dụ Yêu Cầu cURL / Fetch:

curl -X GET "https://pha.vn/api/v1/giadat/search?api_key=xs_public_demo_key_2026&q=B%C3%A0%20Tri%E1%BB%87u"

Kết quả phản hồi mẫu (JSON 200 OK):

{
  "success": true,
  "total": 5,
  "page": 1,
  "limit": 20,
  "totalPages": 1,
  "data": [
    {
      "id": "hanoi_1_1",
      "province": "Hà Nội",
      "district": "Khu Vực 1",
      "street": "Bà Triệu",
      "segment": "Hàng Khay → Trần Hưng Đạo",
      "landType": "Đất ở",
      "landCategory": "Nhóm đất phi nông nghiệp",
      "prices": {
        "vt1": "702.194.000",
        "vt2": "316.389.000",
        "vt3": "229.626.000",
        "vt4": "196.388.000",
        "vt1Num": 702194000,
        "vt2Num": 316389000,
        "vt3Num": 229626000,
        "vt4Num": 196388000
      }
    }
  ]
}

API Playground (Thử Nghiệm Trực Tiếp)

Chạy thử nghiệm API trực tiếp trên trình duyệt, xem dữ liệu phản hồi thực tế từ database.

Yêu Cầu (Request Settings)

API Key (Khóa thử nghiệm)

Endpoint API

Phản Hồi (Response Data) 200 OK

{
  "status": "ready",
  "message": "Bấm nút 'Gửi Yêu Cầu' để thực thi API..."
}