Synastry API: Compare Two Charts and Score Compatibility Across 13 Relationship Dimensions

Name: Western Nova
Brand: DivineAPI
Rating: 4.8 (52 reviews)

Drop in two birth charts, get back inter-aspect grids, house overlays, composite and Davison charts, and weighted compatibility scores broken into 13 life dimensions. 12 languages, Swiss Ephemeris accuracy, ready for dating apps, wedding sites, and relationship coaches.

Starts from $39 /month · 14-day free trial

Start Free Trial Book a Demo

Sample API Request

POST /api/1.0/synastry_api.php

// Request
{
  "api_key": "YOUR_API_KEY",
  "date": "2026-05-03",
  "sign": "aries",
  "lang": "en"
}

// Response
{
  "success": 1,
  "message": "Prediction data.",
  "data": {
    "prediction": "Today brings new..."
  }
}

200 OK Documentation →

What the Synastry API Unlocks

Two charts in, a full relationship map out: aspects, house overlays, composites, and scored compatibility your users can actually read.

Detailed Planetary Positions and House Cusps

Provide accurate planetary placements and house cusp data to help users understand how celestial bodies influence their personality, strengths, career path, and overall life journey.

Personalized Zodiac Sign and House Reports

Offer customized readings on planetary positions in zodiac signs and houses, explaining their impact on emotional intelligence, relationships, decision-making, and personal growth.

Lunar Phases and Emotional Influence

Deliver in-depth analysis of moon phases and their astrological significance, helping users understand how lunar cycles shape their emotions, instincts, and inner transformation throughout life.

Natal Chart Interpretation with Aspects

Generate natal wheel charts with aspect analysis, revealing how planetary relationships influence personality traits, decision-making abilities, and life challenges for a deeper astrological understanding.

Full Inter-Aspect Grid

Every planet in Chart A paired with every planet in Chart B: conjunctions, trines, squares, oppositions, sextiles, and minor aspects. Orbs, applying/separating status, and exactness percentage all included so you can surface the strongest contacts first.

Compatibility Scored in 13 Dimensions

A single summary number isn't enough for real users. DivineAPI breaks compatibility into emotional, physical, intellectual, spiritual, communication, sexual, financial, family, and six more axes, each with its own score and written explanation.

Composite and Davison Charts Included

Beyond the standard synastry overlay, the API builds composite charts (midpoint method) and Davison charts (time-space midpoint) so you can describe the relationship itself as its own astrological entity, not just how two people affect each other.

Bi-Wheel Visuals, Ready to Render

Call the synastry wheel endpoint and get back a bi-wheel SVG: Chart A on the inner ring, Chart B on the outer, aspect lines between them. Style the colors, stroke weights, and glyph sets via query parameters, or pull raw coordinates for a custom renderer.

Every Transit, With an Exact Date

Pass a birth chart and a date range: get back every aspect current planets are forming to the natal placements. Each hit lists aspect type, orb, applying or separating status, and the precise timestamp it goes exact. No guessing which date matters.

Retrograde Arcs, Not Just Snapshots

When a planet retrogrades over a natal point three times, users want the whole arc: first pass, station retrograde, second pass, station direct, third pass. The API returns each event with its date and written guidance so the full narrative of the transit shows up in your product.

Eclipses, Ingresses, and Moon Phases

Solar and lunar eclipses with exact times and types, outer-planet sign ingresses, and a moon phase calendar with New/Full/Quarter events, all cross-referenced to the natal chart so you can highlight which dates will matter most for that specific person.

Personalized Daily Horoscopes at Scale

Skip generic per-sign horoscopes. Compute the actual transits to each user's natal chart every morning and ship forecasts that reference their real chart: their actual Venus square, their exact Saturn return. 72ms response times make daily-per-user feasible at scale.

Choose Your Plan

Choose a plan that fits your traffic. All plans include a 14-day free trial.

Not sure how to choose?

We’ve got your back. Answer a few quick questions and we can make a personalized recommendation for you.

Book a Demo

Western Nova

$39

/ month

Billed monthly

