詳細を見る
特徴
高品質で信頼性の高い郵便番号APIサービスを無料で提供しています
アクセス制限なし
CloudflareのCDNを利用しているため、ほとんどのデータはCDNでキャッシュされています。高速な応答と安定したサービスを実現しつつ、利用制限を設けていません。
Cloudflare CDN高速・安定
最先端のWeb技術を利用して約70msでデータの返却が完了する高速なレスポンスを実現。HTTP/3対応、IPv6対応、転送圧縮対応で快適に利用できます。
外部データセンターからの監視を行い、稼働率も公開しています。
地域から検索
地図または都道府県リストから郵便番号を検索できます
地図から選ぶ
地図上の都道府県をクリックすると、その地域の郵便番号一覧が表示されます
都道府県から郵便番号検索
北海道・東北
関東
信州・北陸
東海・近畿
中国・四国
九州・沖縄
デモ
郵便番号を入力して、住所情報を自動取得する実装例
ライブデモ
サンプルコード
document.getElementById('postcode')
.addEventListener('keyup', function(e) {
if (!e.key.match(/[0-9]/)) return;
const postcode = e.target.value;
if (postcode.length !== 7) return;
const url =
`https://postcode.teraren.com/postcodes/${postcode}.json`;
fetch(url)
.then(response => response.json())
.then(json => {
document.getElementById('prefecture').value
= json.prefecture;
document.getElementById('city').value
= json.city;
document.getElementById('suburb').value
= json.suburb;
})
.catch(error => {
console.error(error);
['prefecture', 'city', 'suburb'].forEach(id => {
document.getElementById(id).value = '';
});
});
});<form>
<input type="text" id="postcode"
placeholder="1600023" maxlength="7" autofocus>
<input type="text" id="prefecture"
placeholder="東京都" disabled>
<input type="text" id="city"
placeholder="新宿区" disabled>
<input type="text" id="suburb"
placeholder="西新宿" disabled>
</form>よくある質問
サービスに関するよくある質問と回答
更新頻度はどのくらいですか？
郵便局のデータが月末に更新されるので、月初1日の早朝に更新しています。
商用利用できますか？
はい。商用利用も無料です。
追加してほしい機能がある
機能要望はDiscordでご連絡願います。
作者は？
@matsubokkuriです。フォローしてもらえると幸いです。
更新情報を知りたい
Discordに掲載しています。
GraphQLに対応していますか？
はい。こちらの方もリクエスト数の制限はありません。
サイト開設日は？
2015年1月からサービスを提供しています。
AIアシスタントから
郵便番号を検索
Model Context Protocol (MCP) サーバーを使って、Claude などのAIアシスタントから直接郵便番号データにアクセスできます。住所検索、都道府県一覧、建物検索など10種類のツールを提供。
$ claude mcp add postcode -- npx -y mcp-server-postcode
Added MCP server postcode
$ claude
You: 新宿区の郵便番号を教えて
Claude: 新宿区の郵便番号をお調べします。
search_postcodes({ query: "新宿区" })
〒160-0023 新宿区 西新宿
〒160-0022 新宿区 新宿
〒160-0021 新宿区 歌舞伎町
...