住所の表記をそろえるAPI

「東京都千代田区一番町1-2-3」「千代田区一番町一丁目」「東京千代田区霞ヶ関2丁目1番2号」のような住所の書き方の違いを、郵便番号データの正式な書き方にそろえて返すAPIです。都道府県・市区町村・町域・丁目・番地・建物名に分け、郵便番号と市区町村コードも一緒に返します。

できること
住所の書き方をそろえる / 都道府県・市区町村・町域・丁目・番地・建物名に分ける / 郵便番号と市区町村コード(5桁・検査数字付き6桁)を出す / 都道府県名・郡名・区名を省いた住所を補う
費用・登録
無料・登録不要・APIキー不要(提供条件は利用状況で変わることがあります)
向いている用途
会員・顧客の住所データで重複を見つける・名寄せする、入力フォームで住所の書き方を統一する、住所の一覧に郵便番号や市区町村コードを付ける
気をつけること
番地・建物名が実在するかは確かめません(郵便番号データに番地は無いため)。かな書きの町名(かすみが関 など)は対象外です。止まらないことは保証していません。

データ: 日本郵便の郵便番号データ(郵便番号APIと同じもの・毎月更新)。応答の data_version で、いつの版か確かめられます。

はじめかた(3ステップ)

  1. ブラウザで開いてみる: https://api.shirugear.com/address/v1/normalize.json?q=東京都千代田区一番町1-2-3 を開くと、そろえた住所と、都道府県・市区町村・町域などに分けた結果が返ります。q= のあとを調べたい住所に変えるだけです。
  2. 結果の段階を確かめる: level が 3 なら町域(町名)まで見つかっています。0〜2 のときは途中までしか分かっていないので、candidates(候補)や rest(残りの部分)を見て、入力を見直してもらうなどしてください。見つかった段階に詳しく書いています。
  3. 利用規約を確かめる: 利用規約をご確認ください。登録や申し込みは要りません。

いろいろな言語から呼ぶ

住所は URLエンコードして q に入れてください(ほとんどの言語に関数があります)。どの例も「千代田区一番町一丁目」をそろえます。

const q = "千代田区一番町一丁目";
const res = await fetch("https://api.shirugear.com/address/v1/normalize.json?q=" + encodeURIComponent(q));
const a = await res.json();
if (a.level === 3) {
  console.log(a.normalized, a.zipcode); // → 東京都千代田区一番町1丁目 1020082
} else {
  console.log("町名まで見つかりませんでした", a.candidates);
}
curl -sG https://api.shirugear.com/address/v1/normalize.json \
  --data-urlencode "q=千代田区一番町一丁目"

# そろえた住所だけを出す(jq を使う場合)
curl -sG https://api.shirugear.com/address/v1/normalize.json \
  --data-urlencode "q=千代田区一番町一丁目" | jq -r '.normalized'
<?php
$q = '千代田区一番町一丁目';
$url = 'https://api.shirugear.com/address/v1/normalize.json?q=' . rawurlencode($q);
$a = json_decode(file_get_contents($url), true);
echo $a['level'] === 3 ? "{$a['normalized']}(〒{$a['zipcode']})\n" : "町名まで見つかりませんでした\n";
import json
import urllib.parse
import urllib.request

q = "千代田区一番町一丁目"
url = "https://api.shirugear.com/address/v1/normalize.json?q=" + urllib.parse.quote(q)
with urllib.request.urlopen(url, timeout=10) as res:
    a = json.load(res)
print(a["normalized"], a["zipcode"])  # → 東京都千代田区一番町1丁目 1020082

その場で試す

住所の表記をそろえる

試しに:

項目結果

URLと指定のしかた

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

URL返すもの
/address/v1/normalize.json?q={住所}そろえた住所と、都道府県・市区町村・町域・丁目・番地・建物名に分けた結果、郵便番号・市区町村コード。1件 約0.5KB。中身

応答の中身

応答の例

GET https://api.shirugear.com/address/v1/normalize.json?q=東京都千代田区一番町1-2-3

