学校基本情報データセット・公開 API
全国 47 都道府県・5,088 校の学校基本情報を、出典へ戻れる形で公開しています。
一次資料 100%・出典明示 100%・商用サイトからの転載ゼロ
収録基準
学校公式 URL を確認できる学校と、学校・教育委員会・官公庁の一次資料へたどれる項目だけを収録します。 出典を確認できない項目は公開側へ出しません。
偏差値の編集推計は、数値だけを切り出した序列化を避けるため公開 API には含めません。 アプリ上では方法と限界の説明と組み合わせて扱います。
安定エンドポイント
- 全都道府県: /api/v1/schools.json
- 県別: /api/v1/schools/{prefecture}.json
- メタデータ: /api/v1/dataset.json
- 呼び方の定義(OpenAPI 3.1): /api/v1/openapi.json
いずれも静的 JSON です。検索条件付きリクエストや POST は提供しません。 互換性を壊す変更が必要な場合は /api/v2/ を新設し、/api/v1/ は維持します。
認証は不要で、CORS はすべての origin に開いています。ブラウザ上で動くプログラムからも そのまま読めます。各項目の型と収録条件は openapi.json と リポジトリの DATA.md にまとめています。
更新されたかを知る方法
データはビルドのたびに作り直します。更新の有無は、全件 JSON(22MB 前後)を 毎回ダウンロードしなくても判定できます。方法は 2 つあります。
メタデータの generated_at を見る
/api/v1/dataset.json は数 KB です。 この中の generated_at(ISO 8601)と school_count を 前回取得したときの値と比べれば、更新されたかどうかが分かります。 変わっていたときだけ本体を取り直す使い方を想定しています。 現在の値は 2026-09-01T05:49:29.506Z です。
ETag を使って条件付きで取得する
すべてのエンドポイントは ETag と Cache-Control: public, max-age=3600 を返します。 前回のレスポンスで受け取った ETag を If-None-Match ヘッダに付けて送ると、 中身が変わっていない場合は 304 Not Modified が本文なしで返ります。 22MB を転送せずに「変わっていない」ことを確認できます。
curl なら curl --etag-save etag.txt --etag-compare etag.txt https://manabi-map.app/api/v1/schools.json の形です。 多くの HTTP クライアントライブラリはこの往復を自動で行います。
更新の頻度は決めていません。学校データの追加・訂正があったときに作り直すため、 定期的に確認する場合は 1 日 1 回程度で十分です。
県別エンドポイント一覧
47 件すべてを列挙します。括弧内は収録校数です。
- 北海道: /api/v1/schools/hokkaido.json(295 校)
- 青森県: /api/v1/schools/aomori.json(68 校)
- 岩手県: /api/v1/schools/iwate.json(84 校)
- 宮城県: /api/v1/schools/miyagi.json(106 校)
- 秋田県: /api/v1/schools/akita.json(54 校)
- 山形県: /api/v1/schools/yamagata.json(60 校)
- 福島県: /api/v1/schools/fukushima.json(101 校)
- 茨城県: /api/v1/schools/ibaraki.json(131 校)
- 栃木県: /api/v1/schools/tochigi.json(85 校)
- 群馬県: /api/v1/schools/gunma.json(83 校)
- 埼玉県: /api/v1/schools/saitama.json(201 校)
- 千葉県: /api/v1/schools/chiba.json(199 校)
- 東京都: /api/v1/schools/tokyo.json(440 校)
- 神奈川県: /api/v1/schools/kanagawa.json(256 校)
- 新潟県: /api/v1/schools/niigata.json(115 校)
- 富山県: /api/v1/schools/toyama.json(54 校)
- 石川県: /api/v1/schools/ishikawa.json(62 校)
- 福井県: /api/v1/schools/fukui.json(38 校)
- 山梨県: /api/v1/schools/yamanashi.json(47 校)
- 長野県: /api/v1/schools/nagano.json(112 校)
- 岐阜県: /api/v1/schools/gifu.json(88 校)
- 静岡県: /api/v1/schools/shizuoka.json(141 校)
- 愛知県: /api/v1/schools/aichi.json(223 校)
- 三重県: /api/v1/schools/mie.json(82 校)
- 滋賀県: /api/v1/schools/shiga.json(59 校)
- 京都府: /api/v1/schools/kyoto.json(100 校)
- 大阪府: /api/v1/schools/osaka.json(242 校)
- 兵庫県: /api/v1/schools/hyogo.json(219 校)
- 奈良県: /api/v1/schools/nara.json(55 校)
- 和歌山県: /api/v1/schools/wakayama.json(52 校)
- 鳥取県: /api/v1/schools/tottori.json(33 校)
- 島根県: /api/v1/schools/shimane.json(48 校)
- 岡山県: /api/v1/schools/okayama.json(92 校)
- 広島県: /api/v1/schools/hiroshima.json(135 校)
- 山口県: /api/v1/schools/yamaguchi.json(81 校)
- 徳島県: /api/v1/schools/tokushima.json(41 校)
- 香川県: /api/v1/schools/kagawa.json(45 校)
- 愛媛県: /api/v1/schools/ehime.json(76 校)
- 高知県: /api/v1/schools/kochi.json(44 校)
- 福岡県: /api/v1/schools/fukuoka.json(170 校)
- 佐賀県: /api/v1/schools/saga.json(44 校)
- 長崎県: /api/v1/schools/nagasaki.json(82 校)
- 熊本県: /api/v1/schools/kumamoto.json(78 校)
- 大分県: /api/v1/schools/oita.json(55 校)
- 宮崎県: /api/v1/schools/miyazaki.json(51 校)
- 鹿児島県: /api/v1/schools/kagoshima.json(91 校)
- 沖縄県: /api/v1/schools/okinawa.json(70 校)
ライセンスと出典表記
データは CC BY-SA 4.0 です。 利用・再配布時は「出典: Manabi Map(まなびマップ) https://manabi-map.app (CC BY-SA 4.0)」と表記してください。
訂正窓口
掲載情報の削除・訂正は takedown@manabi-map.app へお知らせください。