Entry-level Western Astrology plan with planetary positions, house cusps, aspect table, natal wheel chart, moon phases, synastry, and Tarot Gold bonus.

Western Atlas

$79

/ month

Billed monthly

Advanced Western Astrology plan adding planet returns, Arabic lots, fixed stars, other minor bodies, transits, moon phase calendar, and eclipses.

Western Lumen

$149

/ month

Billed monthly

Complete Western Astrology plan with all Natal Atlas features plus progressions, composite charts, natal insights, dominants, prenatal chart, declinations, and planetary midpoints.

Planetary Positions

Sign

Longitude (DMS)

Full Degree (0 - 360)

House Placement

Speed

Retrograde Status

Element

Modality

House Cusps

House Number (1-12)

Sign

Sign No

Longitude (DMS)

Full Degree (0-360)

Aspect Table

Aspect Attributes

Supported Aspect Types

Applicable Bodies

Natal wheel chart

Output: SVG + Base64

Customization Options

House System: 20+ Supported

Aspect Patterns

Pattern Type

Sign / House Identifier

Planets Involved

Associated Aspects

Chart Shape

Chart Shape Name

Visual Representation (SVG)

Ascendant Report

Personality

Career

Health

Finance

Relationships

Moon phases

Phase Name & Degree

Natal Moon Sign & House

Lunar Position Details

Core Theme

Behavioral & Growth Insights

All Major Lunar Phases

General Sign Report

Planet In Sign Analysis

General House Report

Planet In House Analysis

Planet Returns

Upcoming Planetary Return Dates

Full Return Chart At The Exact Return Moment

Planets, Houses, Aspects & Visual Wheel

Arabic lots

Lot Of Fortune

Lot Of Spirit

Lot Of Relationships

Lot Of Success & Power

Lot Of Challenges & Conflicts

Fixed stars

Fixed Star Directory

Star Details

Position + Degree + House Data

Other Minor Bodies

19 Minor Bodies/Points

Transits

Daily Transit

Weekly Transit

Monthly Transit

Full Transit

Planetary Ingress

Planet Retrograde Transit

Planet Combustion Transit

Synastry

Planetary Positions

House Cusps

Natal Wheel Chart

Aspect Table

Harmonius Aspect Reading

Conflicting Aspect Reading

Contrasting Aspect Reading

Intense Aspect Reading

Physical Compatibility

Emotional Compatibility

Sexual Compatibility

Spiritual Compatibility

Financial Compatibility

Moon Phase Calendar

Daily Moon Phase Calendar

Phase Name, Illumination & Moon Age

Exact Phase Change Date & Times

Eclipse

Solar Eclipse

Lunar Eclipse

Progressed Lunar Events

Major Progressed Lunar Milestones

Planetary arc directions

Planet Arcs

House Arcs

Aspect Arcs

Secondary Progressions

Progressed Planets

Progressed Houses

Progressed Aspects

Composite Charts

Planetary Positions

House Cusps

Natal Wheel Chart

Aspect Table

Natal Insights

Elements & Modes

Chart Balance

Hemispheric Focus

Dominants

Dominant Energies

Key Influences

Power Planets

Chart Signature

Core Dominance

Prenatal Chart

Prenatal Syzygy

Prenatal Epoch

Prenatal Eclipse

Declinations-Parallels

Planet Declinations

Parallels & Contra-Parallels

Planetary Midpoints

Chart Midpoints

Planet Midpoints

Numerology Advance

Bonus

Core Numbers

Chaldean Numerology

Tarot Gold

Bonus

Yes OR No Tarot

Daily Tarot

Past-Present-Future Reading

Dream Come True Reading

Divine Angel Reading

In-Depth Love Reading

Past Lives Connection Reading

Divine Magic Reading

Wisdom Reading

Love Triangle Reading

Heartbreak Reading

Which Animal Are You Reading

Career Daily Reading

Know Your Friend Reading

Power Life Reading

Made For Each Other Or Not Reading

Ex-Flame Reading

Egyptian Prediction

Erotic Love Reading

Flirt Love Reading

Horoscope

Bonus

Daily, Weekly, Monthly And Yearly Horoscope Updates