{
  "input": "東京都千代田区一番町1-2-3",
  "level": 3,
  "normalized": "東京都千代田区一番町1-2-3",
  "prefecture": "東京都",
  "prefecture_kana": "トウキョウト",
  "prefcode": "13",
  "city": "千代田区",
  "city_kana": "チヨダク",
  "jiscode": "13101",
  "lgcode": "131016",
  "town": "一番町",
  "town_kana": "イチバンチョウ",
  "street": null,
  "chome": null,
  "banchi": "1-2-3",
  "building": null,
  "rest": null,
  "zipcode": "1020082",
  "zipcodes": [{ "zipcode": "1020082", "note": null }],
  "candidates": [],
  "data_version": "2026-10"
}

各項目

項目はいつも全部そろって返ります。分からない項目は null(配列は空の [])です。

項目型内容
input文字列受け取った住所。全角の英数字・記号を半角にし、前後の空白と先頭の郵便番号を外したもの
level数値どこまで見つかったか。0=見つからない(または決まらない)、1=都道府県まで、2=市区町村まで、3=町域まで。見つかった段階
normalized文字列 または nullそろえた住所。level が 3 なら「都道府県+市区町村+(通り名)+町域+丁目+番地」に、建物名などを半角の空白1つで続けます。1・2 のときは、分かったところまでに残りの部分をそのまま続けます。0 のときは null
prefecture・prefecture_kana文字列 または null都道府県名と読み(カタカナ)
prefcode文字列 または null都道府県コード(2桁。例: "13")
city・city_kana文字列 または null市区町村名と読み(カタカナ)。郡や政令指定都市の区を含む書き方です(例: "西多摩郡奥多摩町"・"横浜市中区")
jiscode文字列 または null市区町村コード(5桁。全国地方公共団体コードの検査数字を除いたもの)
lgcode文字列 または null検査数字付きの6桁の地方公共団体コード。地方公共団体コードAPIで引けます
town・town_kana文字列 または null町域名と読み(郵便番号データの書き方。読みは全角のカタカナで、数字が全角のこともあります)。町域が見つからないときは null
street文字列 または null京都市の通り名(例: "河原町通二条下る")。ほかの住所では null
chome数値 または null丁目の数。「1丁目」「一丁目」のように丁目と書いてあるときだけ入ります
banchi文字列 または null番地・号を半角の数字と - でつないだもの(例: 「1番2号」→ "1-2"、「1-2-3」→ "1-2-3")
building文字列 または null番地のあとに残った部分(建物名・部屋番号など)。中身は確かめません
rest文字列 または null町域が見つからなかったときの、残りの部分(level が 3 のときは null)
zipcode文字列 または null郵便番号(7桁)。1つに決まったときだけ入ります。郵便番号の選び方
zipcodes配列その町域の郵便番号すべて。zipcode(7桁)と note(「1〜19丁目」などの郵便番号データの但し書き。無ければ null)
candidates配列市区町村が1つに決まらないときの候補。prefecture・city・jiscode
data_version文字列郵便番号データの版(取り込んだ日本郵便の月次データの年月。例: "2026-10")

見つかった段階(level)

level意味例
3町域(町名)まで見つかった。town と zipcodes が入ります「横浜市山下町279」→ 神奈川県横浜市中区山下町279
2市区町村まで見つかったが、町域が見つからない。残りは rest に入ります「東京都千代田区かすみが関」→ 千代田区まで(rest は「かすみが関」)
1都道府県まで見つかった。市区町村の候補が同じ都道府県の中に複数あるときは candidates に入ります「東京都あいうえお」→ 東京都まで(rest は「あいうえお」)
0見つからない。または、都道府県をまたいで候補があり決まらない(candidates に入ります)「府中市」→ 東京都府中市と広島県府中市が候補

「府中市」のように同じ名前の市区町村が複数あるときは、都道府県名から書いてもらうと決まります(「東京都府中市宮町1丁目」なら level 3)。

そろえ方のきまり

同じものとして照らし合わせる違い

次の違いは、郵便番号データと照らし合わせるときに同じものとして扱います。返す名前は、いつも郵便番号データの正式な書き方です(「霞ヶ関」と書いても town は「霞が関」)。

省いてもよいもの

丁目・番地・建物名の分け方

京都市の通り名

京都市の「河原町通二条下る」のような通り名を含む住所は、町名を住所の途中から探します。「京都市中京区河原町通二条下る一之船入町537」なら、street が「河原町通二条下る」、town が「一之船入町」、banchi が "537" です。

郵便番号の選び方

