운세위키 API v1.4PRODUCTION READY|500K+ USERS전문 명리학자 자문으로 설계, 50만명이 검증한 알고리즘을 REST API로 제공합니다.
복잡한 명리학 계산을 단 하나의 API 호출로.
POST {SAJU_ENDPOINT}
{
"birthYear": "2000",
"birthMonth": "1",
"birthDay": "1",
"birthHour": "10",
"gender": "female"
}
// Response includes:
// - 사주팔자 + 십성 + 12운성
// - 신강/신약 7단계 + 격국/용신
// - 합충형파해 + 20종+ 신살
// - 대운별 십성·합충·12운성·용신 판정
// - 세운·월운별 십성·합충·12운성·용신 판정1.만세력 사이트에 생년월일 수동 입력2.결과 화면을 복사해서 GPT/Claude에 붙여넣기3.프롬프트 작성 후 답변 생성4.목차별로 반복... (6개면 6회 수작업)1.API 한 번 호출2.완료. JSON으로 모든 분석 결과 반환hapchungsinStrengthgyeokgukgyeokgukYongsindaeun/seun/weolun전문 명리학자의 자문으로 설계하고, 50만명 이상의 실사용자 피드백을 반영하여 지속적으로 개선해왔습니다
50만명의 사용자 중 "사주가 틀렸다"는 피드백이 0.01%도 채 되지 않습니다.전문가 수준의 정확도를 보장합니다.
사주팔자의 모든 주요 특성 - 십성, 신살, 합충형파해, 신강/신약, 대운/세운 등을 빠짐없이 정확하게 계산합니다.
전문 명리학자, 실사용자들의 피드백을 바탕으로 알고리즘을 지속적으로 검증하고 있습니다.
Cursor, Claude, ChatGPT 등 AI 코딩 도구로 빠르게 연동하세요
별도 문서 파일 없이, 이 페이지 하단의 API 문서만 보고 연동하면 금방 끝납니다. 그대로 AI 코딩 도구에 전달해도 됩니다.
1.API 키 발급 신청2.아래 API 문서를 AI에게 전달3."이 API 연동해줘"4.쉽고 빠르게 연동 완료여러 운세 서비스가 운세위키 API 위에서 안정적으로 운영되고 있습니다
실서비스 트래픽에서 검증된 안정성 — 믿고 연동하세요.
운세위키 API가 제공하는 사주 데이터는 전통 명리학 이론에 기반한 정확한 계산 결과입니다.
이 데이터를 AI 프롬프트에 포함시키면, AI가 명리학적 맥락을 이해하고 전문가 수준의 해석을 생성합니다.
동일한 API 데이터로 프롬프트에 따라 다양한 상품 구성 가능:
사주 한 종류가 아닙니다. 궁합부터 시기별 운세까지 — 받는 즉시 상품이 되는 데이터
유료 API를 이용하는 업체에 한해 만세력 API는 무료로 제공됩니다. 양·음력 변환·절기·60갑자·야자시/조자시 등 기준 데이터를 추가 과금 없이 사용하세요.
만세력 API만 단독으로 무료 이용은 불가합니다.
/saju사주팔자·십성·12운성·신강신약 7단계·격국/용신·합충형파해·20종+ 신살·대운/세운/월운 용신 판정까지 한 번에.
/mansae정확한 양·음력 변환, 절기, 60갑자, 야자시/조자시 규칙까지 — 만세력의 모든 기준 데이터.
/compatibility천간합·오행 보완 점수·지지 육합삼합방합·겉궁합/속궁합·S~E 종합 등급에, 두 사람의 개인 사주 전체까지 반환.
/period-fortune세운·월운·일진을 용신 판정 점수(-100~+100)와 합충·귀인·신살·12운성 에너지 레벨로. 좋은 시기·나쁜 시기가 숫자로 나옵니다.
{VERIFY_ENDPOINT}API 키 유효성 검증API 키가 유효한지 확인합니다. 연동 테스트 시 가장 먼저 호출해보세요.
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}생년월일시간을 입력하면 사주팔자의 모든 분석 결과를 JSON으로 반환합니다.
ganji천간지지 — 사주팔자 원국yearmonthdayhour?4주 각각 gan·ji·ganji·ganHanja·jiHanja·fullHangul·fullHanja 포함. hour는 birthHour 입력 시에만 반환
sipseong십성 분석 — 일간 기준 7개 위치별 십성sipseongs[]summaryanalysischeonganHap년간~시지 각 위치의 십성·정/편·카테고리·의미. summary는 5행 개수, cheonganHap은 천간합 오행 변화 분석
sinStrength신강/신약 — 7단계 점수 판정isStrongstrengthlevelscoredetailAnalysisstrength: 태왕~태약 7단계. 득령·득지·득세 boolean. detailAnalysis에 주별 점수(scoreBreakdown)와 도움/약화 요소 목록
gyeokguk격국 · 억부용신 — 내격/외격 판별typenamenaegeokDetailyongsin희신오행기신오행내격/외격 판별, 격국명·근거. yongsin에 억부용신 십신·오행·선택 방법. 희신·기신·구신 오행, 종합설명 포함
gyeokgukYongsin격국용신 · 상신 — 자평진전 체계geokgukYongsinsangsingisinhapChungDamageseongPaGeok격국 자체가 용신(자평진전). 상신 존재·통근 확인, 기신 감지, 합거·충거 파격 판단, 성격/파격 4등급(상격~파격). fields에 명시 요청 시만 반환
daeun대운 분석 — 10년 주기 운세 흐름current_daeunnext_daeunall_daeun[]directiondaeun_start_ageall_daeun 10개 대운 각각에 sipseong(간·지 십성+해석), wongukInteraction.hapChungRelations(원국과 합충), twelveFortune(에너지 레벨 1~12 + 키워드·성격·장단점·직업·관계·조언), yongsinJudgment(용신 판정 — 종합판정 대길~대흉·종합점수·천간/지지판정·용신/희신/기신오행·판정근거) 포함
seun세운 분석 — 연간 운세 흐름currentSeunnextSeunrecentSeuns[]upcomingSeuns[]올해·내년·최근 5년·향후 12년. 각 세운에 sipseongRelation(십성), hapChungRelations(원국과 합충), twelveFortune(에너지 레벨 + 상세 해석), yongsinJudgment(용신 판정 — 종합판정·종합점수·천간/지지판정·용신/희신/기신오행·판정근거) 포함
weolun월운 분석 — 월별 운세 흐름currentWeolunnextWeolunrecentWeoluns[]upcomingWeoluns[]이번달·다음달·지난 3개월·향후 10개월. 각 월운에 sipseongRelation(천간·지지 십성), interpretation(통합 해석), yongsinJudgment(용신 판정 — 종합판정·종합점수·천간/지지판정·용신/희신/기신오행·판정근거) 포함
hapchung원국 합충형파해 — 사주 내부 관계typesourcetargetsourcePositionmeaning배열. type: 천간합·천간충·천간충(확장)·지지충·지지형·지지해·지지파·육합·삼합·방합·원진. 인접 주면 meaning에 [인접] 표시. 완전삼합 시 별도 항목 추가
twelveFortune12운성 — 일간 기준 4주 에너지 레벨dayGanfortunes[]summaryiljiAnalysisfortunes 각 주의 fortune(장생~양 12종) + interpretation(keyword·energy·personality·strengths·weaknesses·career·relationship·advice·level 1~12). iljiAnalysis는 일지 12운성 심층 분석
sibisinsals십이신살 — 위치별 신살sibisinsals[]nakjeonggwansal[]각 신살: name·position(년지~시지)·ji·description. 장성살·역마살·도화살·년살·월살·망신살·육해살 등 해당하는 것만 포함
guiin귀인 분석 — 16종 귀인cheoneultaegeukmungokmunchangcheongwancheonbok...+1116개 귀인별 배열. 해당 귀인 있으면 { position, ji, name, description } 포함, 없으면 빈 배열 []
dohwa도화살 — 위치별 도화 유형dohwa[]각 { position, ji, type(자수/묘목/오화/유금도화), meaning }. 없으면 빈 배열
hongyeom홍염살 — 이성 매력·인기 관련hongyeom[]각 { position, ji, name, description }. 없으면 빈 배열
hwagae화개살 — 학문·예술·종교 관련hwagae[]각 { position, ji, name, meaning }. 없으면 빈 배열
bigyeonGeobjae비견/겁재 — 자아·경쟁 관련bigyeon[]geobjae[]bigyeonCounttotalCountanalysis비견·겁재 각각 배열 + 개수 합산. analysis에 종합 해석 텍스트
fields 파라미터로 필요한 항목만 선택 요청 가능 — 예: "fields": ["ganji", "daeun", "seun"]
| PARAMETER | TYPE | REQUIRED | DESCRIPTION |
|---|---|---|---|
birthYear | string | required | 출생년도 (예: "1990") |
birthMonth | string | required | 출생월 (예: "5") |
birthDay | string | required | 출생일 (예: "15") |
birthHour | string | optional | 출생시 (0-23) |
birthMinute | string | optional | 출생분 (0-59) |
calendarType | "양력" | "음력" | required | 달력 유형 |
gender | "male" | "female" | required | 성별 |
isLeapMonth | boolean | optional | 윤달 여부 (음력일 때만 사용) |
useYajasiRule | boolean | optional | 야자시/조자시 구분 적용 (23:30~01:29 출생 시) |
fields | string[] | optional | 선택적 필드 (생략 시 15개 반환, gyeokgukYongsin은 명시 요청만) |
curl -X POST {SAJU_ENDPOINT} \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"birthYear": "2000",
"birthMonth": "1",
"birthDay": "1",
"birthHour": "10",
"birthMinute": "0",
"calendarType": "양력",
"gender": "female"
}'클릭하면 실제 API 응답 전체를 확인할 수 있습니다
월 5,000건 이상 사용 예정 시 별도 협의 가능
API 키 발급, 기술 문의, 대량 사용 협의 등
아래 이메일 주소로 직접 메일을 보내주세요.
평일 기준 24시간 이내 회신
운세위키 서비스가 궁금하신가요?
운세위키 서비스 구경하기→