Chinese horoscope

Bonus

Growth

Health

Wealth

Career

Love

Family

Fortune

Love Compatibility

Bonus

Calculators

Bonus

Flames Calculator

Love Calculator

Ascendant / Rising Calculator

Moon Phase Calculator

API Request / month

2.5M

Start 14-Day Free Trial

Not sure how to choose?

We’ve got your back. Answer a few quick questions and we can make a personalized recommendation for you.

Book a Demo

Western Nova

$33

/ month

Billed Half Yearly

Entry-level Western Astrology plan with planetary positions, house cusps, aspect table, natal wheel chart, moon phases, synastry, and Tarot Gold bonus.

Western Atlas

$67

/ month

Billed Half Yearly

Advanced Western Astrology plan adding planet returns, Arabic lots, fixed stars, other minor bodies, transits, moon phase calendar, and eclipses.

Western Lumen

$126

/ month

Billed Half Yearly

Complete Western Astrology plan with all Natal Atlas features plus progressions, composite charts, natal insights, dominants, prenatal chart, declinations, and planetary midpoints.

Planetary Positions

Sign

Longitude (DMS)

Full Degree (0 - 360)

House Placement

Speed

Retrograde Status

Element

Modality

House Cusps

House Number (1-12)

Sign

Sign No

Longitude (DMS)

Full Degree (0-360)

Aspect Table

Aspect Attributes

Supported Aspect Types

Applicable Bodies

Natal wheel chart

Output: SVG + Base64

Customization Options

House System: 20+ Supported

Aspect Patterns

Pattern Type

Sign / House Identifier

Planets Involved

Associated Aspects

Chart Shape

Chart Shape Name

Visual Representation (SVG)

Ascendant Report

Personality

Career

Health

Finance

Relationships

Moon phases

Phase Name & Degree

Natal Moon Sign & House

Lunar Position Details

Core Theme

Behavioral & Growth Insights

All Major Lunar Phases

General Sign Report

Planet In Sign Analysis

General House Report

Planet In House Analysis

Planet Returns

Upcoming Planetary Return Dates

Full Return Chart At The Exact Return Moment

Planets, Houses, Aspects & Visual Wheel

Arabic lots

Lot Of Fortune

Lot Of Spirit

Lot Of Relationships

Lot Of Success & Power

Lot Of Challenges & Conflicts

Fixed stars

Fixed Star Directory

Star Details

Position + Degree + House Data

Other Minor Bodies

19 Minor Bodies/Points

Transits

Daily Transit

Weekly Transit

Monthly Transit

Full Transit

Planetary Ingress

Planet Retrograde Transit

Planet Combustion Transit

Synastry

Planetary Positions

House Cusps

Natal Wheel Chart

Aspect Table

Harmonius Aspect Reading

Conflicting Aspect Reading

Contrasting Aspect Reading

Intense Aspect Reading

Physical Compatibility

Emotional Compatibility

Sexual Compatibility

Spiritual Compatibility

Financial Compatibility

Moon Phase Calendar

Daily Moon Phase Calendar

Phase Name, Illumination & Moon Age

Exact Phase Change Date & Times

Eclipse

Solar Eclipse

Lunar Eclipse

Progressed Lunar Events

Major Progressed Lunar Milestones

Planetary arc directions

Planet Arcs

House Arcs

Aspect Arcs

Secondary Progressions

Progressed Planets

Progressed Houses

Progressed Aspects

Composite Charts

Planetary Positions

House Cusps

Natal Wheel Chart

Aspect Table

Natal Insights

Elements & Modes

Chart Balance

Hemispheric Focus

Dominants

Dominant Energies

Key Influences

Power Planets

Chart Signature

Core Dominance

Prenatal Chart

Prenatal Syzygy

Prenatal Epoch

Prenatal Eclipse

Declinations-Parallels

Planet Declinations

Parallels & Contra-Parallels

Planetary Midpoints

Chart Midpoints

Planet Midpoints

Numerology Advance

Bonus

Core Numbers

Chaldean Numerology

Tarot Gold

Bonus

Yes OR No Tarot

Daily Tarot