1つの町域に郵便番号が1つだけなら、それを zipcode に入れます。丁目や番地で郵便番号が分かれている町域では、次の順に選びます。

  1. 郵便番号データの但し書き(zipcodes の note)が「1〜19丁目」「1、3番地」のような範囲なら、chome(丁目の範囲のとき)や banchi の最初の数(番地の範囲のとき)と照らし合わせます。例: 「北海道札幌市中央区北一条西二丁目」→ 0600001(但し書き「1〜19丁目」)、「札幌市中央区北1条西20丁目」→ 0640821(「20〜28丁目」)。
  2. 高層ビルの階ごとの郵便番号(但し書きに「◯階」とあるもの)は選びません。
  3. それでも1つに決まらなければ null にします。そのときも zipcodes に町域の郵便番号がすべて入っているので、利用者に選んでもらうなどしてください。

丁目で郵便番号が分かれる町域では、「北1条西2-3」のように丁目と書いていない住所は丁目が分からないため、zipcode は null になります。

できないこと・注意

入力した住所の扱い

入力した住所は、シルギアの利用の記録には残しません(記録するのは URL のパス /address/v1/normalize.json だけで、?q= 以降は残しません)。ただし、サーバー会社の標準のアクセスログには URL が一定期間残ります。

エラー

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

{"error":{"status":400,"code":"invalid_query","message":"住所の指定が正しくありません。q に住所を200文字以内で指定してください(…)。"}}
状態codeいつ
400invalid_queryq が無い・空・200文字を超える(先頭の郵便番号だけの場合も空とみなします)
404not_found/address/v1/ の下の normalize.json 以外のURL
403region_not_allowed日本国内以外から呼んだ(データは日本国内からのアクセスに限っています。説明ページは海外からも見られます)
405method_not_allowedGET / HEAD 以外で呼んだ

住所が見つからないときはエラーではなく、200 で level が 0 の応答を返します。

データの出典・更新・キャッシュ

変更の方針と更新履歴

更新履歴

2026年11月20日
公開。

機械で読める仕様(型定義・OpenAPI)

このデータを使っているツール

シルギアの次のツールは、このAPIと同じデータで動いています。APIの答えを画面で確かめたいときや、使い方のイメージをつかみたいときにどうぞ。

このAPIと同じデータから作ったツール

よくある質問

本当に無料ですか?登録は必要ですか?

現在は無料で、登録やAPIキーも要りません。個人・法人、営利・非営利を問わず使えます。ただし利用状況に応じて提供条件を変えることがあり、そのときはできるかぎりこのページでお知らせします。

入力した住所は記録されますか?

入力した住所は、シルギアの利用の記録には残しません(記録するのは URL のパス /address/v1/normalize.json だけで、?q= 以降は残しません)。ただし、サーバー会社の標準のアクセスログには URL が一定期間残ります。

番地が実在するかも確かめられますか?

確かめられません。もとにしている郵便番号データには番地が無いため、番地や建物名は書き方をそろえて分けるだけです。町域(町名)までは郵便番号データと照らし合わせています。

「1-2-3」の最初の数は丁目になりますか?

なりません。最初の数が丁目か番地かは住所によって違うため、推測しません。「1丁目」と書いてあるときだけ chome に入れ、「1-2-3」は banchi にそのまま "1-2-3" として返します。

郵便番号が null になるのはどんなときですか?

町域が見つからないとき(level が 0〜2)と、町域に郵便番号が複数あって丁目・番地から1つに決まらないときです。後者のときも zipcodes に町域の郵便番号がすべて入っています。郵便番号から住所を出したいときは郵便番号APIをお使いください。

市区町村について、もっと詳しく知りたいときは?

応答の lgcode(または jiscode)を地方公共団体コードAPIに渡すと、名前・読み・種類や、廃止されたコードなら今のコードへのたどり方が分かります。

アクセス数に上限はありますか?

決まった上限はありませんが、目安として1つの利用元から1秒あたり10回程度までにしてください。同じ住所の結果は、取ったものを使い回してください。

ご利用にあたって

ご利用の前に利用規約をご確認ください。データの正確さや、止まらないことは保証していません。正式な住所・郵便番号は、日本郵便の郵便番号検索や各市区町村の案内でご確認ください。ご質問・不具合のご連絡は、シルギアのお問い合わせ窓口から、件名に「API」と入れてお送りください。