사주 데이터 API — 간지·십성·대운을 JSON으로

사주 데이터를 구조화된 JSON 으로

화면용 텍스트가 아니라 가공 가능한 원시 데이터가 필요할 때가 있습니다. 사주 API 는 간지·십성·대운을 깔끔한 JSON 으로 반환해, 자체 해석 로직이나 데이터 분석에 바로 쓸 수 있습니다.

응답 구조

응답은 data.modules 아래에 모듈별로 정리됩니다.

fourPillars — 연·월·일·시주 간지
tenGods — 십성 분포
decadeFortune — 대운 배열
합형충파해·격국·용신 등

const res = await fetch('https://api.sazu.app/v1/sazu/calculate', {
  method: 'POST',
  headers: { 'x-api-key': process.env.SAZU_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({ birthYear: 1990, birthMonth: 3, birthDay: 15, birthHour: 14, isFemale: false }),
})
const { data } = await res.json()
console.log(data.modules.fourPillars) // 연·월·일·시주

detail 로 응답 크기 조절

detail 파라미터로 응답 양을 조절합니다. minimal(값만), standard(핵심 해석, 기본), full(전체). 데이터 파이프라인이면 minimal 이 가볍습니다.

동일 입력 = 동일 출력

SAZU 의 계산은 순수함수라 같은 입력은 항상 같은 결과를 줍니다. 캐시가 안전하다는 뜻입니다. 전체 필드 정의는 API 문서에 있습니다.

SAZU 의 사주 API 는 신용카드 없이 월 500건 무료로 시작할 수 있습니다. 합형충파해·격국·용신·12운성 등 14개 분석 모듈을 단일 호출로 제공하며, 응답은 50ms 이하입니다. 자세한 사용법은 API 문서에서 확인하세요.