Past-Present-Future Reading

Dream Come True Reading

Divine Angel Reading

In-Depth Love Reading

Past Lives Connection Reading

Divine Magic Reading

Wisdom Reading

Love Triangle Reading

Heartbreak Reading

Which Animal Are You Reading

Career Daily Reading

Know Your Friend Reading

Power Life Reading

Made For Each Other Or Not Reading

Ex-Flame Reading

Egyptian Prediction

Erotic Love Reading

Flirt Love Reading

Horoscope

Bonus

Daily, Weekly, Monthly And Yearly Horoscope Updates

Chinese horoscope

Bonus

Growth

Health

Wealth

Career

Love

Family

Fortune

Love Compatibility

Bonus

Calculators

Bonus

Flames Calculator

Love Calculator

Ascendant / Rising Calculator

Moon Phase Calculator

API Request / month

2.5M

Start 14-Day Free Trial

Not sure how to choose?

We’ve got your back. Answer a few quick questions and we can make a personalized recommendation for you.

Book a Demo

Western Nova

$29

/ month

Billed Yearly

Entry-level Western Astrology plan with planetary positions, house cusps, aspect table, natal wheel chart, moon phases, synastry, and Tarot Gold bonus.

Western Atlas

$59

/ month

Billed Yearly

Advanced Western Astrology plan adding planet returns, Arabic lots, fixed stars, other minor bodies, transits, moon phase calendar, and eclipses.

Western Lumen

$111

/ month

Billed Yearly

Complete Western Astrology plan with all Natal Atlas features plus progressions, composite charts, natal insights, dominants, prenatal chart, declinations, and planetary midpoints.

Planetary Positions

Sign

Longitude (DMS)

Full Degree (0 - 360)

House Placement

Speed

Retrograde Status

Element

Modality

House Cusps

House Number (1-12)

Sign

Sign No

Longitude (DMS)

Full Degree (0-360)

Aspect Table

Aspect Attributes

Supported Aspect Types

Applicable Bodies

Natal wheel chart

Output: SVG + Base64

Customization Options

House System: 20+ Supported

Aspect Patterns

Pattern Type

Sign / House Identifier

Planets Involved

Associated Aspects

Chart Shape

Chart Shape Name

Visual Representation (SVG)

Ascendant Report

Personality

Career

Health

Finance

Relationships

Moon phases

Phase Name & Degree

Natal Moon Sign & House

Lunar Position Details

Core Theme

Behavioral & Growth Insights

All Major Lunar Phases

General Sign Report

Planet In Sign Analysis

General House Report

Planet In House Analysis

Planet Returns

Upcoming Planetary Return Dates

Full Return Chart At The Exact Return Moment

Planets, Houses, Aspects & Visual Wheel

Arabic lots

Lot Of Fortune

Lot Of Spirit

Lot Of Relationships

Lot Of Success & Power

Lot Of Challenges & Conflicts

Fixed stars

Fixed Star Directory

Star Details

Position + Degree + House Data

Other Minor Bodies

19 Minor Bodies/Points

Transits

Daily Transit

Weekly Transit

Monthly Transit

Full Transit

Planetary Ingress

Planet Retrograde Transit

Planet Combustion Transit

Synastry

Planetary Positions

House Cusps

Natal Wheel Chart

Aspect Table

Harmonius Aspect Reading

Conflicting Aspect Reading

Contrasting Aspect Reading

Intense Aspect Reading

Physical Compatibility

Emotional Compatibility

Sexual Compatibility

Spiritual Compatibility

Financial Compatibility

Moon Phase Calendar

Daily Moon Phase Calendar

Phase Name, Illumination & Moon Age

Exact Phase Change Date & Times

Eclipse

Solar Eclipse

Lunar Eclipse

Progressed Lunar Events

Major Progressed Lunar Milestones

Planetary arc directions

Planet Arcs

House Arcs

Aspect Arcs

Secondary Progressions

Progressed Planets

Progressed Houses

Progressed Aspects

Composite Charts

Planetary Positions

House Cusps

Natal Wheel Chart

Aspect Table

Natal Insights

Elements & Modes

