WESTERN ASTROLOGY API

Western Astrology API for Natal Charts, Synastry and Transits

Send a birth date, time and place. Get back tropical planets, houses, aspects and a styled wheel chart as clean JSON. Add synastry, transits, solar returns and daily forecasts with the same API key.

Features

Natal Chart

Wheel Chart

Transit API

Synastry API

Moon Phases

Planetary Returns

Custom PDFs

Complete Natal Chart Details

Natal planetary positions, house cusps, natal chart aspects and much more in a single API.

Get dominant element, dominant mode and hemisphere along with moon phase at the time of birth.

We offer bite-sized content you can show in an app for free, and detailed interpretation APIs for premium users.

Wheel Chart in SVG and PNG Formats

Use one of our default themes for wheel chart or get your exclusive customised natal chart designed from us.

Get creative with your natal chart designs and let us create a custom theme for you.

Transit and Forecast API

Whether you need current sky positions of planets or personalised transits with custom orbs, we have got you covered.

We also offer daily, weekly, monthly and yearly personalised transit interpretation APIs.

Personalised Compatibility API

We cover all aspects of compatibility be it Love, Friendship or Karma & Destiny.

We offer both summarised as well as detailed calculations along with interpretations.

Track Moon Phases with API

Whether you want to create a Lunar calendar or simply want to track upcoming Moon phases with their sign, luminosity and other details.

We have got it covered using our APIs.

Planetary Returns API

Solar Return is the most popular and is covered completely by our SR calculations and interpretations API.

We also offer planetary returns API for Saturn, Node, Jupiter among others.

Personalised and Detailed PDF Reports

Looking for premium reports for your premium users? Look no further, we have premium PDF reports API that are fully customisable as per your branding and theme.

We offer Natal Chart Report, Love Compatibility, Solar Return Report and Life Forecast Report in PDF using Single API call.

What the Western Astrology API returns

Western astrology uses the tropical zodiac, which follows the seasons. It is the astrology most people know from sun sign columns in Europe, the Americas and Australia. Our Western Astrology API does all the chart math for you.

You send a birth date, time and place. We return the full chart as JSON. Your app can draw it, explain it, or pass it to an AI model. Natal charts, compatibility, transits and returns all use the same request format.

Natal chart data
Sign, degree, house and speed for each planet, plus the node, Chiron, Part of Fortune and Lilith.
Houses and angles
Twelve house cusps, ascendant, midheaven and vertex, in nine house systems.
Aspects
Conjunctions, squares, trines and more, with the orb for each aspect.
Wheel charts
A ready SVG or PNG natal wheel you can style with your own colours.
Synastry and composite
Two charts side by side plus a composite chart for compatibility features.
Transits and returns
Daily, weekly and monthly transits, solar returns, lunar metrics and moon phases.

Key Western endpoints

Every call is a POST with the birth details in the body: day, month, year, hour, min, lat, lon and tzone. Here are four endpoints most apps start with, with real sample output from our docs.

Base URL: https://json.astrologyapi.com/v1

POST/western_horoscope

Full natal chart

Returns planets, houses, aspects and angles in one call. This is the base for most birth chart screens.

1{
2  "planets": [
3    {
4      "name": "Sun",
5      "full_degree": 275.6427,
6      "norm_degree": 5.6427,
7      "speed": 1.019,
8      "is_retro": "false",
9      "sign": "Capricorn",
10      "house": 2
11    }
12  ],
13  "houses": [
14    { "house": 1, "sign": "Sagittarius", "degree": 240.71431 }
15  ],
16  "aspects": [
17    {
18      "aspecting_planet": "Sun",
19      "aspected_planet": "Mercury",
20      "type": "Conjunction",
21      "orb": 2.66
22    }
23  ]
24}

Read the /western_horoscope reference →

POST/natal_wheel_chart

Natal wheel chart

