UDI 公開 API
UDI (統合偏差値) の値・ランク・パーセンタイル・年次トレンドを 非商用・read-only で取得できる JSON API を提供しています。個別模試の推定偏差値は一切含まれません。UDI 派生値のみを共通参照語彙として流通させる設計です。
Base URL https://jhs.udi-index.jp/api/v1 · 認証なし (anon) · CORS 全オリジン許可
エンドポイント
| Method | Path | 概要 |
|---|---|---|
| GET | /api/v1 | API メタ情報・利用可能エンドポイント一覧 |
| GET | /api/v1/schools 例: /api/v1/schools?region=tokyo&gender=boys&limit=10 | 学校の UDI 一覧 (降順)。region / gender / school_type / min_udi / max_udi / tier / limit / offset でフィルタ可 |
| GET | /api/v1/schools/{slug} 例: /api/v1/schools/kaisei | 個別校の UDI 詳細 (不確実性レンジ・年次トレンド・ランク) |
| GET | /api/v1/cohorts | 利用可能なランキング集計単位 (コホート) 一覧 |
| GET | /api/v1/cohorts/{cohort_id} 例: /api/v1/cohorts/tokyo-boys?limit=20 | コホート別ランキング |
全レスポンスに共通フィールド methodology / terms_url / disclaimer / as_of が含まれます。consumer 側はこれを必ず引用表示してください。
レスポンスに含まれる値
- UDI 値 (value)
- 推定の幅 (range_lower / range_upper) — is_floor=true のときは null（模試間が概ね一致しているため幅を提示しない）
- is_floor フラグ（SE がフロア値に張り付いているか）
- 信頼度ティア (A / B / C / D)
- 参照模試数 (exam_count)
- ランク・パーセンタイル (cohort 別)
- UDI 年次トレンド
- methodology バージョン
- 各模試の推定偏差値 (sapix / yotsuya / …)
- UDI 変換パラメータ (mean / sd)
- スコアの出典メタ (source_note / source_url)
- UDI 未算出の学校データ
レスポンス例
GET /api/v1/schools/kaisei{
"slug": "kaisei",
"name": "開成中学校",
"region": { "slug": "tokyo", "name": "東京都" },
"school_type": "private",
"gender": "boys",
"year": 2025,
"udi": {
"value": 68.4,
"range_lower": 65.1,
"range_upper": 71.8,
"is_floor": false,
"exam_count": 5,
"confidence_tier": "A"
},
"ranking": {
"all": { "cohort": "all", "rank": 2, "total": 854, "percentile": 0.233 },
"regional": { "cohort": "tokyo-all", "rank": 2, "total": 345, "percentile": 0.580 },
"gender": { "cohort": "tokyo-boys", "rank": 1, "total": 94, "percentile": 1.064 }
},
"trend": [
{ "year": 2023, "udi": 67.9, "delta": null },
{ "year": 2024, "udi": 68.2, "delta": 0.3 },
{ "year": 2025, "udi": 68.4, "delta": 0.2 }
],
"methodology": {
"version": "1.0",
"docs_url": "https://jhs.udi-index.jp/about/methodology"
},
"terms_url": "https://jhs.udi-index.jp/about/api",
"disclaimer": "※ 掲載値はすべて当サイトによる推定値・参考値です。公式値ではありません。",
"as_of": "2026-04-22"
}模試間が概ね一致して標準誤差がフロア値に張り付いている学校では、is_floor: true となり range_lower / range_upper は null で返ります。consumer 側はレンジを表示せず、 exam_count 模試で値が概ね一致している旨を肯定的に提示してください（例: 「N 模試で概ね一致」）。
利用規約
本 API の利用をもって以下の規約に同意したものとみなします。
- §01非商用用途に限る個人・研究・教育目的・ニュース報道・塾/学校の内部資料など、非商用の参照用途に限って利用いただけます。広告収益を主目的とするコピーサイト・アプリへの組み込みはお断りします。
- §02出典・リンクの明示UDI 値を公開する場所では、UDI の定義と本サイト (udi.example.com/about/udi) への出典リンクを必ず明示してください。API レスポンスに含まれる methodology.docs_url を参照するのが確実です。
- §03推定値である旨の表記数値を表示する際は「推定値」「参考値」「site estimate」などの注記を必ず添えてください。公式値と誤認される表記は禁止します。
- §04キャッシュ上限取得した値をクライアント側でキャッシュする場合の保持期限は 24 時間以内としてください。それ以上は再取得によりメソドロジーのバージョン変更に追随してください。
- §05模試値の逆算・公開の禁止UDI 値・UDI パラメータから各模試の推定偏差値を逆算し、逆算結果を公開することは禁止します。本 API は UDI 派生値のみを公開する設計であり、個別模試値の代替流通経路として利用することはできません。
- §06全件ダンプの禁止limit は最大 100 件。全件取得を目的とした連続アクセスやデータベース化は行わないでください。日次バックアップ的な再取得は週 1 回程度までを目安に。
- §07提携・監修関係の不存在本 API の提供は、特定の模試会社・学校・塾・出版社との提携・監修・公認関係を意味しません。利用者が第三者に対してそのような関係を暗示する表記・広告を行うことを禁じます。
収集情報とプライバシー
本 API を呼び出すと、レート制限・アクセス解析・不正利用検知の目的で以下の情報を取得・保管します。取得時点で本規約および本項目への同意があったものとみなします。
| 項目 | 内容 | 備考 |
|---|---|---|
| IP アドレス（ハッシュ化） | ソルト付き SHA-256 (16進64桁) | サーバ側でソルト付きハッシュ化したのち保管。生 IP は処理スコープ外に出さず、DB・ログには記録しません。レート制限と不正利用検知のキーとして使用 |
| User-Agent | 先頭 256 文字 | クライアント種別の集計用。それ以降は切り捨て |
| Referer | 先頭 512 文字 | 流入元の集計用。切り捨て規則同じ |
| リクエストパス | /api/v1/… の path | クエリ文字列は許可キーのみ記録 (region / gender / school_type / tier / min_udi / max_udi / limit / offset) |
| クエリパラメータ | 上記ホワイトリストのみ JSONB で保管 | 任意キー・自由入力・認証情報の保管は行わない |
| タイムスタンプ | リクエスト受信時刻 (UTC) | — |
| レスポンスステータス / 応答時間 | HTTP status と処理ミリ秒 | パフォーマンス監視・エラー検知用 |
なお本サイトの 学校一覧・比較等の通常ページ閲覧時には、ホスティング事業者 (Vercel Inc.) によるアクセスログが別途記録されます。本項目は API 呼び出し時の収集情報に限定した開示です。
バージョニング方針
本 API は /api/v1 を安定版として提供します。後方互換を損なう変更は新しい major バージョン /api/v2 で提供し、旧版は 6 ヶ月以上並行稼働させます。フィールドの追加 (non-breaking) は予告なく行います。
メソドロジーの改訂は 算出方針ページ で履歴を開示しています。各レスポンスの methodology.version を参照することで、値がどの方針バージョン下で算出されたかを特定できます。