学校コードAPI リファレンス

エンドポイント一覧この見出しへのリンク

共通仕様この見出しへのリンク

GET /v1/school/{学校コード}(学校コード検索)この見出しへのリンク

パスパラメータこの見出しへのリンク

curl サンプルこの見出しへのリンク

curl -H "Authorization: Token YOUR_API_KEY" \
  https://api.kenall.jp/v1/school/F113110102700

レスポンス例この見出しへのリンク

{
  "version": "2024-08-28",
  "data": {
    "code": "F113110102700",
    "type": "F1",
    "jurisdiction_prefecture_code": "13",
    "establishment_type": 1,
    "branch": 1,
    "name": "東京大学",
    "address_raw": "東京都文京区本郷７－３－１",
    "addresses": [
      {
        "postal_code": "1130033",
        "jisx0402": "13105",
        "prefecture": "東京都",
        "prefecture_kana": "トウキョウト",
        "prefecture_roman": "Tokyo",
        "city": "文京区",
        "city_kana": "ブンキョウク",
        "city_roman": "Bunkyo-ku",
        "street_number": "本郷7-3-1",
        "town": "本郷",
        "kyoto_street": null,
        "block_lot_num": "7-3-1",
        "building": null,
        "floor_room": null
      }
    ],
    "established_date": "2021-01-20",
    "abolished_date": null,
    "school_survey_number": "0172",
    "new_code": []
  }
}

GET /v1/school/?q=… (学校情報検索)この見出しへのリンク

与えられた検索クエリを元に、該当する学校情報リソースを取得します。学校コード検索と異なり、レスポンスの data が配列になる点にご注意ください。

curl サンプルこの見出しへのリンク

# 学校名で検索
curl -H "Authorization: Token YOUR_API_KEY" \
  "https://api.kenall.jp/v1/school/?q=name:東京大学"
 
# 学校名 × 地域ファセット
curl -H "Authorization: Token YOUR_API_KEY" \
  "https://api.kenall.jp/v1/school/?q=name:東京大学&facet_area=/東京都"

レスポンス例 (検索)この見出しへのリンク

{
  "version": "2024-08-28",
  "data": [
    { ... },
    { ... },
    { ... }
  ],
  "query": "name:...",
  "count": 3,
  "offset": 0,
  "limit": 100,
  "facets": {
    "area": [
      ["/東京都", 2]
    ],
    "type": [
      ["/大学", 1],
      ["/中等教育学校", 1]
    ],
    "establishment_type": [
      ["/公立", 2]
    ],
    "branch": [
      ["/本校", 2]
    ]
  }
}

レスポンス・トップレベル (検索)この見出しへのリンク

facets オブジェクトの内訳は以下の通りです。

クエリパラメータこの見出しへのリンク

検索クエリの仕様この見出しへのリンク

• 部分一致検索のみ行います。
• 検索ワードは一つ以上の半角スペース・タブ・改行文字で区切ります。
• 検索ワードの間に AND / OR を挟むと、「かつ」「もしくは」といった条件で検索できます。キーワードがない場合は OR として扱われ BM25 スコアで順位付けされます (短いテキストが対象のため全ワード一致が実質 AND と同等の結果になります)。
• 特定の項目のみを対象に検索したい場合は、項目名:キーワード の形式を使います (例: 学校名に「東京大学」を含む → name:東京大学)。
• 特定のファセット階層以下を対象にしたい場合は _facet_area:/東京都 のように指定します。

クエリの実行例この見出しへのリンク

• 東京大学 を検索: https://api.kenall.jp/v1/school/?q=東京大学
• 学校名に東京大学を含み、かつ都道府県が東京都の学校を1件だけ検索: https://api.kenall.jp/v1/school/?q=name:東京大学 AND prefecture_code:13&limit=1
• 学校種が大学で、かつ学校名に東京大学を含む学校を検索: https://api.kenall.jp/v1/school/?q=name:東京大学 AND type:F1

検索対象フィールドこの見出しへのリンク

検索クエリ (q) で項目指定できるフィールドは以下の通りです。

検索クエリの正規化この見出しへのリンク

