漢字API

漢字1字について、常用漢字かどうかと音訓、小学校の何年生で習うか、人名用漢字か（子の名前に使えるか）を返すAPIです。名づけで使える字を調べる、学年に合わせてふりがなが要る字を見つける、旧字体から今の字体を引く、といったことが手軽にできます。

できること

1字ごとの 常用漢字か・音訓（音／訓・1字下げの特別な音訓・送り仮名・例・習う学校段階）・旧字体（康熙字典体）・許容字体・学年（1〜6年）・中学校で習う字か・人名用漢字か（表(一)・表(二)）・コードポイント ／ 学年ごと・常用漢字・人名用漢字の一覧

収録

常用漢字 2136字（音訓 4388）と人名用漢字 864字の、あわせて 3000字

費用・登録

無料・登録不要・APIキー不要（提供条件は利用状況で変わることがあります）

出典

常用漢字表（平成22年内閣告示第2号）・学年別漢字配当表（平成29年文部科学省告示第63号）・戸籍法施行規則 別表第三（令和8年6月26日の「勒」の追加まで）。くわしくは出典と作り方

気をつけること

画数は入っていません（理由）。熟語の読みは取れません。名前に使えるかは目安で、最終的な判断は市区町村が行います。

データの版は /kanji/v1/meta.json で確認できます。

はじめかた（3ステップ）

1. ブラウザで開いてみる: https://api.shirugear.com/kanji/v1/漢.json を開くと、「漢」の情報が返ります。URLの字を調べたい字に変えるだけです（プログラムからは字を URLエンコードして /kanji/v1/%E6%BC%A2.json のように呼びます）。
2. 欲しい項目を取り出す: 常用漢字なら joyo に音訓など、学年は grade、人名用漢字なら jinmei に表の別が入っています。使い方の例にそのまま使えるコードがあります。
3. 利用規約を確かめる: 利用規約をご確認ください。登録や申し込みは要りません。

いろいろな言語から呼ぶ

サーバー側のプログラムやコマンドからも、URLを開くだけで使えます。字は UTF-8 で URLエンコードしてください（ほとんどの言語に関数があります）。

const ch = "委";
const res = await fetch("https://api.shirugear.com/kanji/v1/" + encodeURIComponent(ch) + ".json");
const k = await res.json();
console.log(k.grade, k.joyo.kun); // 3 [ "ゆだねる" ]

curl -s https://api.shirugear.com/kanji/v1/%E5%A7%94.json \
  | jq '{grade, on: .joyo.on, kun: .joyo.kun}'

<?php
$ch = '委';
$k = json_decode(file_get_contents('https://api.shirugear.com/kanji/v1/' . rawurlencode($ch) . '.json'), true);
echo $k['grade'], ' ', implode('・', $k['joyo']['kun']), "\n"; // 3 ゆだねる

import json
import urllib.parse
import urllib.request

ch = "委"
url = "https://api.shirugear.com/kanji/v1/" + urllib.parse.quote(ch) + ".json"
with urllib.request.urlopen(url, timeout=10) as res:
    k = json.load(res)
print(k["grade"], k["joyo"]["kun"])  # 3 ['ゆだねる']

その場で試す

URLの一覧と字の書き方

どれも、URLを開く（GET）だけで JSON（UTF-8）が返ります。先頭は https://api.shirugear.com です。自分のサイトのJavaScriptから直接呼べます（CORS対応）。

URLの字の書き方

• 字は UTF-8 で URLエンコードして入れます（「漢」なら %E6%BC%A2）。ブラウザのアドレス欄に /kanji/v1/漢.json と打てば、ブラウザがエンコードします。
• 1字だけです。熟語（2字以上）やひらがな・記号は 400 になります。
• 字はそのままの文字コードで調べます。見た目が同じでも文字コードが違う字（互換漢字）は別の字です。たとえば人名用漢字の「祐」（U+7950）と「祐」（U+FA4F）は、どちらも表(一)にあり、別々に引けます。Unicode の正規化（NFC など）をかけると互換漢字が別の字に変わるので、名前の字を調べるときは正規化せずに送ってください。
• 「𠮟」（U+20B9F）のように、4バイトの文字（サロゲートペア）になる字もあります。JavaScript の encodeURIComponent はそのまま正しく扱えます。

• 呼び出しは GET（または HEAD）だけです。独自のヘッダを付けずに呼んでください。

応答の例と各項目

応答の例（常用漢字）

GET https://api.shirugear.com/kanji/v1/%E5%A7%94.json

