☰

Dành cho developer

API lịch âm miễn phí cho website và ứng dụng

Lấy dữ liệu ngày âm, can chi, ngày tốt xấu, giờ hoàng đạo và đếm ngày đến Tết bằng JSON. Có thể dùng để nhúng lịch âm vào blog, app nội bộ, landing page hoặc widget cá nhân.

JSONiCal .icsCORS mởKhông cần API key

Endpoint

Cách gọi API

GET https://ngaygio.vn/api/lich-am
GET https://ngaygio.vn/api/lich-am?date=2026-07-03
GET https://ngaygio.vn/api/lich-am?date=2026-07-03&format=json
GET https://ngaygio.vn/api/lich-am?date=2026-07-03&format=ics

Tham số date dùng định dạng YYYY-MM-DD. Nếu không truyền date, API tự lấy ngày hiện tại theo Việt Nam.

Dữ liệu trả về

Các trường chính trong response

TrườngÝ nghĩaVí dụ sử dụng
lunarNgày, tháng, năm âm lịch và thông tin tháng nhuận.Hiển thị âm lịch hôm nay.
canChiCan chi ngày, tháng, năm.Tra ngày Bính Tý, tháng Mậu Ngọ...
qualityNhãn ngày tốt/xấu và ghi chú.Làm thẻ “ngày hoàng đạo/hắc đạo”.
goodHoursDanh sách giờ hoàng đạo trong ngày.Gợi ý giờ xuất hành, mở hàng.
tetDaysLeftSố ngày còn lại đến Tết âm lịch gần nhất.Widget đếm ngược Tết.

Ví dụ code

JavaScript và cURL

JavaScript

fetch('https://ngaygio.vn/api/lich-am?date=2026-07-03')
  .then((res) => res.json())
  .then((data) => {
    console.log(data.lunar.day + '/' + data.lunar.month + ' âm lịch');
    console.log('Giờ tốt:', data.goodHoursText);
  });

cURL

curl 'https://ngaygio.vn/api/lich-am?date=2026-07-03&format=json'

Response mẫu

{
  "date": "2026-07-03",
  "solarDate": "03/07/2026",
  "weekday": "Thứ Sáu",
  "lunar": { "day": 19, "month": 5, "year": 2026, "isLeap": false },
  "canChi": { "day": "...", "month": "...", "year": "Bính Ngọ" },
  "quality": { "label": "Ngày Hoàng Đạo", "note": "..." },
  "goodHoursText": "Tý 23:00-01:00, Sửu 01:00-03:00...",
  "tetDaysLeft": 200,
  "source": "https://ngaygio.vn"
}

Liên kết liên quan

Widget lịch âmPreview widget âm lịchTải lịch âm PDFXem JSON hôm nayTải iCal hôm nay

Khi nào nên dùng API lịch âm?

API phù hợp khi anh muốn nhúng lịch âm vào website riêng, tạo widget nội bộ, hiển thị giờ hoàng đạo trong app hoặc làm thẻ đếm ngược Tết. Với website tĩnh, cách đơn giản nhất là gọi JSON bằng JavaScript phía trình duyệt.

Lưu ý sử dụng

Dữ liệu lịch âm, ngày tốt xấu và giờ hoàng đạo trên Ngaygio.vn mang tính tham khảo văn hóa dân gian. Khi hiển thị lại dữ liệu, nên ghi nguồn Ngaygio.vn và không dùng kết quả thay cho tư vấn chuyên môn trong các việc pháp lý, tài chính, y tế hoặc xây dựng.

API lịch âm miễn phí – JSON, giờ hoàng đạo, ngày tốt xấu | Ngày Giờ