郵便番号→住所APIの料金はいくらですか？

無料のフリープランでまず試して、本番運用は郵便番号→住所APIを含むスタンダードプランで5,500円/月 (税込) から商用利用可能。法人番号・適格請求書発行事業者・学校コードまで使うならプレミアムプラン (66,000円/月・税込) がお得です。

zipcloudやHeartRailsとの違いは？

商用利用が明示的に可能・ISMS認証取得済みの法人運営・毎月自動更新・status.kenall.jpでSLA公開・サポート窓口あり、という点が違います。基幹システム組み込みに必要な信頼性を担保しています。

技術仕様 (エンドポイント・フィールド) はどこで確認できますか？

郵便番号→住所API 技術仕様 (詳細) (/docs/api/postal-code) で、3エンドポイント・30+フィールド・APIバージョン別の差分を完全に確認できます。OpenAPI仕様書のダウンロードや公式JavaScript SDKも利用可能。

郵便番号→住所API — 7桁入れたら、住所が出てくる。

要約: ECサイトの住所自動入力・配送先補完・郵便番号バリデーションに使う REST API。日本郵便公式データを毎月更新、5,500円/月 (税込) 〜商用利用可。

ISMS認証取得5,500円/月 (税込) 〜フリープランあり

このAPIで出来ること (デモンストレーション)

このAPIが返すデータは、下のサンプル行を押すとその場で確認できます。代表的な7つの郵便番号で、APIの応答内容と住所のハイライト (緑)を体験してください。

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

👇 各行を 押してみてください。そのまま自動で検索が走ります。

サンプル名郵便番号

レスポンス200 OK

サンプルを押すと、公式JS SDK (@ken-all/kenall) 経由で 実際のAPIレスポンスをその場で取得します。任意の7桁郵便番号を入力しても検索できます。

🔧 エンジニアの方へ

curl で 3 秒で叩いて、手応えを確認できます。YOUR_API_KEY の部分を、自分のキーに置き換えてください。

curl -H "Authorization: Token YOUR_API_KEY" \
  https://api.kenall.jp/v1/postalcode/1000001

↓ レスポンス (住所が緑で返ってくれば成功)

{
  "version": "2026-04-01",
  "data": [
    {
      "postal_code": "1000001",
      "prefecture": "東京都",
      "city":       "千代田区",
      "town":       "千代田"
    }
  ]
}

🧰SDK公式JavaScript SDK 📄OpenAPI 仕様書技術仕様ページで配布 📚技術仕様 (詳細)エンドポイント・フィールド全網羅

ユースケース

郵便番号→住所APIが効く代表的なシーン。さらに詳しくはユースケース一覧へ。

フォーム入力・EFO

EC住所自動補完で離脱防止

郵便番号を入力すると住所が自動で埋まり、住所入力の手間（入力負荷）を減らせる。

フォーム入力・EFO

電話注文の住所聞き取り短縮

郵便番号を聞くだけで町域まで画面表示。漢字の聞き間違いがなくなり、通話時間も短くなる。

データ整備・分析

顧客リストに地域列を自動付与

郵便番号から都道府県・市区町村の列を機械的に付与。手作業の名寄せなしで地域別レポートが作れる。

物流オペ

郵便番号と住所の食い違い検出

両方向のAPIで突き合わせ、矛盾した伝票だけを自動抽出。全件を目視で確認する手間や、配達後の返送対応を減らせる。

なぜケンオールの郵便番号→住所APIか

ISMS (ISO/IEC 27001) 認証取得。法人運営でガバナンス・監査要件をクリア、金融・基幹システムにも組み込めます。
契約SLA・障害通知に対応。status.kenall.jp で稼働率をリアルタイム公開、エンタープライズ契約あり。
日本郵便公式データを毎月自動更新。version フィールドで取得時点を管理、差分APIにも対応します。
京都通り名・小字・ビル名まで最深に正規化。フォームにそのまま流せる構造化済みデータで返却。
周辺APIも1社で完結。法人番号・銀行・祝日・適格請求書まで同じプラットフォームで取得できます。
商用利用OK。フリープランを含むすべてのプランで商用利用可能。
サポート窓口あり。法人運営でメール窓口・契約問い合わせ・障害対応に対応します。
フロント直叩きにも対応。APIキー1本＋Origin制限で、ブラウザから安全に呼び出せます。

クイックスタート

