Astrologer

High Precision Astrology API – Powered by Kerykeion, the Leading Library for Precise Birth, Synastry Charts, Transit Charts & Composite Charts with Instant SVG Generation & Compatibility Scores.

原始信息汇总

Astrologer API 数据集概述

基本信息

• 数据集名称: Astrologer
• 类别: Science / Astrology
• API类型: RESTful 服务
• 核心功能: 提供广泛的占星学计算，包括生成星盘图表和结构化数据。
• 技术基础: 基于 Kerykeion 库，提供 NASA 级天文精度。
• 主要用途: 适用于开发者及占星学爱好者，可集成至应用程序、兼容性/约会系统、仪表板和 SaaS 工具中。

性能与评级

• 流行度: 9.9
• 服务等级: 100%
• 延迟: 538ms
• 测试状态: N/A

订阅计划与定价

• BASIC: $0.00 / 月
• PRO: $8.00 / 月
• ULTRA: $15.00 / 月
• MEGA: $30.00 / 月

端点概览

图表端点（返回 SVG 图表 + 数据）

• POST /api/v5/chart/birth-chart: 本命星盘 SVG + 数据
• POST /api/v5/chart/synastry: 合盘星盘 SVG + 组合数据
• POST /api/v5/chart/transit: 行运星盘 SVG + 本命及行运数据
• POST /api/v5/chart/composite: 组合中点星盘 SVG + 中点数据
• POST /api/v5/chart/solar-return: 太阳返照星盘 SVG + 数据
• POST /api/v5/chart/lunar-return: 月亮返照星盘 SVG + 数据
• GET /api/v5/now/chart: 当前时刻星盘 SVG + 数据

数据端点（仅返回 JSON 数据，无 SVG）

• POST /api/v5/chart-data/birth-chart: 仅本命星盘数据
• POST /api/v5/chart-data/synastry: 仅合盘数据
• POST /api/v5/chart-data/transit: 仅行运数据
• POST /api/v5/chart-data/composite: 仅组合中点数据
• POST /api/v5/chart-data/solar-return: 仅太阳返照数据
• POST /api/v5/chart-data/lunar-return: 仅月亮返照数据
• POST /api/v5/subject: 仅标准化主体对象
• GET /api/v5/now/subject: 当前 UTC 主体数据
• POST /api/v5/compatibility-score: Ciro Discepolo 兼容性评分 + 摘要

上下文端点（AI/LLM 集成）

• POST /api/v5/context/subject: 带 AI 上下文的主体数据
• POST /api/v5/context/birth-chart: 带 AI 上下文的本命星盘数据
• POST /api/v5/context/synastry: 带 AI 上下文的合盘数据
• POST /api/v5/context/composite: 带 AI 上下文的组合中点数据
• POST /api/v5/context/transit: 带 AI 上下文的行运数据
• POST /api/v5/context/solar-return: 带 AI 上下文的太阳返照数据
• POST /api/v5/context/lunar-return: 带 AI 上下文的月亮返照数据
• POST /api/v5/now/context: 带 AI 上下文的当前时刻数据

核心特性与选项

• 输出格式: 生产就绪的 JSON 和 SVG 图表。
• 图表分割: 通过 "split_chart": true 参数，可分别获取星盘轮 (chart_wheel) 和相位网格 (chart_grid)。
• 透明背景: 通过 "transparent_background": true 参数实现。
• 主题: 支持 light, dark, dark-high-contrast, classic。
• 多语言支持: 支持 EN, FR, PT, ES, TR, RU, IT, CN, DE, HI。
• 自定义标题: 通过 "custom_title" 参数提供短标题（≤40 字符）。
• 星盘类型: 支持热带 ("Tropic") 与恒星 ("Sidereal") 黄道带，恒星制需指定 sidereal_mode。
• 宫位系统: 通过 subject.house_system 指定，支持多种系统代码（如 "P" 代表 Placidus）。
• 坐标自动查找: 通过提供 geonames_username，可自动查找城市坐标和时区。
• 计算选项: 包括 active_points, active_aspects, distribution_method ("weighted" 或 "pure_count"), custom_distribution_weights。
• 渲染选项: 包括 theme, language, split_chart, transparent_background, show_house_position_comparison, custom_title。

请求与响应示例

• 基本请求头: json { X-RapidAPI-Host: astrologer.p.rapidapi.com, X-RapidAPI-Key: YOUR_API_KEY, Content-Type: application/json }

• 本命星盘请求示例 (cURL): bash curl -X POST https://astrologer.p.rapidapi.com/api/v5/chart/birth-chart -H Content-Type: application/json -H X-RapidAPI-Host: astrologer.p.rapidapi.com -H X-RapidAPI-Key: YOUR_API_KEY -d { "subject": { "name": "John Doe", "year": 1980, "month": 12, "day": 12, "hour": 12, "minute": 12, "longitude": 0, "latitude": 51.4825766, "timezone": "Europe/London" }, "theme": "dark" }

• 典型响应结构: json { "status": "OK", "chart": "<svg>...</svg>", "chart_data": { /* aspects, houses, distributions, subjects */ } }

许可证与支持

• 许可证: Astrologer API 为开源（AGPLv3）。通过 RapidAPI 使用托管 API 允许在任何应用中使用，包括闭源项目。
• 支持与定制: 可通过 [e-mail] 联系，讨论超出默认层级的高配额或定制计划。
• 订阅链接: https://rapidapi.com/gbattaglia/api/astrologer/pricing

提供者信息

• API 创建者: Kerykeion Labs
• 订阅者数量: 2333