郵便番号
REST API

高速・安定・無料の郵便番号検索API

2015~ 運用開始
¥0 完全無料
~70ms レスポンス
99.9% 稼働率

詳細を見る

特徴

高品質で信頼性の高い郵便番号APIサービスを無料で提供しています

完全無料

個人利用、商用利用ともに無料で提供しています。リクエスト数に制限はなく、アカウント登録も不要です。誰でも手軽にアクセス数を気にせず使えるサービスです。
寄付はGithubから

利用規約

アクセス制限なし

CloudflareのCDNを利用しているため、ほとんどのデータはCDNでキャッシュされています。高速な応答と安定したサービスを実現しつつ、利用制限を設けていません。

Cloudflare CDN

高速・安定

最先端のWeb技術を利用して約70msでデータの返却が完了する高速なレスポンスを実現。HTTP/3対応、IPv6対応、転送圧縮対応で快適に利用できます。
外部データセンターからの監視を行い、稼働率も公開しています。

サービス稼働状況

地域から検索

地図または都道府県リストから郵便番号を検索できます

地図から選ぶ

地図上の都道府県をクリックすると、その地域の郵便番号一覧が表示されます

デモ

郵便番号を入力して、住所情報を自動取得する実装例

ライブデモ

7桁の郵便番号を入力してください

サンプルコード

autofill.js
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 = '';
      });
    });
});
postcode.teraren.com.html
<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>
DATA CATALOG

利用可能なマスタデータ

APIで取得できる全データカタログ

Postal Data

郵便番号

全国の郵便番号データ。住所、緯度経度情報を含みます。

143,413
一覧

都道府県

都道府県のマスタデータ。市区町村一覧へアクセス可能。

47
API

Railway Data

全国の鉄道駅情報。駅名、路線、緯度経度を含みます。

10,155
一覧

路線

鉄道路線のマスタデータ。事業者、鉄道区分を含みます。

596
一覧

事業者

鉄道事業者のマスタデータ。JR、私鉄などの分類を含みます。

178
一覧

鉄道区分

普通鉄道、新幹線、モノレールなどの区分マスタ。

12
一覧

事業者種別

JR、公営、民営、第三セクターなどの種別マスタ。

5
一覧

Specialized Data

大口事業所

フロアごとに郵便番号が割り当てられている建物データ。

86
一覧

事業所

個別に郵便番号が割り当てられている事業所データ。

22,405
一覧

よくある質問

サービスに関するよくある質問と回答

機能要望はどこで受け付けていますか?

Discordまたはお問い合わせページからリクエストを送信してください。

元データはどこから取得していますか?

地域用郵便番号はzipcloud、事業所の郵便番号は郵便局、駅・路線・事業者情報は国土交通省 国土数値情報のデータを取り込んでいます。

更新頻度はどのくらいですか?

郵便局のデータが月末に更新されるので、月初1日の早朝に更新しています。

商用利用できますか?

はい。商用利用も無料です。

寄付をしたいです

寄付はGithubからお願いします。Xにてお礼メッセージをつぶやきます。

追加してほしい機能がある

機能要望はDiscordでご連絡願います。

開発を手伝いたい

Ruby on Railsで書いています。Github上でprivate repositoryで運用しています。 Discordまたはお問い合わせページからプロフィールと共にご連絡ください。

ソースコードを購入したい

イントラネットで運用したいといった要望などのために販売しています。Discordまたはお問い合わせページから条件をご連絡ください。

作者は?

@matsubokkuriです。フォローしてもらえると幸いです。

更新情報を知りたい

Discordに掲載しています。

GraphQLに対応していますか?

はい。こちらの方もリクエスト数の制限はありません。

サイト開設日は?

2015年1月からサービスを提供しています。

最終更新日: 2026/02/01 19:20:31
MCP Server

AIアシスタントから
郵便番号を検索

Model Context Protocol (MCP) サーバーを使って、Claude などのAIアシスタントから直接郵便番号データにアクセスできます。住所検索、都道府県一覧、建物検索など10種類のツールを提供。

Claude Code
$ 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 新宿区 歌舞伎町
  ...