郵便番号検索API

郵便番号検索APIトップページ

郵便番号検索APIでは、郵便番号から住所を検索するWEBサービスAPIを無料提供しております。


お知らせ

ハードウェアメンテナンスのため以下の期間 http://zip.cgis.biz/ を停止します。

停止期間:2012年6月7日AM10:00頃~AM11:30頃

※状況により若干前後する可能性があります。

※予備機(http://zip2.cgis.biz/)は稼動しておりますので利用可能です。


概要



仕様


リクエストメソッド

GET


リクエスト送信先URL

[XMLで受け取りたい場合] http://zip.cgis.biz/xml/zip.php

[CSVで受け取りたい場合] http://zip.cgis.biz/csv/zip.php


New!念願の予備サーバ入手です!

物理的に別なサーバです(サーバ自身はもちろん、所属するネットワークもまったく別です)。zip.cgis.biz が通信エラー(サーバや回線障害)などでデータを受け取れない時に以下のURLでリクエストしてもらえば安心です(^^)

[XMLで受け取りたい場合] http://zip2.cgis.biz/xml/zip.php

[CSVで受け取りたい場合] http://zip2.cgis.biz/csv/zip.php


リクエスト時のパラメーター

※必須=○のパラメータは必ず指定してください。

パラメータ種意味形式初期値必須
zn 郵便番号。 半角数字7桁 | 3桁 or 5桁
(ver=1とした場合3桁 or 5桁)
なし
ver 現行郵便番号(7桁)と旧郵便番号形式(3桁 or 5桁)の切替。 0 | 1 0 ×

受け取りデータ説明

XML/CSVの各要素の解説や実際の出力ファイルなど。以下をご覧ください。

受け取りデータ説明(XML)

受け取りデータ説明(CSV)

エラーコード一覧


更新

毎月10日 AM3:00頃

※更新時、数秒程度サービスを利用できない場合があります。

※日本郵便側のファイル更新日時は概ね月末・月初のようなので10日としました。


リクエスト例


もっとも単純な例

http://zip.cgis.biz/xml/zip.php?zn=1030000

郵便番号103-0000を現行郵便番号から検索し該当する住所を格納した文字コードutf-8のXMLファイルを出力します。

http://zip.cgis.biz/csv/zip.php?zn=1030000

郵便番号103-0000を現行郵便番号から検索し該当する住所を格納した文字コードeuc-jpのCSVファイルを出力します。


郵便番号パラメータ以外を指定した場合

http://zip.cgis.biz/xml/zip.php?zn=103&ver=1

郵便番号103を旧郵便番号から検索し該当する住所を格納した文字コードutf-8のXMLファイルを出力します。

http://zip.cgis.biz/csv/zip.php?zn=10300&ver=1

郵便番号103-00を旧郵便番号から検索し該当する住所を格納した文字コードeuc-jpのCSVファイルを出力します。


API利用例


PHPでAPIを利用するスクリプトを作りました。以下をご参照ください。

※内容はZIPファイルをダウンロードしてソースを見ないとわからないと思います。


(利用例1)XMLを利用して住所入力補助を行う。

(利用例1)のスクリプトダウンロード(ZIPファイル)

(利用例2)CSVを利用して住所入力補助を行う。

(利用例2)のスクリプトダウンロード(ZIPファイル)


注意事項とお願い



その他


一般的なWEBブラウザより郵便番号を検索する場合は以下をご利用ください。

郵便番号検索


ご利用いただいてるサイト様(敬称略)


紹介記事など


更新履歴


2013/07/09 一部住所内の "<" と ">" が実体参照ではなくそのまま出力されてXMLパースエラーとなっており修正しました。

2009/07/01 予備サーバ公開

2008/05/02 Flash等からの利用を考慮してcrossdomain.xmlを設置。
http://zip.cgis.biz/xml/crossdomain.xml
http://zip.cgis.biz/csv/crossdomain.xml

2007/10/02 ver1.01公開。(事業所の個別郵便番号に対応 : 2007/09/30変更内容をメールアドレス登録者へ通知)

2006/12/02 ver1.00公開。