Korean Saju Compatibility (Gunghap) Calculator
Pricing
$20.00 / 1,000 compatibility result computeds
Korean Saju Compatibility (Gunghap) Calculator
Compute Korean Saju compatibility (gunghap) for two people from their birth dates & times: match score, day-master fit, Stem/Branch harmonies & clashes, Five Elements balance, plus a Korean-language summary with advice. Pure calculation, no external calls. Batch-friendly.
A Korean Saju love compatibility calculator (궁합 / gunghap): give it two people's birth dates and times and get a full compatibility reading back — overall match score, day-master fit, stem/branch harmonies & clashes, and Five Elements balance — as clean JSON, in batch, with zero external API calls (pure computation, runs entirely on Apify's cloud). Ideal as a Saju compatibility / synastry-style API for dating apps, matchmaking sites, and astrology tools.
Built and maintained by KunStudio (also publishers of the Saju API and sajuapp.app).
What it returns
For each pair you get:
Section (include key) | Content |
|---|---|
scores | Overall match score (0–98) + component scores (ilgan / interaction / balance) |
ilganAnalysis | Day-master (일간) compatibility score + notes (element relation, yin-yang, spouse palace) |
stemInteractions | Heavenly Stem harmonies (합) and clashes (충) between the two charts |
branchInteractions | Earthly Branch six-harmonies and six-clashes |
elementBalance | Combined Five Elements distribution, balance score, mutual complementarity |
summary | Written summary: headline, advice, cautions |
Each person's returned block includes their Four Pillars, day-master, and zodiac animal.
Input
{"pairs": [{"personA": { "year": 1990, "month": 5, "day": 15, "hour": 14, "gender": "male" },"personB": { "year": 1992, "month": 8, "day": 20, "hour": 9, "gender": "female" },"label": "us"}],"include": ["scores", "summary"]}
pairs— array (max 1000). Each person:year1920–2050,month1–12,day1–31,hour0–23 (omit or-1if unknown),gendermale/female.include— sections to return; empty = all.
Solar (Gregorian) calendar input; the engine converts to lunar internally.
Output
One dataset item per pair. Invalid pairs return { ok: false, error } instead of failing the whole run, so a batch of 1000 never dies on one bad row.
Note on output language
The written summary, ilganAnalysis.notes, and interaction names are in Korean (traditional 명리학 terminology). Numeric scores and structured fields are language-neutral.
Pricing
Pay-per-result: you are charged once per successfully analyzed pair. No subscription, no free-trial trap — pay only for what you compute.
Support
Questions, bug reports, or feature requests: https://sajuapp.app/support
We usually respond within 1 business day.