SAZU 운세 API
운세 API
오늘의 운세부터 연간 운세·궁합·대운까지 — 만들고 싶은 운세 상품 이름 그대로 호출하는 REST API 입니다.
운세 API 란?
운세 API 는 생년월일·출생시간·성별·달력 구분(양력/음력·윤달)을 보내면 운세 서비스에 필요한 사주 데이터를 JSON 으로 돌려주는 개발자용 REST API 입니다. SAZU 운세 API 는 「오늘의 운세」·「연간 운세」·「궁합」처럼 운세 상품 하나를 엔드포인트 하나로 나눠 두어, 명리학을 깊이 몰라도 만들 상품 이름 그대로 호출할 수 있습니다.
운세 API 규격 한눈에 보기
- 방식
- REST API · HTTPS · JSON 응답
- 기준 주소
- https://api.sazu.app
- 인증
- x-api-key 헤더에 API 키
- 무료 사용
- 월 500건, 신용카드 불필요(샘플 사주)
- 분당 호출
- Free 분당 10회 · 유료 플랜 분당 최대 120회
- 호출 단가
- 호출당 최저 55원
- 계산 속도
- 명리 계산 평균 50ms 이하
- 입력
- 생년월일 · 출생시간 · 성별 · 양력/음력(윤달) · 진태양시 · 출생 시간 미상
- 연동 도구
- TypeScript SDK @sazuapp/client · MCP 서버 @sazuapp/mcp-server · OpenAPI 3.1
운세 상품별 엔드포인트
운세 토픽 13개를 제공합니다. 새 토픽을 계속 더하고 있습니다.
만세력 (명식 조회)
무료 플랜POST /v2/sazu/manse이 사람의 사주 명식은 어떻게 생겼나?
자세히 보기 →오늘의 운세
유료 플랜POST /v2/sazu/today오늘 하루, 이 사주에 무엇이 작용하나?
자세히 보기 →일일 운세
유료 플랜POST /v2/sazu/daily그날 일진이 이 사주의 일간에 어떻게 작용하나?
자세히 보기 →월 운세
유료 플랜POST /v2/sazu/monthly이번 달(또는 지정한 달)의 흐름은?
자세히 보기 →연간 운세
유료 플랜POST /v2/sazu/yearly그 해 1년의 흐름은?
자세히 보기 →대운 10년
유료 플랜POST /v2/sazu/decade지금 대운은 어디쯤이고, 다음 10년은?
자세히 보기 →평생 흐름
유료 플랜POST /v2/sazu/life이 사주의 골격과 평생의 큰 흐름은?
자세히 보기 →고민 상담
유료 플랜POST /v2/sazu/consult이 고민, 사주 데이터는 어느 방향을 가리키나?
자세히 보기 →관계 궁합
유료 플랜POST /v2/sazu/compatibility이 두(세) 사람 사이에 무엇이 걸려 있나?
자세히 보기 →연애 운
유료 플랜POST /v2/sazu/love내 연애, 지금 어느 흐름에 있나? (상대가 있으면 그 관계까지)
자세히 보기 →금전운
유료 플랜POST /v2/sazu/money재물은 언제, 어떤 구조로 들어오나?
자세히 보기 →건강운
유료 플랜POST /v2/sazu/health어느 기운·장부 계통을 유의해서 보나?
자세히 보기 →식단
유료 플랜POST /v2/sazu/food오늘 무엇을 먹으면 좋은가?
자세히 보기 →
운세 서비스, 이렇게 만듭니다
운세 API 로 만드는 서비스
운세 앱·웹 서비스는 오늘의 운세와 연간 운세로 매일 다시 찾아올 이유를 만들고, 궁합·연애 운으로 함께 보는 사람을 늘립니다.
쇼핑몰·커뮤니티는 연말연시 운세 이벤트로 방문자를 모읍니다. 상담 챗봇은 고민 상담 토픽으로 질문의 방향을 사주 데이터에 맞춥니다.
명리 식단처럼 생활에 바로 닿는 토픽도 있습니다. 식품유통 관련 사업자들이 명리 식단으로 상품 추천을 만들고 있으며, 새 토픽을 계속 더하고 있습니다.
운세 API 자주 묻는 질문
운세 API 란 무엇인가요?
운세 API 는 생년월일·출생시간·성별·달력 구분(양력/음력·윤달)을 보내면 운세 서비스에 필요한 사주 데이터를 JSON 으로 돌려주는 개발자용 REST API 입니다. SAZU 운세 API 는 「오늘의 운세」·「연간 운세」·「궁합」처럼 운세 상품 하나를 엔드포인트 하나로 나눠 두어, 명리학을 깊이 몰라도 만들 상품 이름 그대로 호출할 수 있습니다.
오늘의 운세 API 도 있나요?
네. POST /v2/sazu/today 가 오늘 하루의 일진이 사주에 어떻게 작용하는지를 돌려줍니다. 날짜를 지정하는 일일 운세(daily), 월 운세(monthly), 연간 운세(yearly)도 따로 있습니다.
운세 API 는 무료로 쓸 수 있나요?
신용카드 없이 Free 키로 월 500건까지 무료로 호출할 수 있습니다. Free 키는 샘플 사주로 응답 구조를 확인하는 용도이고, 실제 고객의 사주로 서비스하려면 유료 플랜(월 ₩22,000부터)을 씁니다.
풀이 문장까지 받을 수 있나요?
API 는 명리 분석 데이터를 돌려주고, 풀이 문장은 응답에 실린 AI 참조 안내를 사용하는 AI 에 넣어 만듭니다. 코딩 없이 풀이 문장까지 원하면 SAZU Studio, 홈페이지에 바로 붙이려면 임베드 위젯이 맞습니다.
사주 API·명리 API 와 무엇이 다른가요?
같은 엔진, 같은 키입니다. 운세 API 는 운세 상품(토픽) 단위로, 명리 API 는 그 안에 담기는 십성·신살·격국 같은 분석 모듈 단위로 설명한 이름입니다.