Horoscope

A fast and reliable horoscope API written by a professional providing daily, weekly, monthly, and yearly insights for all zodiac signs.

原始信息汇总

Horoscope API 数据集详情

数据集概述

Horoscope API 是由 Tirta.in 提供的专业星座运势数据接口，覆盖全部12个星座，提供专业撰写的占星解读内容，支持通用、爱情、事业、健康、财富和年度运势六种类型，以及每日、每周、每月和年度等多种阅读模式。

核心功能

• 支持全部12个星座（白羊座至双鱼座）
• 提供21种类型与模式组合
• 包括通用、爱情、事业、健康、财富和年度运势内容
• 支持每日、每周、每月及专业年度阅读模式
• 返回简洁一致的 JSON 数据格式
• 可通过一次请求获取单条运势或某星座全部运势
• 支持指定日期查询（当前日期或历史日期）
• 响应包含完整的星座元数据（星座名称、日期范围、元素、模式、守护星、符号等）

数据集内容与结构

支持的星座（12个）

每个星座包含编号（1-12）、名称、日期范围、元素（火/土/风/水）、模式（基本/固定/变动）、守护星、符号和字形等信息。

支持的运势类型与模式（21种组合）

类型	支持模式
通用（general）	每日、每周、每月
爱情（love）	每日、每周、每月
事业（career）	每日、每周、每月
健康（wellness）	每日、每周、每月
财富（money）	每周
年度（yearly）	个人、情侣爱情、单身爱情、事业

接口端点

1. 星座参考数据

• GET /zodiacs — 返回全部12个星座及其元数据

2. 星座全部运势

• GET /horoscopes?zodiac={zodiac}&date={YYYY-MM-DD} — 一次获取某星座全部21种运势组合，响应包含元数据字段（可用数量、缺失组合列表）

3. 单条运势

• GET /horoscopes/{type}/{mode}?zodiac={zodiac}&date={YYYY-MM-DD} — 获取指定星座、类型和模式的单条运势，共17个具体端点

请求参数

参数	必填	格式	说明
zodiac	是	星座名称或数字	接受不区分大小写的星座名称（如 cancer）或数字 1-12
date	否	YYYY-MM-DD	指定日期，可为当前日期或更早日期，不允许未来日期

响应格式

• 成功的响应统一使用 {"success": true, "data": {}} 结构
• 每条运势记录包含：星座详情对象、类型、模式、生效日期（YYYY-MM-DD格式）、运势描述文本
• 错误响应包含错误代码和可共享给支持的请求ID

错误处理

常见错误包括：缺少星座参数、无效星座、无效类型/模式、无效日期格式、不允许的未来日期、未找到数据等，均通过明确的 HTTP 状态码和结构化错误消息返回。

适用场景

• 星座运势网站内容发布
• 移动应用中的星座/生活方式/健康功能
• 个性化用户仪表盘展示
• 情感关系类产品
• 职业规划与生产力应用
• 健康平台内容集成
• 聊天机器人与虚拟助手
• 内容与社交工具（星座卡片、通知、通讯稿等）

订阅方案

API 在 RapidAPI 平台提供多种订阅计划：BASIC（免费）、PRO（$7.00/月）、ULTRA（$15.00/月）、MEGA（$25.00/月），请求配额和速率限制取决于所选的订阅计划。

免责声明

运势内容仅供娱乐和一般信息参考，不应作为医疗、法律、财务、心理或其他专业建议。