Saju (사주, 四柱) is a traditional Korean fortune-telling system based on the Chinese metaphysical concept of the Four Pillars of Destiny (BaZi in Chinese). It analyzes a person's fate and characteristics using their birth date and time.
The four pillars represent the year, month, day, and hour of birth, each consisting of two characters from the Heavenly Stems (천간) and Earthly Branches (지지) - totaling eight characters, hence also called Saju Palja (八字, Eight Characters).
In Korea, Saju analysis is deeply embedded in culture - used for marriage compatibility, career guidance, naming children, and understanding one's life path. Our API brings this ancient wisdom into the digital age.
UnseWiki API v1.0PRODUCTION READY|200K+ USERSAlgorithm verified by 200K+ users, delivered via REST API.
Complex fortune calculations in a single API call.
POST {SAJU_ENDPOINT}
{
"birthYear": "1990",
"birthMonth": "5",
"birthDay": "15",
"birthHour": "14",
"gender": "male"
}
// Response includes:
// - Four Pillars (四柱八字)
// - Ten Gods Analysis (十星)
// - Sin Strength 7-level rating
// - Hapchung relationships
// - Daeun/Seun fortune cycles
// - 20+ Sinsal analysis1.Manually input birth date on Manseryeok website2.Copy results and paste into GPT/Claude3.Write prompts and generate responses4.Repeat for each section... (6 sections = 6x manual work)1.Make one API call2.Done. All analysis results returned as JSONhapchungsinStrengthsibisinsalsdaeun.sipseongContinuously improved based on feedback from users and fortune-telling experts
Among 200K users, not a single complaint about incorrect Saju calculations. Expert-level accuracy guaranteed.
All major Saju characteristics - Sipseong, Sinsal, Hapchung, Sin Strength, Daeun/Seun - calculated with precision.
Based on feedback from professional fortune-tellers and real users, algorithms are continuously validated.
Use Cursor, Claude, ChatGPT, or any AI coding tool for rapid integration
No separate document file needed — just follow the API docs at the bottom of this page and you'll integrate in no time. You can pass them straight to your AI coding assistant.
1.Request API key2.Pass the API docs below to your AI assistant3."Integrate this API for me"4.Done in 10 minutesWith the right AI prompts, create expert-level fortune-telling services
The Saju data from UnseWiki API is based on traditional fortune-telling theory - 100% accurate calculations.
Include this data in your AI prompts, and the AI will generate expert-level interpretations.
Same API data, different products based on your prompts:
{VERIFY_ENDPOINT}API Key ValidationVerify if your API key is valid. Call this first when testing integration.
curl -X GET {VERIFY_ENDPOINT} \
-H "x-api-key: YOUR_API_KEY"
# Response (200 OK)
{ "valid": true, "message": "API key is valid", "timestamp": "..." }{SAJU_ENDPOINT}Input birth date and time to receive complete Saju analysis results as JSON.
ganjiHeavenly Stems & Earthly Branches (Year, Month, Day, Hour)sipseongTen Gods Analysis (Bigyeop, Siksang, Jaeseong, Gwanseong, Inseong)sinStrengthSin Strength 7-level ratingdaeunDaeun Analysis (10-year cycles) — sipseong, hapchung, twelve fortunes, yongsin judgmentseunSeun Analysis (yearly fortune) — with yongsin judgmentweolunWeolun Analysis (monthly fortune) — with yongsin judgmenthapchungHapchung relationship analysissibisinsalsTwelve Sinsal (20+ types)guiinNoble Person analysisdohwaPeach Blossom analysishongyeomRed Flame analysishwagaeFlower Canopy analysisbigyeonGeobjaeBigyeon/Geobjae analysis| PARAMETER | TYPE | REQUIRED | DESCRIPTION |
|---|---|---|---|
birthYear | string | required | Birth year (e.g., "1990") |
birthMonth | string | required | Birth month (e.g., "5") |
birthDay | string | required | Birth day (e.g., "15") |
birthHour | string | optional | Birth hour (0-23) |
birthMinute | string | optional | Birth minute (0-59) |
calendarType | "양력" | "음력" | required | Calendar type (Solar/Lunar) |
gender | "male" | "female" | required | Gender |
isLeapMonth | boolean | optional | Leap month flag |
fields | string[] | optional | Optional fields (omit for all) |
curl -X POST {SAJU_ENDPOINT} \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"birthYear": "1990",
"birthMonth": "5",
"birthDay": "15",
"birthHour": "14",
"birthMinute": "30",
"calendarType": "양력",
"gender": "male"
}'{
"ganji": {
"year": { "gan": "경", "ji": "오", "ganji": "경오(庚午)" },
"month": { "gan": "신", "ji": "사", "ganji": "신사(辛巳)" },
"day": { "gan": "갑", "ji": "자", "ganji": "갑자(甲子)" },
"hour": { "gan": "임", "ji": "오", "ganji": "임오(壬午)" }
},
"sipseong": {
"sipseongs": ["편관", "정인", "일원", "편인"],
"summary": { "bigyeop": 2, "siksang": 1, "jaeseong": 2, "gwanseong": 1, "inseong": 2 }
},
"sinStrength": {
"isStrong": true,
"strength": "신강",
"level": 6,
"score": 75,
"description": "The Day Master has strong energy"
},
"daeun": {
"direction": "순행",
"current_daeun": { "age_start": 32, "ganji": "갑술", "sipseong": "비견" },
"all_daeun": [...]
},
"hapchung": {
"cheon_gan": { "hap": [...], "chung": [...] },
"ji_ji": { "hap": [...], "chung": [...], "hyung": [...], "pa": [...], "hae": [...] }
},
"sibisinsals": {
"year": ["역마살", "화개살"],
"month": ["도화살"],
"day": ["귀문관살"],
"hour": ["백호살"]
},
...
}Custom pricing available for 5,000+ requests per month
For API key requests, technical inquiries, or volume pricing,
please contact us at the email below.
[email protected]Response within 24 hours on business days
Want to explore our fortune-telling service?
Try UnseWiki Service→