桑帛云API

黄历

GET 无需 Key 运行中

接口简介

黄历API,支持查询1901年至今的公历/农历对应数据,涵盖宜忌事项、冲煞信息、吉神凶煞、财神方位、吉时、生肖星座、节气节日等全维度黄历内容,数据精准、响应迅速,适配日程规划、吉日择选、传统文化类应用开发等场景。

接口地址

https://api.lolimi.cn/API/huang/api

请求示例

测试访问
https://api.lolimi.cn/API/huang/api?type=json

返回预览

JSON
{
    "code": 1,
    "text": "二〇二五年十月廿六\n乙巳(蛇)年 戊子(鼠)月 戊午(马)日 \n纳音[覆灯火 霹雳火 天上火 沙中土]\n星期一 东方青龙\n星宿[心月狐](凶)\n彭祖百忌[戊不受田田主不祥 午不苫盖屋主更张]\n喜神方位[巽](东南)\n阳贵神方位[艮](东北)\n阴贵神方位[坤](西南)\n福神方位[艮](东北)\n财神方位[坎](正北)\n冲[(壬子)鼠]\n煞[北]",
    "data": {
        "time": {
            "cn": {
                "year": "二〇二五",
                "month": "十",
                "day": "廿六"
            },
            "data": {
                "year": "2025",
                "month": "12",
                "day": "15"
            }
        },
        "data": {
            "traditional_Chinese_calendar": {
                "year": "乙巳(蛇)",
                "month": "戊子(鼠)",
                "day": "戊午(马)"
            },
            "Nayin": {
                "year": "覆灯火",
                "month": "霹雳火",
                "day": "天上火"
            },
            "Constellation": "心月狐(凶)",
            "Taboo": "戊不受田田主不祥 午不苫盖屋主更张",
            "You_ge_Cheng": "巽(东南)",
            "Yang": "艮(东北)",
            "Yin": "坤(西南)",
            "Fu_of_Wealth": "艮(东北)",
            "God_of_Wealth": "坎(正北)",
            "Rush": "(壬子)鼠",
            "Fierce": "北"
        }
    }
}

请求参数

参数名类型必填描述
typestringRequired可填写json/text默认为json

返回参数

参数名类型描述
codeint接口响应状态码,1表示获取成功
textstring接口响应状态描述,成功时返回“获取成功”
dataobject黄历核心数据集合
data.gonglistring公历日期,如“二〇二五年十月廿六”
data.nonglistring农历干支纪年,如“乙巳(蛇)年 戊子(鼠)月 戊午(马)日”
data.nayinarray纳音五行,如[覆灯火 霹雳火 天上火 沙中土]
data.weekstring星期几,如“星期一”
data.longmenstring方位神兽,如“东方青龙”
data.xingxiustring当日星宿及吉凶,如“心月狐(凶)”
data.pengzustring彭祖百忌内容,如“戊不受田田主不祥 午不苫盖屋主更张”
data.xishen_fangweistring喜神方位,如“巽(东南)”
data.yangguishen_fangweistring阳贵神方位,如“艮(东北)”
data.yinguishen_fangweistring阴贵神方位,如“坤(西南)”
data.fushen_fangweistring福神方位,如“艮(东北)”
data.caishen_fangweistring财神方位,如“坎(正北)”
data.chongstring当日相冲生肖,如“(壬子)鼠”
data.shastring当日煞方,如“北”

参数配置

登录获取 Key
<?php
$url = "https://api.lolimi.cn/API/huang/api";
$params = array (
  'type' => 'value',
);
$url .= '?' . http_build_query($params);
$res = file_get_contents($url);
echo $res;
概览
文档
调试
代码
已复制到剪贴板