Chart Balance

Hemispheric Focus

Dominants

Dominant Energies

Key Influences

Power Planets

Chart Signature

Core Dominance

Prenatal Chart

Prenatal Syzygy

Prenatal Epoch

Prenatal Eclipse

Declinations-Parallels

Planet Declinations

Parallels & Contra-Parallels

Planetary Midpoints

Chart Midpoints

Planet Midpoints

Numerology Advance

Bonus

Core Numbers

Chaldean Numerology

Tarot Gold

Bonus

Yes OR No Tarot

Daily Tarot

Past-Present-Future Reading

Dream Come True Reading

Divine Angel Reading

In-Depth Love Reading

Past Lives Connection Reading

Divine Magic Reading

Wisdom Reading

Love Triangle Reading

Heartbreak Reading

Which Animal Are You Reading

Career Daily Reading

Know Your Friend Reading

Power Life Reading

Made For Each Other Or Not Reading

Ex-Flame Reading

Egyptian Prediction

Erotic Love Reading

Flirt Love Reading

Horoscope

Bonus

Daily, Weekly, Monthly And Yearly Horoscope Updates

Chinese horoscope

Bonus

Growth

Health

Wealth

Career

Love

Family

Fortune

Love Compatibility

Bonus

Calculators

Bonus

Flames Calculator

Love Calculator

Ascendant / Rising Calculator

Moon Phase Calculator

API Request / month

2.5M

Start 14-Day Free Trial

*USD 0.24 per thousand API calls after exceeding the API limits

Learn More

Why Leading Businesses Choose DivineAPI

We go beyond providing astrology APIs - DivineAPI is your partner in growth. With unmatched accuracy, user-friendly integration, and 360-degree support, we help you attract, engage, and retain users effortlessly.

All in One Solution

One platform to handle all your astrology and API needs seamlessly.

Seamless Integration

Quickly integrate with developer-friendly guides and zero hassle.

100% White-Labeled

Showcase your brand with personalized, fully customizable tools.

Astrological Precision

Stay ahead with real-time updates for precise astrology content.

Quick, Hassle-Free Setup

Launch your astrology services quickly and effortlessly.

Support That Goes the Extra Mile

From onboarding to scaling, we’ve got you covered every step of the way.

Add Western Nova Widget to Your Platform in Minutes

Our plug-and-play Western Nova widget is built for speed and simplicity. Offer engaging, personalized astrology content to your users without writing a single line of code.

DivineAPI vs Every Other Synastry API

Compare compatibility scoring depth, chart variety, and language coverage across leading synastry APIs.

Feature	DivineAPI	Vedika	AstrologyAPI	Prokerala	Aztro
Daily Content Volume	5000+ words/day	AI-generated	Standard	Basic	1 paragraph
Time Periods	Daily, Weekly, Monthly, Yearly	Daily	Daily, Monthly, Yearly	Daily	Daily only
Content Categories	6 categories	General	Love, Career, Health	General	General
Lucky Numbers & Colors	Numbers, Colors & Hex Codes		Basic		Basic
Singles & Couples Advice
Cosmic Tips	Daily
WordPress Plugin	Native
Shopify & Wix	Both
Embeddable Widget	Customizable
Languages	23	30	5+	5+	1
White-Label	100%				N/A
Price	$49/mo	From $12/mo	Custom	$19/mo	Free

DivineAPI is the only synastry API to score compatibility across 13 dimensions, return composite and Davison charts, and ship written interpretations in 12 languages.

Plugins and Widgets for
WordPress, Shopify, Wix, and More

Developer Friendly. Astrologically Accurate. Business Oriented.
Deliver astrological precision to your audience with our user-friendly, integrated API.

Western Astrology Widget

Explore Widget

Western Astrology Wordpress Plugin

Explore Plugin

Western Astrology Wix

Explore Wix

Western Astrology Shopify Plugin

Explore Shopify

Frequently Asked Questions

Relationship compatibility between two birth charts. It returns interaspect analysis (every planet from chart A against every planet from chart B), house overlays, composite chart, Davison chart, and a compatibility score across multiple life dimensions.

