农历查询

免费 GETPOST 生活服务 生活工具

查询指定日期的农历信息（农历日期、天干地支、生肖、传统节日）

GET https://api.tinyaii.cn/v1/lunar

请求参数

参数名类型必填说明示例
datestring可选公历日期（YYYY-MM-DD，不传则查今天）2026-05-03

返回字段

字段类型说明
codeint状态码
solarstring公历日期
lunar.monthstring农历月份
lunar.daystring农历日期
lunar.year_gan_zhistring天干地支年
lunar.animalstring生肖
lunar.festivalstring传统节日（如有）

返回示例

{
  "code": 200,
  "data": {
    "solar": "2026-05-03",
    "lunar": {
      "month": "三月",
      "day": "十六",
      "year_gan_zhi": "丙午年",
      "animal": "马"
    }
  }
}

调用示例

curl "https://api.tinyaii.cn/v1/lunar?date=2026-05-03" \
  -H "Authorization: Bearer YOUR_API_KEY"
const res = await fetch("https://api.tinyaii.cn/v1/lunar?date=2026-05-03", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" },
});
console.log(await res.json());
import requests

resp = requests.get(
    "https://api.tinyaii.cn/v1/lunar",
    params={"date": "2026-05-03"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=10,
)
print(resp.json())

把 YOUR_API_KEY 换成你的密钥即可直接运行。密钥只保存在你自己的设备上。