学校情報APIは検索キーワードを正規化します。これにより、入力文字列のフォーマットを整える必要なく必要なレコードを取得できます。正規化されるフィールドは name / postal_code / jisx0402 / prefecture_code / address_raw / type です。

正規化ルールこの見出しへのリンク

• 全角・半角の正規化: 検索時には全角・半角を区別しません (例: 半角カナ ｻｲﾊﾞｰ大学 → サイバー大学 を検索)。
• かな小文字・大文字の正規化: どちらでも入力可能です (例: キヨウトフ → キョウトフ・キヨウトフ のどちらかを含むレコードを検索)。
• 歴史的仮名遣いの正規化: ゐ・ゑ はそれぞれ い・え と区別しません (例: ゐろはにほへと → ゐろはにほへと・いろはにほへと のどちらかを検索)。
• 旧字体・非標準文字の正規化: 旧字体や非標準文字は新字体と区別しません。詳細は下記を参照してください。

旧字体・非標準文字の正規化この見出しへのリンク

学校コードAPIは、旧字体や非標準文字による検索に対応しています。例えば非JIS漢字である 學 で検索した場合、常用漢字の 学 を検索します。

• (例) 大學 → 大学 あるいは 大學 を含むレコードを検索する。
• (例) 国学院大学 → 國學院大學 を検索する。

一部未対応の漢字もあります。制限事項 も参照してください。

ファセットこの見出しへのリンク

ファセットのパス名は必ず / で始まり、各階層は / で区切られます。ルート階層は / で表されます。学校コードのファセットは以下の4種類です。

• 地域ファセット (facet_area): 都道府県や市区町村を表す。/{都道府県} または /{都道府県}/{市区町村} (例: /東京都/千代田区)
• 都道府県ファセット (facet_prefecture): jurisdiction_prefecture_code に基づく都道府県。/ または /{都道府県} (例: /東京都)
• 学校種ファセット (facet_type): / / /幼稚園 / /幼保連携型認定こども園 / /小学校 / /中学校 / /義務教育学校 / /高等学校 / /中等教育学校 / /特別支援学校 / /大学 / /短期大学 / /高等専門学校 / /専修学校 / /各種学校
• 設置区分ファセット (facet_establishment_type): / / /国立 / /公立 / /私立
• 本分校ファセット (facet_branch): / / /本校 / /分校 / /廃止

レスポンスフィールドこの見出しへのリンク

トップレベルこの見出しへのリンク

data オブジェクトのフィールド仕様 (12フィールド)この見出しへのリンク

addresses 配列内のサブレコード (14フィールド)この見出しへのリンク

学校所在地をケンオールで正規化したサブレコードです。street_number (町域以下の住所) が town / kyoto_street / block_lot_num / building / floor_room に分解されます。存在しない要素は空文字あるいは null になります。

HTTPステータス・エラーこの見出しへのリンク

SDK で呼び出すこの見出しへのリンク

JavaScript SDKこの見出しへのリンク

import { KENALL } from '@ken-all/kenall';
const api = new KENALL('YOUR_API_KEY');
 
const result = await api.getSchool('F113110102700');
console.log(result.data.name);              // => 東京大学
console.log(result.data.addresses[0].city); // => 文京区

条件検索 (searchSchool) も利用できます:

const results = await api.searchSchool({ q: '東京大学' });
console.log(results.data.length); // => ヒット件数

Pythonこの見出しへのリンク

import os, requests
res = requests.get(
    "https://api.kenall.jp/v1/school/F113110102700",
    headers={"Authorization": f"Token {os.environ['KENALL_API_KEY']}"},
    timeout=10,
)
data = res.json()["data"]
print(data["name"], data["addresses"][0]["city"])

このAPIに関する技術FAQこの見出しへのリンク

OpenAPI スキーマこの見出しへのリンク

OpenAPI スキーマ (YAML): 2024-01-01 / 2025-01-01

関連リファレンスこの見出しへのリンク

• ⚠️ 既知の問題 (このAPIに該当する制約・破壊的変更)
• API共通仕様
• 郵便番号→住所API — 学校所在地の正規化に併用

最終更新: 2026-07-15