{
  "kanji": "委",
  "codepoint": "U+59D4",
  "joyo": {
    "order": 21,
    "kyujitai": [],
    "allowed_form": null,
    "on": ["イ"],
    "kun": ["ゆだねる"],
    "readings": [
      { "reading": "イ", "type": "on", "special": false, "stage": "小", "examples": ["委任", "委員", "委細"] },
      { "reading": "ゆだねる", "type": "kun", "special": false, "stage": "小", "okurigana": "ねる", "examples": ["委ねる"] }
    ],
    "jinmei_variants": []
  },
  "grade": 3,
  "school": "小学校",
  "name_ok": true,
  "jinmei": null,
  "data_version": "2026-11-04"
}

応答の例（人名用漢字）

GET https://api.shirugear.com/kanji/v1/%E4%BA%9E.json

{
  "kanji": "亞",
  "codepoint": "U+4E9E",
  "joyo": null,
  "grade": null,
  "school": null,
  "name_ok": true,
  "jinmei": { "table": 2, "same_as": null, "joyo_form": "亜" },
  "data_version": "2026-11-04"
}

1字の項目

joyo の各項目（常用漢字）

学年ごとの一覧（grade/{1〜6}.json）は {"grade", "count", "kanji": [{"kanji", "codepoint", "on", "kun"}], "data_version"}、常用漢字の一覧（joyo.json）は1件に grade・school・kyujitai も入ります。人名用漢字の一覧（jinmei.json）は1件に table・same_as・joyo_form が入ります。並びはどれも元の表の順です。

出典と作り方

データはすべて、国の告示・法令（著作権法13条により自由に使えるもの）から作っています。表の PDF から読み取る手順はスクリプトにして残し、件数が告示と合わなければ作り直しが止まるようにしています。

• 人名用漢字の表は、令和7年5月の改正で別表第二から別表第三に移りました。中身（字）は変わっていません。
• 人名用漢字表の PDF は字を文字コードで持っていない（字の画像）ため、字の画像を明朝体で描いた候補の字と照らし合わせて読み取り、決めきれない字は目で確かめました。候補には Unicode の文字データベース（Unihan の人名用漢字の印）を使い、表の字と1対1に対応すること・表(二)の括弧内の字が一致することを確かめています。
• 中間の表（TSV）と作り方のスクリプトは、シルギアの手元に置いています。

画数を入れていない理由

漢字の画数には、国が定めた公的な表がありません。常用漢字表にも人名用漢字の表にも画数は載っておらず、同じ字でも辞書や字形によって数え方が違うことがあります（しんにゅう・くさかんむりなど）。出典をはっきりさせられないため、このAPIには入れていません。

送り仮名（okurigana）の決め方

常用漢字表の音訓欄は「ゆだねる」のように平仮名だけで書かれていて、送り仮名の区切りは示されていません。そこで、同じ表の例欄（「委ねる」）から、字のすぐ後に続く平仮名を見て決めています。「確かだ」の「たしか」は「か」、例が字1字だけ（「嵐」）なら送り仮名なし（""）です。例から決められない訓（「異にする」「異なる」の「こと」など）は null にしています。送り仮名の正式な付け方は「送り仮名の付け方」（昭和48年内閣告示第2号）をご覧ください。

「中学校」の字について

学年別漢字配当表に無い常用漢字（1110字）は school を "中学校" にしています。中学校学習指導要領では、配当表以外の常用漢字の大体を読むことになっているためです。音訓ごとの段階（stage）は別に、割り振り表の小・中・高を返します（小学校で習う字でも、特別な音訓は高校になることがあります）。

使い方の例

どの例も、ブラウザの JavaScript（フレームワーク不要）で動きます。一度取った字は覚えておき、同じ字では呼び直しません。

名づけで使える字か調べる

const API = "https://api.shirugear.com/kanji/v1/";
const cache = new Map();

// 漢字1字の情報。常用漢字・人名用漢字に無い字は null
function kanjiOf(ch) {
  if (!cache.has(ch)) {
    const p = fetch(API + encodeURIComponent(ch) + ".json").then((res) => {
      if (res.status === 404) return null;
      if (!res.ok) throw new Error("HTTP " + res.status);
      return res.json();
    });
    p.catch(() => cache.delete(ch)); // 失敗したら次は取り直す
    cache.set(ch, p);
  }
  return cache.get(ch);
}

// 名前の字のうち、使えない字を返す（ひらがな・カタカナ・ー・ゝゞヽヾ々 は使える）
async function unusableChars(name) {
  const bad = [];
  for (const ch of name) {
    if (/^[ぁ-ゔァ-ヴーゝゞヽヾ々]$/.test(ch)) continue;
    const k = await kanjiOf(ch);
    if (!k) bad.push(ch);
  }
  return bad;
}

console.log(await unusableChars("凜太郎")); // []
console.log(await unusableChars("鮃太"));   // ["鮃"]

