相容性スコア¶

相容性スコアは、2人の人物（ライフパス、心の願い、性格など）の9つの主要な数字を分析し、以下の情報を返します。

個別の数秘術プロファイル
ペアごとの相容性スコア
重み付けされた総合スコア (0–100)
人間関係に関する洞察

デート、結婚、ビジネス、または友情の分析に最適です。 マスターナンバー: 11, 22, 33 を完全にサポート。

エンドポイント¶

メソッド	パス
`GET`	`https://api.numerologyapi.com/api/v1/compatibility-score`
`POST`	`https://api.numerologyapi.com/api/v1/compatibility-score`

注意

POST uses same path as GET — no /post suffix.

必要なヘッダー¶

X-API-Key: YOUR_API_KEY
Host: api.numerologyapi.com
Content-Type: application/json (POSTのみ)

数秘術APIダッシュボードで API キーを作成および管理します。

パラメータ¶

人物 1¶

パラメータ	タイプ	必須	説明
`first_name_1`	文字列	はい	姓
`middle_name_1`	文字列	いいえ	中間名(複数)
`last_name_1`	文字列	はい	名
`dob_1`	文字列	はい	生年月日 (`YYYY-MM-DD` で指定)
`num_sys`	文字列	いいえ	オプションの数秘術システム。対応する値: `pythagorean`, `chaldean`, `vedic`。デフォルトは `pythagorean`

人物 2| パラメータ | 型 | 必須 | 説明 |¶

|---|---|---|---| | first_name_2 | 文字列 | はい | 姓 | | middle_name_2 | 文字列 | いいえ | 名 (複数) | | last_name_2 | 文字列 | はい | 芸名 | | dob_2 | 文字列 | はい | 生年月日をYYYY-MM-DDに指定 |

| language | 文字列 | はい | レスポンスの言語コード。サポートされる値は、en, es, de, fr, pt などです。 | | lang | 文字列 | はい | language のエイリアス。language または lang を使用します。 |

レスポンスをローカライズするために、オプションのクエリパラメータ lang を追加します。サポートされる値: en, es, de, fr, pt。

サンプルリクエスト¶

GET リクエスト¶

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/compatibility-score?first_name_1=John&last_name_1=Doe&first_name_2=John&last_name_2=Doe&dob_1=1992-07-16&dob_2=1992-07-16&middle_name_1=&middle_name_2=&lang=en&num_sys=pythagorean" \
  --header "X-API-Key: YOUR_API_KEY"

POST リクエスト (JSON ボディ)¶

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/compatibility-score?lang=en" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "first_name_1": "John",
  "last_name_1": "Doe",
  "first_name_2": "John",
  "last_name_2": "Doe",
  "dob_1": "1992-07-16",
  "dob_2": "1992-07-16",
  "middle_name_1": "",
  "middle_name_2": "",
  "num_sys": "pythagorean"
}'

レスポンスの例¶

{
  "numerology_system": "pythagorean",
  "person_1": {
    "full_name": "John Doe",
    "initials": "JD",
    "dob": "1992-07-16",
    "life_path": 8,
    "heart_desire": 8,
    "personality": 9,
    "hidden_passion": [
      5,
      6
    ],
    "destiny_number": 8,
    "attitude_number": 5,
    "subconscious_self_number": 5,
    "balance_number": 5,
    "rational_thought_number": 9
  },
  "person_2": {
    "full_name": "John Doe",
    "initials": "JD",
    "dob": "1992-07-16",
    "life_path": 8,
    "heart_desire": 8,
    "personality": 9,
    "hidden_passion": [
      5,
      6
    ],
    "destiny_number": 8,
    "attitude_number": 5,
    "subconscious_self_number": 5,
    "balance_number": 5,
    "rational_thought_number": 9
  },
  "compatibility_scores": {
    "life_path_score": 80,
    "heart_desire_score": 80,
    "personality_score": 85,
    "hidden_passion_score": 95,
    "destiny_number_score": 80,
    "attitude_number_score": 95,
    "subconscious_self_score": 95,
    "balance_number_score": 95,
    "rational_thought_score": 85,
    "overall_score": 86.8,
    "overall_insight": "Very strong & harmonious connection. Your energies flow together with grace and mutual support. This is a relationship that feels like 'coming home' — powerful synergy with only gentle adjustments needed."
  },
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "ced3a432226491dc",
    "quota": "unlimited",
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "0.1.1",
    "endpoint_name": "compatibility_score",
    "endpoint_description": "Computes numerology compatibility score between two individuals.",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://docs.numerologyapi.com/",
    "response_timestamp": "2026-02-28T07:36:26.749083+01:00",
    "data_source": "Internal Engine / Astro Numerology Interpretation Engine (ANIE)",
    "cacheable_status": true,
    "report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
    "response_language": "en",
    "supported_languages": [
      "en",
      "es",
      "de",
      "fr",
      "pt"
    ],
    "notes": ""
  }
}

スコアリングアルゴリズム¶

互換性スコアリングアルゴリズムは、数理的な正確さと、数秘術の知恵を組み合わせた多層アプローチを使用します。

ルートナンバーのマッピング: すべての数字（マスターナンバー 11, 22, 33 を含む）は、対応するルート振動にマッピングされます (例: 11→2, 22→4, 33→6)。計算には、これらのルート値が互換性の評価に使用されます。2. 数理的なペアの定義: 数理において、強い相性を知られている特定の数値の組み合わせには、あらかじめ決められた基準スコアが割り当てられます。例えば： * (1, 5) and (5, 1): 85 (Adventure-driven combination)
- (1, 9) and (9, 1): 75 (Leadership meets humanitarianism)
- (2, 6) and (6, 2): 90 (Nurturing partnership)
代替計算: ペアが明示的に定義されていない場合、標準の公式を使用します：base_score = max(25, 100 - root_diff * 10)。これにより、最低限の互換性である25%を保証します。
マスターナンバーの共鳴ボーナス: マスターナンバーに関わるペアは、その根の値が同一（+15ポイント）または隣接している場合（+8ポイント）、精神的なエネルギーが強化されていることを反映して、追加のポイントを獲得します。
完全一致ボーナス: 元の数値（ルート削減前）が両方とも同一の場合、共有された振動の共鳴を認識して、+10ボーナスが付与されます。
最終計算: 合計スコアは、基本スコア、マスターボーナス、および完全一致ボーナスの合計であり、最大100%に制限されます。

スコアリングの重み¶

Factor	Weight
Life Path	1.4
性格	1.15
無意識の自己	0.85
---
全体スコア = 個別スコアの重み付き平均 + インテンシティファクター。
インテンシティファクター: 両方の人の「ライフパス」または「ハートの願い」がマスターナンバーである場合、潜在的な深い精神的つながりを反映して、わずかなボーナス (+5%まで) が適用されます。

全体洞察レベル¶

スコア	洞察
≥ 90	非常に高い魂レベルの一致
≥ 80	非常に強く調和のとれたつながり
≥ 70	強く、魂に沿った一致
≥ 60	堅実で有望な基盤
≥ 50	中程度でバランスの取れた可能性
≥ 40	挑戦的だが学習可能なダイナミック
≥ 25	低い自然な調和
< 25	非常に難しい一致

ダッシュボードを開く

注意

9 core numbers compared.
Hidden Passion: First dominant number used.
Master Numbers: Fully preserved (11, 22, 33).
Validation: Missing required fields → 400; Invalid date → 400.
Use Case: Dating apps, matchmaking, team building, marriage counseling.
Caching: Not specified — default behavior.