四柱推命API › 相性API

相性API

2人の生年月日（と出生時刻）を送ると、四柱推命（サジュ）の相性、星座の相性、干支の動物（十二支）の相性と、それらを選んだ目的に合わせた重みで合わせた総合点数を、1つのJSONレスポンスで受け取れます。四柱推命は、生まれた年・月・日・時から人を読み解く韓国の体系です。商品名は「相性」で、INTAアプリの相性画面と同じエンジンを使います。同じ入力ならいつも同じ結果です。

はじめにガイドプレイグラウンド料金

返すもの

四柱推命の相性 — 日柱の相性表（日柱は生まれた日の柱で、命式の中心です）、八字分析の点数、6つの軸（惹かれ合い・安定・成長・コミュニケーション・情熱・長続き）、五行の補い合い、通変星 (saju)
関係表 — 2人の命式のあいだの合・沖・刑・害・破を位置ごとにまとめたものと、その点数 (relations·p2Score)
星座の相性 — 太陽・月・アセンダントのサインと、選んだ目的に応じた天体の比較、あらかじめ書かれた解釈の段落（最大2つ） (astroSynastry·astroReadings)
干支の動物の相性 — 2人の干支の動物の地支がどう関係するかと、その等級 (tti)
総合点数 — 5つの点数を目的に応じた重みで合わせた0–100の点数 (headerBreakdown)
関係の段落 — 2人の日柱の組み合わせと関係の種類ごとに、あらかじめ書かれた2–3文 (categoryNarrative)

オプション

出生時刻はそれぞれ省略できます。 details・flow・MBTI のオプションは、追加料金なしで同じ呼び出しに加えられます。INTAアプリと同じ結果が必要な場合は、出生時刻がわかっている人ごとに出生国と exact を送ってください。

リクエスト例

オプション（details・flow・MBTI）を付けたリクエストボディです。

{
  "personABirthDate": "1990-05-15", "personABirthTime": "12:00", "personAGender": "male",
  "personBBirthDate": "1992-08-20", "personBBirthTime": "09:00", "personBGender": "female",
  "details": true, "flow": true, "date": "2026-10-10",
  "personAMbti": "ENFP", "personBMbti": "ISTJ"
}

認証は X-Partner-Api-Key ヘッダーで行い、ベースURLは https://api.hrum.ai/api/v1/partners/v1です。Python と JavaScript の例、エラー処理ははじめにガイドにあります。

レスポンス例（抜粋）

{
  "success": true,
  "data": {
    …
    "saju": {
      "purpose": "yeonae_attraction",
      "hourKnown": { "a": true, "b": true },
      "personA": { "ilju": "임신" },
      "personB": { "ilju": "병인" },
      "score": { "total": 59, "grade": "맞춰 가면 좋아요",
                 "breakdown": { "ilju": 53, "authority": 65, "eightChar": 65 } },
      "axes": { "attraction": 25, "stability": 59, "growth": 58,
                "communication": 24, "passion": 74, "longevity": 65 },
                …

A（男性、1990-09-04 14:30）とB（女性、1992-02-20 10:15）を恋愛の目的で送ったときの、レスポンスの四柱推命の相性部分の冒頭です。レスポンス全体とフィールドの説明はリファレンスにあります。

料金

相性は1回 ₩20 です（VAT別、VAT込み ₩22）。成功した呼び出しだけがプリペイドのクレジットから差し引かれ、4xx・5xx のエラーレスポンスは課金されません。

一度受け取った結果は保存して再利用してください。 同じリクエストをもう一度送ると、また課金されます。同じ生年月日時と同じオプションならいつも同じ結果なので、最初のレスポンスをデータベースに保存し（例：リクエストボディのハッシュをキーに）、以降は保存した値を無料で使ってください。今日の運勢のように日付で変わる結果は、日付をキーに含め、その日のあいだだけ再利用してください。

料金一覧

リファレンス全体

パラメータ表の全体、レスポンスフィールドの説明、エラーコードはリファレンスにあります: 相性API リファレンス。ほかの四柱推命商品は四柱推命APIすべてにあります。

お問い合わせ: contact@float.do · 運営: FLOAT Co., Ltd.