「使える」は戸籍法施行規則の字の範囲に入っているかどうかです。読み方の決まりなど、最終的な判断は出生届を出す市区町村が行います。

学年に合わせて、ふりがなが要る字を見つける

その学年までに習う字を学年ごとの一覧から集め、文章の中のそれ以外の漢字に印を付けます。学年のファイルは6つだけなので、まとめて取っておけます。

// grade 年生までに習う字の集合
async function learnedUpTo(grade) {
  const lists = await Promise.all(
    [1, 2, 3, 4, 5, 6].filter((g) => g <= grade).map((g) =>
      fetch("https://api.shirugear.com/kanji/v1/grade/" + g + ".json").then((res) => res.json())
    )
  );
  return new Set(lists.flatMap((l) => l.kanji.map((k) => k.kanji)));
}

const learned = await learnedUpTo(3);
const text = "委員会で議論を重ねる";
const needRuby = [...text].filter((ch) => /\p{Script=Han}/u.test(ch) && !learned.has(ch));
console.log(needRuby); // ["議", "論"]（議・論は4年生以降）

このAPIが返すのは1字ごとの音訓です。熟語の読み（「委員」＝いいん）は返さないので、ふりがなの文字そのものは辞書などで決めてください。

旧字体から今の字体を引く

const k = await kanjiOf("惡"); // 上の例の kanjiOf
if (k && k.jinmei && k.jinmei.joyo_form) {
  console.log(k.jinmei.joyo_form); // "悪"（惡 は人名用漢字 表(二)。名前にも使える）
}

表(二)に無い旧字体は 404 になります。常用漢字の側から旧字体を見るときは joyo.kyujitai（康熙字典体）を、名前に使える異体字を見るときは joyo.jinmei_variants を使ってください。

エラー

うまくいかないときは、HTTPの状態コードと、次の形の JSON を返します。code は固定の値なので、プログラムで見分けるときはこれを使ってください（message は説明文で、言い回しが変わることがあります）。

{"error":{"status":404,"code":"kanji_not_found","message":"この字は常用漢字にも人名用漢字にもありません。調べられるのは、常用漢字2136字と人名用漢字864字です。"}}

通信できない・サーバーが止まっているときは、JSON が返らないことがあります。fetch の失敗（例外）も受け止めてください。

データの更新・キャッシュ・呼び出し回数

• 作り方: 告示・法令の表から前もって作った静的なファイルを返します。サーバーで組み立ててはいません。
• 中身が変わるとき: 常用漢字表・学年別漢字配当表の改定や、人名用漢字の追加（戸籍法施行規則の改正）があったときと、誤りを直したときだけです。人名用漢字は、裁判で認められた字がときどき追加されます（直近は2017年の「渾」と2026年の「勒」）。
• データの版（data_version）: 元の表が変わった日付です（例: "2026-11-04"）。/kanji/v1/meta.json には出典と件数も入っています。
• キャッシュ: 応答は1日（エラーは1時間）キャッシュしてかまいません。中身はめったに変わらないので、アプリの中に長く持っておいてもかまいません。ETag／Last-Modified に対応しているので、変わっていなければ 304 が返ります。
• 呼び出し回数の目安: 決まった上限はありませんが、1つの利用元から1秒あたり10回程度までにしてください。たくさんの字を扱うときは、1字ずつ呼ばずに一覧（joyo.json・jinmei.json・grade/{1〜6}.json）を一度取って使い回してください。

変更の方針と更新履歴

• v1 の中では、項目を足すことはあっても、今ある項目の名前や意味は変えません。知らない項目が増えていても無視するように作ってください。
• 人名用漢字の追加や誤りの修正は、同じ v1 のまま値を直します。そのときはこのページの更新履歴でお知らせします。
• 互換性のない変更は、URLの版を分けて（/kanji/v2/ など）行います。v1 を終わらせるときは、できるかぎり6か月以上前にこのページでお知らせします。
• 提供条件（無料・登録不要・アクセス回数の上限など）は、利用状況に応じて変えることがあります（利用規約第4条）。

更新履歴

2026年11月

公開。人名用漢字は令和8年法務省令第43号（2026年6月26日施行・「勒」の追加）まで反映。

機械で読める仕様（型定義・OpenAPI）

• TypeScript の型定義: /kanji/types.d.ts
• OpenAPI 3.1: /kanji/openapi.json（コード生成やテストに使えます）

用語の説明

よくある質問

ご利用にあたって

ご利用の前に利用規約をご確認ください。データの正確さや、止まらないことは保証していません。公式の表を確かめたいときは、文化庁の常用漢字表、法務省の人名用漢字の案内のページをご覧ください。ご質問・不具合のご連絡は、シルギアのお問い合わせ窓口から、件名に「API」と入れてお送りください。