API简介：查询公历对应的农历日期、二十四节气、法定节假日，支持1900-2100年

接口问题联系相关负责人沟通修复：查看该接口开发者

接口地址：https://api.ruseo.cn/api/lunar

返回格式：JSON

请求方式：GET

请求参数：https://api.ruseo.cn/api/lunar?date=2026-05-19&scope=all&year=2026&month=5&day=19

注：单纯检测接口是否可调通，返回的数据请自行检查

检测接口中...（检测服务是否可用）


状态码 累计次数 最后检测时间
正常 0
故障 1 2026-06-08 15:48:59

您好！我们的平台聚合了上千位开发者提供的免费接口，我们已尽力确保接口的稳定性，但由于无法控制其他开发者的接口，可能会出现不稳定或服务中断的情况。对此，我们深感抱歉！我们正在积极改善这一问题，感谢您的理解与支持。
1. 由于开发者可能因盈利问题导致接口失效，我为此向您道歉。
2. 我们竭尽全力改进平台的接口稳定性。
3. 为便于您使用，我们提供了智能生成对接代码和在线极速测试接口的功能。
4. 我们将继续努力提供更多可靠的接口，满足您的需求。
5. 若有任何问题，欢迎通过微信与我联系：13132131321。再次感谢您的支持与信任！

接口注意：接口故障请及时反馈，修复进度将通过短信通知。

非官方接口，请联系开发者获取技术支持

新 Bug修复：非官方接口，Bug反馈请联系开发者

新 会员线路：因调用量剧增，定制独享优质线路请 参考定制方案

专属线路 成本透明 0服务费

请求参数

接口名称 是否必填 接口类型 接口说明
date 否 string 公历日期，格式 Y-m-d，默认今天
scope 否 string 查询范围：all / lunar / solar_term / holiday
year 否 number 年（date未传时生效）
month 否 number 月（date未传时生效）
day 否 number 日（date未传时生效）

返回示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "date": "",
        "weekday": "",
        "weekday_cn": "",
        "lunar.year": 0,
        "lunar.month": 0,
        "lunar.day": 0,
        "lunar.is_leap": true,
        "lunar.formatted": "",
        "lunar.full_string": "",
        "lunar.year_ganzhi": "",
        "lunar.month_ganzhi": "",
        "lunar.day_ganzhi": "",
        "lunar.year_shengxiao": "",
        "lunar.month_shengxiao": "",
        "lunar.day_shengxiao": "",
        "zodiac": "",
        "solar_term.current": "",
        "solar_term.prev": "",
        "solar_term.prev_date": "",
        "solar_term.next": "",
        "solar_term.next_date": "",
        "solar_term.all_terms": [],
        "holiday.today": [],
        "holiday.upcoming": "",
        "almanac.yi": [],
        "almanac.ji": [],
        "almanac.xiongsha": "",
        "almanac.pengzu": "",
        "almanac.wuxing": "",
        "almanac.xi_shen": "",
        "almanac.fu_shen": "",
        "almanac.cai_shen": "",
        "source": ""
    }
}

返回参数

接口名称 接口类型 接口说明
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 string 全年24节气列表（包含名称和日期）
holiday.today string 今日节日列表（包含农历节日、公历节日、法定节假日）
holiday.upcoming string 即将临近的节日（预留字段）
almanac.yi string 今日宜做的事项列表
almanac.ji string 今日忌做的事项列表
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（本地计算） 

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

小白教程

本教程帮助用户快速对接农历/节气/节日查询接口，现已支持智能生成代码

为照顾小白，特意编写此对接文档教程，若有不懂请及时联系接口维护者。
农历/节气/节日查询
小白快速对接「农历/节气/节日查询」简易教程

实时调试

部分视频、图片或其他接口报错、空值并不代表无法对接，请在本地尝试请求参数接口

在线调试

温馨提示：请修改请求参数，未修改可能返回报错；

参数名称 参数值（修改后测试） 
{
    "code": 0,
    "msg": "success",
    "data": {
        "date": "",
        "weekday": "",
        "weekday_cn": "",
        "lunar.year": 0,
        "lunar.month": 0,
        "lunar.day": 0,
        "lunar.is_leap": true,
        "lunar.formatted": "",
        "lunar.full_string": "",
        "lunar.year_ganzhi": "",
        "lunar.month_ganzhi": "",
        "lunar.day_ganzhi": "",
        "lunar.year_shengxiao": "",
        "lunar.month_shengxiao": "",
        "lunar.day_shengxiao": "",
        "zodiac": "",
        "solar_term.current": "",
        "solar_term.prev": "",
        "solar_term.prev_date": "",
        "solar_term.next": "",
        "solar_term.next_date": "",
        "solar_term.all_terms": [],
        "holiday.today": [],
        "holiday.upcoming": "",
        "almanac.yi": [],
        "almanac.ji": [],
        "almanac.xiongsha": "",
        "almanac.pengzu": "",
        "almanac.wuxing": "",
        "almanac.xi_shen": "",
        "almanac.fu_shen": "",
        "almanac.cai_shen": "",
        "source": ""
    }
}