アカウント登録 → APIキー取得とコピー → あなたの環境で動かす、の3ステップです。キーの取得までは人間の作業、最後の組み込みはAIに任せることもできます(所要約5分)。

Step 1 — アカウント登録

無料で始めるからメールアドレスを登録し、確認メールのリンクをクリック。フリープランは無料・クレジットカード登録不要で始められます。

Step 2 — APIキー取得とコピー

ログイン後、ダッシュボードの左メニュー「APIキー」を開くと、下のような画面になります。やることは ① キーをコピー と、ブラウザから直接使う場合は ② 許可ドメインを登録 の2つだけです。

ケンオールホーム　ドキュメント　料金表　ログアウト

APIキーの管理

名前APIキー有効期限許可ドメイン

公開00000000…12999/12/31www.example.com2

1APIキー: 赤い欄をクリックでコピー。これが次の手順の YOUR_API_KEY です。
2ドメインとポート番号を登録 (ブラウザから直接呼ぶ場合のみ必要)。

注意

APIキーは利用規約に従って適切に管理してください。ブラウザから呼び出す公開キーは許可ドメイン (Origin) を設定し、サーバー用のシークレットキーは第三者に公開しないでください。詳しくは APIキー・認証をご覧ください。

Step 3 — あなたの環境で動かす (AIにコピペ)

使い慣れたAIに 完成形のプロンプト を渡して、自社サイト・アプリ・手元のPC など あなたの環境で動くコード を書いてもらいます。3ステップで完了します。

下のボタンでプロンプトをコピー
ChatGPT / Claude などに貼り付け
末尾をあなたの状況に書き換えて送信

ボタンを押すと、正しい呼び出し方・つまずきポイント・テンプレートまで全部入りのプロンプトがクリップボードにコピーされます。

コピーされる内容 (プレビュー)

あなたはケンオールAPI (日本の公的データAPI / kenall.jp) の実装パートナーです。
このプロンプトの最後にある「私のやりたいこと」を、以下の仕様に従って実装する動くコードを書いてください。

# 使うAPI: 郵便番号→住所
- エンドポイント: GET https://api.kenall.jp/v1/postalcode/{7桁の郵便番号}
- 認証: HTTPヘッダ「Authorization: Token YOUR_API_KEY」
- 公式SDK (JavaScript): npm install @ken-all/kenall
- ドキュメント: https://kenall.jp/api/postal-code

# 正しい呼び方 (JavaScript SDK・最小コード)
import { KENALL } from "@ken-all/kenall";
const api = new KENALL("★ここに自分のAPIキーを貼り付け★"); // ← ユーザーが書き換える唯一の場所
const res = await api.getAddress("1000001");        // ← 7桁・ハイフンなし
const a = res.data[0];                              // ← res.data は配列 (複数住所のケース対応)
console.log(a.prefecture + a.city + a.town);        // → 東京都千代田区千代田

# 本番運用では上の "★...★" の部分を process.env.KENALL_API_KEY などの環境変数に置き換えることを推奨してください (フロントエンドにキーをハードコーディングしない)。

# 必ず守ってほしい実装ルール
1. 入力値からハイフン・全角数字を除去してから渡す ("100-0001" や "１０００００１" → "1000001")
2. 7桁の数字であることをバリデーションする
3. ブラウザから直接呼ぶ場合は、APIキー側に呼び出し元ドメイン (Origin) が登録されていることが前提
4. APIキーは環境変数や安全な場所で管理 (フロントエンドにハードコーディングしない)
5. TypeScript の場合は適切な型を付ける
6. エラー (ネットワーク失敗 / 該当なし / 401 等) はユーザーに分かる形でハンドリング

