郵便番号検索API
郵便番号検索APIでは、郵便番号から住所を検索するWEBサービスAPIを無料提供しております。
郵便番号検索APIでは、郵便番号から住所を検索するWEBサービスAPIを無料提供しております。
都合上zip.cgis.bizのIPアドレスを変更しました。
変更したのは2016年7月12日AM10:00頃～PM17:00頃です。
これに伴い工事期間、あるいは名前解決の浸透期間、通信でませんでした。
GET
[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の各要素の解説や実際の出力ファイルなど。以下をご覧ください。
毎月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ファイルを出力します。
PHPでAPIを利用するスクリプトを作りました。以下をご参照ください。
※内容は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公開。