农历/节气/节日查询

基本信息

接口调用前需要确认的核心配置。

接口地址/api/lunar

请求方式GET,POST

返回格式JSON

调用权限需登录

ApiKey需要

创建时间2026-05-19

脚本路由lunar

📊 当前您的权限信息

会员等级

免费用户

调用频率限制

100 次/分钟

可访问API类型

仅免费API

💡 注册成为普通会员可免审核即时获得 Key，调用频率提升至 180 次/分钟。升级VIP 可解锁全部API，调用频率提升至 300 次/分钟。

请求参数说明

必填参数必须传入，示例值可直接用于联调。

参数名	必填	类型	说明	示例值
`key`	是	string	需要审核通过的 ApiKey。请注册账号获取API Key。	`YOUR_API_KEY`
`date`	否	string	公历日期，格式 Y-m-d，默认今天	`2026-05-19`
`scope`	否	string	查询范围：all / lunar / solar_term / holiday	`all`
`year`	否	number	年（date未传时生效）	`2026`
`month`	否	number	月（date未传时生效）	`5`
`day`	否	number	日（date未传时生效）	`19`

示例代码

优先使用示例地址测试请求参数是否正确。

示例请求 https://api.ruseo.cn/api/lunar?key=YOUR_API_KEY&date=2026-05-19&scope=all&year=2026&month=5&day=19

cURL

curl "https://api.ruseo.cn/api/lunar?key=YOUR_API_KEY&date=2026-05-19&scope=all&year=2026&month=5&day=19"

PHP

$url = 'https://api.ruseo.cn/api/lunar?key=YOUR_API_KEY&date=2026-05-19&scope=all&year=2026&month=5&day=19';
$response = file_get_contents($url);
$data = json_decode($response, true);

JavaScript

fetch('https://api.ruseo.cn/api/lunar?key=YOUR_API_KEY&date=2026-05-19&scope=all&year=2026&month=5&day=19')
  .then(res => res.json())
  .then(data => console.log(data));

返回说明

实际返回内容以接口脚本处理结果为准。

返回示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "route": "lunar",
        "example": true
    }
}

返回参数说明

参数名	类型	说明
`date`	string	查询的公历日期，格式 Y-m-d
`weekday`	string	星期几（如：星期二）
`weekday_cn`	string	星期简称（如：二）
`lunar.year`	number	农历年份
`lunar.month`	number	农历月份（1-12）
`lunar.day`	number	农历日期（1-30）
`lunar.is_leap`	boolean	是否闰月
`lunar.formatted`	string	农历格式化字符串（如：二〇二五年四月廿一）
`lunar.full_string`	string	农历完整字符串（包含干支、生肖、节气等）
`lunar.year_ganzhi`	string	年干支（如：乙巳）
`lunar.month_ganzhi`	string	月干支（如：辛巳）
`lunar.day_ganzhi`	string	日干支（如：丁卯）
`lunar.year_shengxiao`	string	年生肖（如：蛇）
`lunar.month_shengxiao`	string	月生肖
`lunar.day_shengxiao`	string	日生肖
`zodiac`	string	年份生肖
`solar_term.current`	string	当前节气（如：立夏），如果不是节气日则为 null
`solar_term.prev`	string	上一个节气名称
`solar_term.prev_date`	string	上一个节气日期
`solar_term.next`	string	下一个节气名称
`solar_term.next_date`	string	下一个节气日期
`solar_term.all_terms`	array	全年24节气列表（包含名称和日期）
`holiday.today`	array	今日节日列表（包含农历节日、公历节日、法定节假日）
`holiday.upcoming`	null	即将临近的节日（预留字段）
`almanac.yi`	array	今日宜做的事项列表
`almanac.ji`	array	今日忌做的事项列表
`almanac.xiongsha`	string	凶煞信息
`almanac.pengzu`	string	彭祖百忌
`almanac.wuxing`	string	纳音五行
`almanac.xi_shen`	string	喜神方位
`almanac.fu_shen`	string	福神方位
`almanac.cai_shen`	string	财神方位
`source`	string	数据来源：6tail/lunar-php（库已安装）或 fallback（本地计算）

调试参数

请求方式接口地址 key * date scope year month day

响应结果

◔ --

点击左侧“发送请求”查看结果...