Up to 13 on Natal Lumen, including physical attraction, emotional bond, sexual chemistry, mental connection, communication style, shared values, long-term stability, conflict pattern, spiritual alignment, financial compatibility, family outlook, social dynamic, and growth potential.

Yes. Composite charts (midpoint method) and Davison charts (time-space midpoint) both come back with full planetary placements, houses, and aspects so you can analyze the relationship as its own entity.

Both partners' date, time, and place of birth. Time precision matters because house overlays depend on accurate Ascendants. The API still works without birth times, just with reduced accuracy on house-related aspects.

Conjunction, opposition, trine, square, sextile, quincunx, and the minor aspects. Orbs are tunable. The response includes aspect type, exact orb, applying or separating, and a plain-language summary of what that contact typically means.

Pre-written by our astrology team. Minimum 15 years of practice on the team, with several astrologers at up to 30 years. Every major interaspect has a human-authored interpretation, so results read like a real relationship reading.

Yes, through our dedicated reports product at reports.divineapi.com, which is a separate product built specifically for white-label PDF generation. It carries 125+ ready-to-brand report types covering compatibility, synastry, natal, Vedic, numerology, and more, all of them designed to be customized with your logo, cover page, color palette, and footer before delivery. Keeping the reports product separate from the Natal API lets us invest in far deeper report design and content depth than a bundled PDF feature ever could, which is why the library sits at 125+ reports rather than a handful. If compatibility PDFs are part of your product, most customers run the Natal API for live chart calculations and the reports product alongside it for branded downloads.

Core synastry and composite endpoints are available on Atlas. Lumen unlocks the full 13-dimension scoring, Davison charts, and the highest monthly call volume. Pricing page has the complete split.

12 native languages covering English, Hindi, Spanish, French, German, Portuguese, Russian, Italian, Arabic, Japanese, Chinese and Dutch.

Yes, 14 days of full access to every synastry and composite endpoint. A credit card is required to start the trial. You can cancel inside the dashboard before day 14 with no charge.

Let's Talk!

Our friendly team would love to hear from you.

First name *

Last name *

Email *

Phone (Optional)

Message *

Synastry API: Compare Two Charts and Score Compatibility Across 13 Relationship Dimensions

What the Synastry API Unlocks

Detailed Planetary Positions and House Cusps

Personalized Zodiac Sign and House Reports

Lunar Phases and Emotional Influence

Natal Chart Interpretation with Aspects

Full Inter-Aspect Grid

Compatibility Scored in 13 Dimensions

Composite and Davison Charts Included

Bi-Wheel Visuals, Ready to Render

Every Transit, With an Exact Date

Retrograde Arcs, Not Just Snapshots

Eclipses, Ingresses, and Moon Phases

Personalized Daily Horoscopes at Scale

Choose Your Plan

Not sure how to choose?

Western Nova

$39

Western Atlas

$79

Western Lumen

$149

Not sure how to choose?

Western Nova

$33

Western Atlas

$67

Western Lumen

$126

Not sure how to choose?

Western Nova

$29

Western Atlas

$59

Western Lumen

$111

Why Leading Businesses Choose DivineAPI

All in One Solution

Seamless Integration

100% White-Labeled

Astrological Precision

Quick, Hassle-Free Setup

Support That Goes the Extra Mile

Add Western Nova Widget to Your Platform in Minutes

DivineAPI vs Every Other Synastry API

Plugins and Widgets for WordPress, Shopify, Wix, and More

Western Astrology Widget

Western Astrology Wordpress Plugin

Western Astrology Wix

Western Astrology Shopify Plugin

Frequently Asked Questions

What does the Synastry API calculate?

How many compatibility dimensions are scored?

Does it include composite and Davison charts?

What inputs are required for a synastry reading?

Which aspects are compared between the two charts?

Is the synastry interpretation text pre-written or AI-filler?

Can I offer compatibility reports as branded PDFs?

Do I need the full Lumen plan to use synastry?

What languages is the synastry report available in?

Is there a free trial for synastry?

Let's Talk!

Plugins and Widgets for
WordPress, Shopify, Wix, and More