Astrologer
Astrologer is a RESTful astrology API providing extensive calculations, designed for seamless integration into any project. It offers a set of ready-to-use astrological charts and rich data, making it an invaluable tool for both developers and astrology enthusiasts.
Astrologer endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET |
Get Now /api/v3/now |
Returns the current astrological data in JSON format. |
| GET |
Get Now /api/v2/now |
Gets now at UTC. |
| GET |
Now: Astrological Data for current Date/Time /api/v4/now |
Returns the current astrological data in JSON format. |
| POST |
Birth Chart /api/v5/chart/birth-chart |
Generates a natal chart (birth chart) for a specific person and time. Returns both the calculated astrological data and a rendered SVG chart. You can customize the visual… |
| POST |
Birth Chart /api/v5/chart/birth-chart |
Generates a natal chart (birth chart) for a specific person and time. Returns both the calculated astrological data and a rendered SVG chart. You can customize the visual… |
| POST |
Moon Phase Details /api/v5/moon-phase |
Returns detailed moon phase information for a specific date/time and location. Includes phase name, illumination, waxing/waning stage, moon age, upcoming major phases, next lunar… |
| POST |
Birth Chart Data /api/v5/chart-data/birth-chart |
Returns complete natal chart data (planetary positions, aspects, distributions) without SVG rendering. Use this endpoint when you only need the raw astrological data for your own… |
| POST |
Birth Chart - AI Context /api/v5/context/birth-chart |
Returns a structured XML analysis of a natal chart, optimized for use with AI/LLMs. Includes planetary positions, aspects, and distributions in a format that is easy for language… |
| GET |
Now /api/v3/now |
Gets astrological data for the current moment at UTC. |
| POST |
Transit Chart /api/v5/chart/transit |
Generates a transit chart showing the current planetary positions in relation to a natal chart. Returns calculated transit data and a rendered dual-wheel SVG chart (inner wheel:… |
| POST |
Transit Chart - AI Context /api/v5/context/transit |
Returns a structured XML analysis of a transit chart (current planets vs natal chart), optimized for AI/LLMs. ### Parameters - `first_subject` (JSON object, required): The natal… |
| POST |
Current Moon Phase (UTC) /api/v5/moon-phase/now-utc |
Returns detailed moon phase information for the current UTC moment at Greenwich Observatory (51.4779°N, 0.0015°W). This is the moon phase equivalent of `/api/v5/now/subject`. All… |
| POST |
Transit Data /api/v5/chart-data/transit |
Returns transit analysis data, showing planetary positions for a specific time (transit) in relation to a natal chart. Does not include SVG rendering. ### Parameters -… |
| POST |
Birth Data /api/v3/birth-data |
Get the astrological birth data of a subject. |
| POST |
Composite Chart /api/v5/chart/composite |
Generates a midpoint composite chart for two subjects. This chart represents the relationship itself as a third entity, calculated by finding the midpoints between the planets of… |
| POST |
Birth Data /api/v2/birth-data |
Get the birthdata data of a subject. |
| POST |
Birth Chart /api/v4/birth-chart |
Returns a SVG Birth Chart with data and aspects. |
| POST |
Birth Data /api/v3/birth-data |
Get the birthdata data of a subject. |
| POST |
Composite Chart /api/v2/composite-chart |
Get the composite chart data of two subjects. |
| POST |
Synastry Chart /api/v5/chart/synastry |
Generates a synastry chart (relationship chart) comparing two subjects. Returns calculated compatibility data and a rendered dual-wheel SVG chart. This chart visualizes the… |
| POST |
Synastry Chart /api/v4/synastry-chart |
Generate a SVG Synastry Chart with data. |
| POST |
Synastry Chart - AI Context /api/v5/context/synastry |
Returns a structured XML analysis of a synastry chart (relationship), optimized for AI/LLMs. Includes inter-chart aspects and house overlays. ### Parameters - `first_subject`… |
| POST |
Birth Chart /api/v3/birth-chart |
Returns the birthchart of a subject in SVG format. Also includes the birthchart data and aspects in JSON. Parameters to be insterted in the body: * `name` - The name of the… |
| POST |
Synastry Chart /api/v5/chart/synastry |
Generates a synastry chart (relationship chart) comparing two subjects. Returns calculated compatibility data and a rendered dual-wheel SVG chart. This chart visualizes the… |
| POST |
Synastry Data /api/v5/chart-data/synastry |
Returns synastry comparison data between two subjects, including aspects between their planets, house overlays, and a relationship compatibility score. Does not include SVG… |
| POST |
Birth Chart /api/v3/birth-chart |
Returns the Birth Chart of a subject in SVG format. Also includes the Birth Chart data and aspects in JSON. Parameters to be inserted in the body: * `name` - The name of the… |
| POST |
Moon Phase - AI Context /api/v5/moon-phase/context |
Returns detailed moon phase information with an AI-optimized XML context string, suitable for LLM consumption. This is the context variant of `/api/v5/moon-phase`. This endpoint… |
| POST |
Current Moon Phase (UTC) - AI Context /api/v5/moon-phase/now-utc/context |
Returns detailed moon phase information for the current UTC moment at Greenwich Observatory (51.4779°N, 0.0015°W) with an AI-optimized XML context string. This is the context… |
| POST |
Now: Current Datetime Birth Chart /api/v5/now/chart |
Generates a chart for the current moment (Now) at Greenwich (UTC). Useful for getting the current planetary positions and a chart for "right now". Returns calculated data and a… |
| POST |
Birth Chart /api/v2/birth-chart |
Returns the birthchart of a subject in SVG format. Also includes the birthchart data and aspects in JSON. Parameters to be insterted in the body: * `name` - The name of the… |
| POST |
Transit Chart /api/v4/transit-chart |
Retrieve a transit chart for a specific subject. Includes the data for the subject and the aspects. |
| POST |
Composite Data /api/v5/chart-data/composite |
Returns midpoint composite chart data for two subjects. Does not include SVG rendering. ### Parameters - `first_subject` (JSON object, required): The first subject's birth data.… |
| POST |
Composite Chart /api/v3/composite-chart |
Get the composite chart data of two subjects. |
| POST |
Composite Chart - AI Context /api/v5/context/composite |
Returns a structured XML analysis of a composite chart (midpoint chart), optimized for AI/LLMs. ### Parameters - `first_subject` (JSON object, required): The first subject's… |
| POST |
Composite Chart /api/v5/chart/composite |
Generates a midpoint composite chart for two subjects. This chart represents the relationship itself as a third entity, calculated by finding the midpoints between the planets of… |
| POST |
Composite Chart /api/v4/composite-chart |
Retrieve a composite chart between two subjects. Includes the data for the subjects and the aspects. The method used is the midpoint method. |
| POST |
Lunar Return - AI Context /api/v5/context/lunar-return |
Returns a structured XML description of a Lunar Return chart data, optimized for AI/LLMs. ### Parameters - `subject` (JSON object, required): The subject's natal birth data. -… |
| POST |
Composite Chart /api/v3/composite-chart |
Get the composite chart data of two subjects. |
| POST |
Compatibility Score /api/v5/compatibility-score |
Calculates the Ciro Discepolo compatibility score between two subjects. Returns a numerical score, a description, and whether it's a "destiny sign". Also returns the full… |
| POST |
Transit Chart /api/v5/chart/transit |
Generates a transit chart showing the current planetary positions in relation to a natal chart. Returns calculated transit data and a rendered dual-wheel SVG chart (inner wheel:… |
| POST |
Solar Return Chart /api/v5/chart/solar-return |
Generates a Solar Return chart for the return happening on or after the specified date. The Solar Return occurs when the Sun returns to the exact position it was at the moment of… |
| POST |
Discepolo Score /api/v3/discepolo-score |
Get compatibility score number according to Ciro Discepolo method. Here the description (in Italian): http://www.cirodiscepolo.it/Articoli/Discepoloele.htm |
| POST |
Discepolo Score /api/v3/discepolo-score |
Get compatibility score number according to Ciro Discepolo method. |
| POST |
Solar Return - AI Context /api/v5/context/solar-return |
Returns a structured XML analysis of a Solar Return chart, optimized for AI/LLMs. ### Parameters - `subject` (JSON object, required): The subject's natal birth data. - `year`… |
| POST |
Transit Aspects and Data /api/v4/transit-aspects-data |
Retrieve transit aspects and data for a specific subject. Does not include the chart. |
| POST |
Lunar (Moon) Return Chart /api/v5/chart/lunar-return |
Generates a Lunar Return chart for the return happening on or after the specified date. The Lunar Return occurs when the Moon returns to the exact position it was at the moment… |
| POST |
Solar Return Data /api/v5/chart-data/solar-return |
Calculates Solar Return chart data for the return happening on or after the specified date. Does not include SVG rendering. ### Parameters - `subject` (JSON object, required):… |
| POST |
Solar Return Chart /api/v5/chart/solar-return |
Generates a Solar Return chart for the return happening on or after the specified date. The Solar Return occurs when the Sun returns to the exact position it was at the moment of… |
| POST |
Relationship Score /api/v4/relationship-score |
Get compatibility score number according to Ciro Discepolo method. |
| POST |
Lunar Return Data /api/v5/chart-data/lunar-return |
Calculates Lunar Return chart data for the return happening on or after the specified date. Does not include SVG rendering. ### Parameters - `subject` (JSON object, required):… |
Astrologer pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $9 / month | — |
|
| ULTRA Recommended | $18 / month | — |
|
| MEGA | $40 / month | — |
|