Returns a link to a rendered wheel chart. Set chart_size, image_type and colour fields to match your design.

1{
2  "status": true,
3  "chart_url": "https://s3.ap-south-1.amazonaws.com/western-chart/65a7ab90-df91-11e9-9ab4-a70005bb269b.svg",
4  "msg": "Chart created successfully!"
5}

Read the /natal_wheel_chart reference →

POST/tropical_transits/daily

Daily transits

Shows where today’s planets fall in the user’s natal houses and which natal planets they aspect. Use it for daily alerts.

1{
2  "transit_date": "17-6-2017",
3  "ascendant": "Leo",
4  "transit_house": [
5    {
6      "planet": "Sun",
7      "natal_sign": "Taurus",
8      "transit_house": 11,
9      "is_retrograde": false
10    }
11  ],
12  "transit_relation": [
13    {
14      "transit_planet": "Sun",
15      "natal_planet": "Jupiter",
16      "type": "Sextile",
17      "orb": 0.66
18    }
19  ]
20}

Read the /tropical_transits/daily reference →

POST/synastry_horoscope

Synastry

Takes two birth charts. Returns planets for each person under first and second, plus a composite chart.

1{
2  "first": [
3    { "name": "Sun", "sign": "Aquarius", "house": 4 }
4  ],
5  "second": [
6    { "name": "Sun", "sign": "Pisces", "house": 5 }
7  ],
8  "composite": {
9    "planets": [
10      { "name": "Sun", "sign": "Aquarius", "house": 4 }
11    ]
12  }
13}

Read the /synastry_horoscope reference →

Who uses the Western Astrology API

More than 3,000+ businesses build on AstrologyAPI. These are the most common Western use cases.

Astrology and self-discovery apps

Show each user their full birth chart, a wheel image and a reading for every planet and house.

Build a Western birth chart →

Dating and relationship apps

Add a compatibility score or a synastry view to profiles and matches.

Astrology compatibility for dating apps →

Notification and habit apps

Send a push alert when a transit hits a user’s chart. Daily transit data makes each alert personal.

Build a transit alert system →

Media and lifestyle publishers

Pair natal data with our daily horoscopes for sign pages, newsletters and moon phase widgets.

Horoscope API →

AI chat assistants

Give your AI model the real chart so it explains the user’s placements instead of guessing.

Why ChatGPT can’t calculate birth charts →

Apps that serve both traditions

Offer Western and Vedic readings side by side with the same key.

Vedic Astrology API →

Docs, guides and reading

Start with the reference, then follow a guide to ship your first feature.

Western Astrology API FAQ

What is a Western Astrology API?

A Western Astrology API turns a birth date, time and place into a tropical birth chart your app can use. You send the birth details. We send back JSON with planets, signs, houses, aspects and angles. You do not need to run an ephemeris or write any astronomy code.

Which house systems do you support?

Our natal chart endpoint supports Placidus, Koch, Porphyry, Equal, Whole Sign, Topocentric, Sripati, Horizontal and Campanus. You pick one with the house_type field in the request.

Can I show a natal wheel chart in my app?

Yes. The natal_wheel_chart endpoint returns a link to a ready-made SVG or PNG chart. You can set the chart size and colours, such as the sign icon colour and inner circle background, to match your brand.

Do you have synastry and compatibility endpoints?

Yes. Send two birth charts to synastry_horoscope and we return both sets of planets plus a composite chart. We also have composite chart, love compatibility and romantic forecast endpoints for dating apps.

Which languages does the Western API return?

Many Western endpoints return text in English, Spanish, Portuguese, French, Italian, German and Russian. Each endpoint page in our docs lists the languages it supports.

Can I use Vedic and Western astrology with one key?

Yes. One API key covers 300+ endpoints across Western, Vedic, numerology, tarot and more. Many apps let each user pick the system they follow.

Start building with the Western Astrology API

Create a free account and test every endpoint with free credits. No credit card needed.