# あなた (AI) の出力ルール【重要】
- コード内で「ユーザー (私) が自分で書き換える場所」は、必ず ★ で囲んで明示してください。
- 実装コードの後に、必ず「## 🔑 あなたが今からやること」という見出しを付けて、ユーザーが行う作業の番号付きチェックリストを出力してください。
  最低でも次の項目を含めてください:
    1. ケンオール管理画面でAPIキーを取得する ( https://kenall.jp/signup )
    2. ★マークの場所を実際の値で置き換える
    3. ブラウザから直接呼ぶ場合は、APIキー側に呼び出し元ドメインを許可登録する
    4. 必要な依存パッケージのインストールコマンド (例: npm install @ken-all/kenall)
    5. 動作確認の手順

# 進め方
1. 私の状況 (下の「私の入力」セクション) を読み、不明点があれば1つだけ質問してください
2. 実装コード (書き換え箇所は ★...★ で必ず明示)
3. 「## 🔑 あなたが今からやること」チェックリスト

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🚨 ここから下は「私 (ユーザー) が書き換える唯一の場所」です。
   ★...★ で囲まれた部分を、自分の値に置き換えてください。
   ここから上は、AIへの仕様なので変更しないでください。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

## 📌 私が実施したこと
- [x] ケンオールでAPIキーを取得しました

## 🔑 私のAPIキー
**★ここに自分のAPIキーを貼り付け★**
(ケンオール管理画面 https://kenall.jp/signup の「APIキー」欄でコピーしたもの。「★」も含めて丸ごと書き換えてください)

## 🛠 私の開発状況 (下の4行を自分の状況に書き換え)
- **開発環境**: ★React + Next.js★ (例: React / Vue / プレーンHTML+JS / Node.js / Python / 等)
- **組み込む場所**: ★会員登録フォーム★ (例: 会員登録フォーム / 配送先入力 / バッチ処理 / 等)
- **やりたいこと**: ★郵便番号7桁を入れたら、住所欄が自動入力されるように★
- **呼び出し元ドメイン**: ★http://localhost:8000★ (ブラウザから直接呼ぶ場合のみ。本番のドメインが決まっていれば併記。管理画面でAPIキーに許可登録するもの)

## 🎯 あなた (AI) にしてほしいこと
上の私の状況に合わせて、動くコードを書いてください。コード内で私が手作業で値を入れる場所は ★...★ で囲んで明示し、最後に「## 🔑 あなたが今からやること」チェックリストを出力してください。

ヒント

本番組み込み時は、本番ドメインも許可ドメインに追加しておきましょう。

料金プラン

無料のフリープランでまず試して、郵便番号→住所APIの本番運用はスタンダードプラン (5,500円/月・税込) から。上位のプレミアム・エンタープライズでもご利用いただけます。

FREE

フリープラン

無料

クレジットカード不要
商用利用可
検証・PoC・評価向け

STANDARD

スタンダードプラン

5,500円/月 (税込)

郵便番号→住所 / 住所→郵便番号 (正規化)
市区町村・銀行情報・日本の祝日
土日・祝日判定

PREMIUM

プレミアムプラン

66,000円/月 (税込)

スタンダードの全機能
法人番号 (検索・法人情報・レーダー)
適格請求書発行事業者・学校コード

ENTERPRISE

エンタープライズ

お問い合わせ

プレミアムの全機能
専用サポート窓口・SLA・RTO
障害通知・セキュリティ評価レポート

クレジットカード不要のフリープランでお試し。郵便番号→住所APIの本番運用はスタンダードプラン (5,500円/月・税込) から。

→ プランと料金を見る

このAPIに関するよくある質問

料金はいくらですか？

フリープラン (トライアル) から利用可能で、API利用回数は無制限です (過剰アクセス時はレート制限あり)。詳細はプランと料金へ。

商用利用は可能ですか？

はい、フリープランを含めすべてのプランで商用利用が可能です。追加の許諾申請は不要です。

データ品質はどう担保されていますか？

日本郵便公式の郵便番号データを毎月更新しています。ISMS認証取得済みの法人運営体制で、データの取り込み・整形・配信を管理しています。詳細は技術仕様 (詳細) の出典・更新頻度の章を参照してください。

解約はいつでもできますか？

はい、ダッシュボードからいつでも解約できます。違約金や最低利用期間はありません。月の途中で解約した場合、その月末まで利用可能です。

技術的な仕様 (エンドポイント・パラメータ等) はどこで確認できますか？

郵便番号→住所API 技術仕様 (詳細) で完全仕様をご確認いただけます。

住所→郵便番号API — 既存の住所データから郵便番号を引きたい (逆引き)、表記ゆれを統一したい場合に併用。
郵便番号データダウンロードAPI — 1日に10,000件以上引くようなバッチ処理は、毎月の全件DLが効率的。
市区町村API — 都道府県→市区町村のカスケードセレクト実装に。

今すぐ始める

クレジットカード不要・無料のフリープランあり。ISMS認証取得・法人運営で安心。

無料で始める技術仕様 (詳細) を見るお問い合わせ

最終更新: 2026-06-03