生肖运势

按十二生肖单字拉取并解析运势页面，返回 JSON。支持今日 / 明日 / 周 / 月 / 年及可选指定日期。

接口文档

运行状态

运行中

接口类型

免费接口

接口地址

https://api.xzbok.cn/api/zodiac

返回格式

JSON

请求方式

GET

请求示例

https://api.xzbok.cn/api/zodiac?zodiac=鼠 调用测试

返回示例

{
    "code": 200,
    "msg": "鼠今日运势获取成功",
    "data": {
        "zodiac": "鼠",
        "years": "1960,1972,1984,1996,2008,2020",
        "date": "2026-03-27 12:00:00",
        "fortune": {
            "综合分数": "65",
            "综合运势": "60%",
            "事业学业": "100%",
            "爱情运势": "80%",
            "健康指数": "60%",
            "财富运势": "20%",
            "贵人生肖": "龙",
            "幸运颜色": "橘黄",
            "幸运数字": "33",
            "桃花方位": "正东",
            "喜神方位": "西南",
            "财神方位": "正北",
            "宜": "……",
            "忌": "……",
            "综合运势详情": "……",
            "事业运势详情": "……",
            "爱情运势详情": "……",
            "健康运势详情": "……",
            "财运运势详情": "……"
        }
    }
}

错误码参照

系统级错误

状态码	类型	说明
`400`	参数错误	缺少必要参数或参数格式不正确
`401`	未授权	密钥无效或未登录（需登录接口）
`403`	禁止访问	无调用权限或已被封禁
`404`	接口不存在	请求的接口地址有误
`429`	频率限制	请求过于频繁，请稍后重试
`500`	服务器错误	服务异常，请联系管理员

示例代码

代码示例

GET https://api.xzbok.cn/api/zodiac?zodiac=鼠
GET https://api.xzbok.cn/api/zodiac?zodiac=虎&type=week
GET https://api.xzbok.cn/api/zodiac?zodiac=龙&date=2026-03-15

调用代码

PHP

$url = "https://api.xzbok.cn/api/zodiac";
$ch  = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$resp = curl_exec($ch);
curl_close($ch);

echo $resp;

在线调试

请求地址

请求方式

请求参数

返回结果