覆盖十二星座的每日、每周、每月及年度运势查询，返回综合运势、爱情、事业、财运、健康评分及幸运数字、幸运色等指标。数据每日凌晨更新，适用于星座应用、社交平台、内容运营与个性化推荐等场景。
星座运势 API 通过标准 HTTP GET 请求返回结构化 JSON 数据，支持按星座名称和时间维度查询运势详情。返回字段涵盖综合运势、爱情运、事业运、财运、健康运评分，以及幸运数字、幸运颜色和运势概要文字。数据由专业星座分析团队产出，每日凌晨自动更新。接口全程 HTTPS 加密传输，支持高并发调用，可稳定用于生产环境。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| apikey | string | 是 | 用户身份密钥，在控制台「应用管理」中创建应用后获取。 |
| star | string | 是 | 星座名称，如「白羊座」「天蝎座」，须使用中文全称。 |
| type | string | 否 | 查询维度：today=今日（默认）、week=本周、month=本月、year=本年。 |
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码，200 表示请求成功，其余见错误码对照表。 |
| msg | string | 状态描述信息。 |
| data.star | string | 查询的星座名称。 |
| data.date | string | 运势对应日期，格式 yyyy-MM-dd。 |
| data.overall | int | 综合运势评分，0-100。 |
| data.love | int | 爱情运势评分，0-100。 |
| data.career | int | 事业运势评分，0-100。 |
| data.wealth | int | 财运评分，0-100。 |
| data.health | int | 健康运势评分，0-100。 |
| data.lucky_number | int | 今日幸运数字。 |
| data.lucky_color | string | 今日幸运颜色。 |
| data.summary | string | 运势概要文字描述。 |
{
"code": 200,
"msg": "success",
"data": {
"star": "白羊座",
"date": "2026-07-25",
"overall": 85,
"love": 90,
"career": 78,
"wealth": 82,
"health": 88,
"lucky_number": 7,
"lucky_color": "薄荷绿",
"summary": "今日整体运势不错，感情方面桃花旺盛，适合主动出击。事业上保持稳扎稳打的节奏，财运方面有意外收获的可能，健康状况良好，注意防晒补水。"
}
}