갱신 (2026-11-03) — 코드 예제를 현행 API(v2) 기준으로 갱신했습니다. 예시 입력은 무료 키로 바로 실행되는 공개 샘플 사주입니다.
사주 데이터를 구조화된 JSON 으로
화면용 텍스트가 아니라 가공 가능한 원시 데이터가 필요할 때가 있습니다. 사주 API 는 간지·십성·대운을 깔끔한 JSON 으로 반환해, 자체 해석 로직이나 데이터 분석에 바로 쓸 수 있습니다.
응답 구조
응답은 data.modules 아래에 모듈별로 정리됩니다.
- fourPillars — 연·월·일·시주 간지
- fourPillars 의 sippiSeong — 기둥마다의 십성
- decadeFortune — 대운 배열
- 합형충파해·격국·용신 등 — 토픽에 따라 담기는 모듈이 다릅니다
const res = await fetch('https://api.sazu.app/v2/sazu/manse', {
method: 'POST',
headers: { 'x-api-key': process.env.SAZU_API_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({ birthYear: 1998, birthMonth: 5, birthDay: 19, birthHour: 10, isFemale: false }),
})
const { data } = await res.json()
console.log(data.modules.fourPillars) // 연·월·일·시주
detail 로 응답 크기 조절
detail 파라미터로 응답 양을 조절합니다. minimal(값만), standard(핵심 해석, 기본), full(전체). 데이터 파이프라인이면 minimal 이 가볍습니다.
동일 입력 = 동일 출력
SAZU 의 계산은 순수함수라 같은 입력은 항상 같은 결과를 줍니다. 캐시가 안전하다는 뜻입니다. 전체 필드 정의는 API 문서에 있습니다.
SAZU 의 사주 API 는 신용카드 없이 무료로 시작할 수 있습니다. 합형충파해·격국·용신·12운성 등 분석 모듈을 단일 호출로 제공하며, 응답은 평균 약 100ms 입니다. 무료 한도와 플랜별 요금은 요금 안내에 있습니다. 자세한 사용법은 API 문서에서 확인하세요.