Try Astrologer API

Subscribe to support and grow the project.

v5 Astrologer API Documentation
Get API Key

Data Endpoints

Subject Data

Generate an astrological subject from raw birth data. Perform high-precision ephemeris calculations for planets, houses, and axes in machine-readable JSON.

Now Subject

Get real-time astrological data for the current moment. Automatic UTC calculation of planetary positions for "Astrological Weather" and live features.

Compatibility Score

Calculate numerical relationship compatibility scores using the Ciro Discepolo method. Includes qualitative descriptions and "Destiny Signs" analysis.

Natal Chart Data

Access complete natal chart calculations in JSON. High-precision positions for planets, house cusps, and astrological points based on birth data.

Synastry Chart Data

Access comprehensive synastry data in JSON. High-precision inter-aspect calculations between two subjects for deep relationship compatibility analysis.

Composite Chart Data

Retrieve raw composite chart data in JSON format. Calculate midpoints between two subjects to analyze the unique purpose and destiny of a union.

Transit Chart Data

Get machine-readable transit data. Compare current planetary positions against a natal chart to identify active life themes and predictive trends.

Solar Return Chart Data

Retrieve raw Solar Return data. Precise calculations for the astrological birthday to forecast themes and events for the year ahead.

Lunar Return Chart Data

Retrieve raw Lunar Return data in JSON. High-precision calculations for the Moon's monthly return to its natal position for emotional forecasting.

Moon Phase

Get detailed lunar phase data for any date, time, and location. Includes illumination, upcoming phases, eclipses, sunrise/sunset, and zodiac signs.

Moon Phase Now (UTC)

Get the current moon phase at Greenwich Observatory in real time. Instant lunar data with no required parameters for "Moon right now" features.

Build With Astrology Data

Natal charts, synastry, transits & AI interpretations — all via REST API.

Try Astrologer API