中国老黄历API接口 - 天聚数行TianAPI

中国老黄历正常服务支持MCP

万年历老黄历查询，支持宜忌、冲煞、吉时、胎神等传统民俗信息。

会员免费・升级会员畅享160+免费接口，立即升级>>

普通会员100次/天

高级会员1W次/天

黄金会员50W次/天

钻石会员不限次数

申请接口在线测试

根据公历查询date参数可传递时间戳、公历日期。基础版支持根据农历查询（请传农历日期如2019-1-14）（日期不得有前导零）并指定type参数为1，查询范围（1970-2038年）。新增加的全量版不支持按农历查询，但支持的查询范围更广（1900-2100年），拓展字段更多。两个接入点返回数据有差异，可按需选择。

接入点列表：

基础版老黄历
全量版老黄历

开发集成：

API Lab

MCP服务

OpenAPI文档

相关资源：

▼ 接口信息

支持更大范围的老黄历查询且字段更齐全

接口地址：https://apis.tianapi.com/lunar/calendar?key={apiKey}
支持协议：http/https
请求方法：get/post
返回格式：utf-8 json

▼ 请求参数

上传文件时请使用标准表单格式 multipart/form-data

普通参数请使用默认表单格式 application/x-www-form-urlencoded

当参数值（如url、base64）包含特殊字符时，建议urlencode编码后传递

名称	类型	必须	示例值/默认值	说明
key	string	是	您自己的ApiKey（注册账号后获得）	API密钥
date	string	否	2026-09-05	查询日期，为空默认公历当天

▼ 返回示例

接口数据示例仅作为预览参考，请以实际测试结果为准

旧接口域名返回的数据结构和现在略有不同，请查看说明

	
	成功调用，返回内容并产生计费：
	
	
	
	失败调用，查看接口错误码释义：

▼ 返回参数

公共参数指所有接口都会返回的参数，应用参数每个接口都不同

建议对返回的字段进行存在性与类型校验，可参考API安全接入指南

名称	类型	示例值	说明
公共参数
code	int	200	状态码
msg	string	success	错误信息
result	object	{}	返回结果集
应用参数
star	string	胃	二十八星宿
week	string	六	中文星期
avoid	string	出火入宅盖屋安门安葬	不宜
chong	string	(丙子)鼠	冲煞
day_gz	string	壬午	天干地支日
san_fu	string		三伏
zodiac	string	马	生肖
bad_god	string	灾煞天火白虎	当日凶煞列表
fu_shen	string	东南	福神方位
is_leap	int	0	是否闰月 0=否 1=是
liu_yao	string	赤口	六曜
peng_zu	string	壬不泱水更难提防午不苫盖屋主更张	彭祖百忌
shu_jiu	string		数九
sui_sha	string	北	岁煞方位
xi_shen	string	正南	喜神方位
year_gz	string	丙午	天干地支年
yin_gui	string	东南	阴贵方位
cai_shen	string	正南	财神方位
day_kong	string	申酉	日旬空
good_god	string	月德天德月恩四相天马	当日吉神列表
jian_chu	string	土	建除十二神
month_gz	string	丙申	天干地支月
suitable	string	嫁娶订盟纳采祭祀斋醮普渡解除出行	适宜
tai_shen	string	仓库碓外西北	胎神
yang_gui	string	正东	阳贵方位
day_nayin	string	杨柳木	五行日
lunar_day	int	24	农历日
year_kong	string	寅卯	年旬空
lunar_date	string	二〇二六年七月廿四	农历完整日期
lunar_year	int	2026	农历年
month_kong	string	辰巳	月旬空
solar_date	Date	2026-09-05	公历日期
solar_term	string		节气
year_nayin	string	天河水	五行年
hou_weather	string	禾乃登	物候
lunar_month	int	7	农历月
month_nayin	string	山下火	五行月

▼ 接口价格

本接口为会员免费类接口，可根据业务需求选择升级会员方案>>

不同会员方案仅每日调用量等配额上限不同，数据本身无区别

会员方案	免费接口数	每日调用量	QPS	价格
普通会员	10个	100次	3	免费
高级会员	不限	1万次	20	29元/月、~~348元/年~~169元/年惠
黄金会员	不限	50万次	30	89元/月、~~1068元/年~~529元/年惠
钻石会员	不限	不限次	60	~~3380元/年~~1699元/年惠

▼ 返回状态码

错误信息可能会有所调整，请根据业务状态码(code)进行流程判断

正常请求均返回HTTP200，当业务状态码为200时表示请求成功计费

错误状态码	错误信息	解释帮助
100	内部服务器错误	报此错误码请及时反馈或等待官方修复
110	当前API已下线	接口已下线无法使用，可关注相关通知
120	API暂时维护中	接口暂时关闭维护中，请注意相关公告
130	API调用频率超限	超过每秒请求数上限，可在控制台-接口管理中查询
140	接口或密钥无权限	请检查是否自行在接口管理中停用或被禁用了该接口
150	API可用次数不足	免费类接口套餐超限或计次类接口余额不足，点此查看说明
160	当前未申请该API	请先在接口文档页面申请该接口，点此查看说明
170	Referer请求来源受限	设置了Referer白名单，但来源Referer不在白名单内
180	IP请求来源受限	设置了IP白名单，但来源IP不在白名单内
190	API密钥不可用	账号无效或密钥被禁用
230	API密钥无效	请检查apikey是否填写错误，点此查看帮助
240	缺少API密钥参数	请检查是否传递了key参数或者编码格式是否符合要求
250	数据返回为空	数据查询或转换失败，请检查输入值或注意中文编码问题
260	参数值不得为空	请检查关键参数是否传递了空值
270	参数值不符合要求	参数值不符合基本格式要求，点此查看说明
280	缺少必要的参数	缺少必填的参数，请根据接口文档检查
290	超过最大输入限制	参数值超过输入范围，请查看接口文档的说明
业务状态码1开头的是服务端错误，2开头（除200表示成功外）其他的为客户端错误