郵便番号・デジタルアドレスAPIとは｜日本郵便公式APIの料金・登録手順・使い方

「デジタルアドレス api」で調べる人が探しているのは、汎用的な住所検索サービスではなく、日本郵便が2025年5月26日に提供を開始した公式の「郵便番号・デジタルアドレスAPI」です。デジタルアドレス（英数字7桁のコード）や郵便番号から住所を取得できる公式APIで、データのメンテナンス不要・無料で使えます。この記事では、デジタルアドレスの仕組みから、ゆうID登録・OAuthトークン取得・郵便番号→住所の実装例、そしてZipCloudなど従来の郵便番号APIとの使い分けまで、実務目線で整理します。

まとめ：郵便番号・デジタルアドレスAPIの要点

• デジタルアドレスは、住所全文を英数字7桁（約783億通り）で表す日本郵便のコード。ゆうIDに紐づき、無料で取得でき、引越し後も同じコードを引き継げる。
• 公式APIは「郵便番号・デジタルアドレスAPI」。searchcode（郵便番号・デジタルアドレス→住所）とaddresszip（住所→郵便番号）の2系統を無料で提供する。
• 利用にはゆうIDと「郵便番号・デジタルアドレス for Biz」への登録が必須。認証はOAuth 2.0（client_credentials）で、トークンを取得してから各APIを呼ぶ。
• アクセス元IPを最大10件まで登録して固定する仕様のため、ブラウザのJavaScriptから直接は呼べない。サーバー経由で呼ぶ設計が前提。
• Amazonは公式には未対応（Amazonの「デジタル購入用の住所」は別物）。楽天市場や郵便局アプリの送り状作成では利用できる。
• 手軽さ重視ならZipCloud、EC向けの実績重視ならPostcodeJP、最新データ・デジタルアドレス対応・公式であることを重視するなら日本郵便公式API、と使い分ける。

デジタルアドレスとは｜7桁の英数字で住所を表す日本郵便のサービス

デジタルアドレスは、都道府県から町域・建物までを含む住所全文を、個人ごとに割り当てられた英数字7桁のコードで表す仕組みです。日本郵便が2025年5月26日に提供を開始しました。APIの理解の前に、まず「何を7桁に変換しているのか」を押さえておくと、後述のsearchcode APIの挙動が腑に落ちます。

7桁のコードが住所全文に対応する仕組み

デジタルアドレスは、ゆうIDに登録した住所1件に対して発行される識別コードです。英数字7桁の組み合わせは約783億通りあり、住所ではなく「そのユーザーの住所を指すポインタ」として機能します。住所は引越しで変わりますが、コードはゆうIDに紐づくため、引越し後も同じデジタルアドレスを使い続けられる点が郵便番号との決定的な違いです。人に住所を教える場面で、番地や建物名を伝える代わりに7桁を渡せば足ります。

取得方法はゆうIDでのログイン、料金は無料

デジタルアドレスの取得にはゆうIDの登録が必須で、郵便局アプリ版またはデジタルアドレスWeb版にログインして発行します。取得・利用ともに無料です。発行後は、コードに紐づく住所を自分で更新でき、更新すればAPI経由で返る住所も最新化されます。企業がAPIを使う場合も、返ってくる住所はユーザー本人が管理している最新の登録住所である点が、外部データを加工する従来サービスとの性格の違いになります。

使える場所は限定的｜「住所の代替」ではなく入力のショートカット

デジタルアドレスは、どこでも住所の代わりに使える万能コードではありません。2026年時点で確実に使えるのは、郵便局アプリのゆうパック送り状作成と、対応を表明したEC（楽天市場の住所入力画面など）です。紙の送り状に7桁だけ書いても配達はされず、あくまで対応システム上で住所入力を省くショートカットという位置づけです。なお「デジタルアドレス amazon」で調べる人が多いものの、Amazonは公式には対応しておらず、Amazonアカウントにある「デジタル購入用の住所」はデジタルアドレスとは無関係な別機能です。ここは混同されやすいので、企業がユーザー向けに案内する際は明確に区別してください。

郵便番号・デジタルアドレスAPIの全体像｜2つのAPIと料金

公式APIは、用途の異なる2つのAPIで構成されます。どちらも無料で、レスポンスの住所は漢字・カナに加えてローマ字でも返却されます（事業所個別郵便番号は漢字・カナのみ）。ベースURLは https://api.da.pf.japanpost.jp、APIリファレンスのバージョンは 1.0.1.250707 系です。

searchcode API｜郵便番号・デジタルアドレスから住所を取得

searchcode は、郵便番号・事業所個別郵便番号・デジタルアドレスを共通の入力として住所を返すAPIです。エンドポイントは GET /api/v1/searchcode/{search_code} で、パスに7桁のデジタルアドレスや郵便番号を渡します。返却されるのは都道府県・市区町村・町域などの構造化住所で、フリーワードや絞り込み用のクエリパラメータ（page / limit / searchtype など）も指定できます。2026年3月19日以降は、ビジネスデジタルアドレスを渡すと法人・個人事業主の住所・電話番号・法人番号といったビジネス情報も返るよう拡張されています。

addresszip API｜住所から郵便番号を逆引き

addresszip は、住所の一部やフリーワードから該当する郵便番号・住所を検索するAPIです。エンドポイントは POST /api/v1/addresszip で、リクエストボディに pref_name（都道府県）・city_name（市区町村）・town_name（町域）や freeword を指定します。住所文字列からの正規化や名寄せの前段として、表記を郵便番号ベースに揃えたいケースで使います。「住所から郵便番号検索 api」で流入する読者が求めているのはこの機能です。

無料で使える範囲と、ZipCloud・PostcodeJPとの違い

日本郵便公式APIは無料ですが、後述のとおり登録とサーバー経由の呼び出しが前提で、手軽さでは非公式サービスに劣ります。目的別の使い分けは次のとおりです。

試作や個人開発で郵便番号→住所だけ動けばよいならZipCloudが最速です。一方、デジタルアドレス対応が要件になっている、公式データであることを社内で説明したい、という業務利用では公式APIが選択肢になります。

APIの利用開始手順｜ゆうID登録からトークン取得まで

公式APIは「アカウントを作ってAPIキーを1本もらう」タイプではなく、for Bizでの組織登録とアクセス元の登録を経てOAuthトークンを取得する流れです。「apiキーの取得」「apiキー 使い方」で来た読者がつまずきやすいのはこの前提部分なので、順に説明します。

for Bizへのアカウント登録とシステムリスト登録（IPは最大10件）

まずゆうIDで「郵便番号・デジタルアドレス for Biz」に登録し、API利用規約に同意します。次に、APIを呼び出すシステムを「システムリスト」に登録します。ここでシステム名・アクセス元URL（ドメイン）・IPアドレス（最大10件）を設定し、アクセス元を固定します。この固定要件があるため、ブラウザのJavaScriptからクライアント側で直接APIを叩く構成は取れません。フォームの住所補完に使う場合も、自社サーバーを経由して呼ぶ設計が前提になります。ここは他の無料APIの感覚で実装を始めると必ず引っかかる箇所です。

OAuth 2.0でトークンを取得する

認証はOAuth 2.0（client_credentialsフロー）です。POST /api/v1/j/token に grant_type=client_credentials・client_id・secret_key を送り、token（アクセストークン）・token_type・expires_in（有効期限の秒数）を受け取ります。以降の各APIには、このトークンを Authorization: Bearer ヘッダーに付けてアクセスします。トークンには有効期限があるため、expires_in を見て期限切れ前に再取得する処理を入れておきます。OAuth 2.0そのものの認可フローを整理したい場合はOAuth 2.0の認証・認可フローの解説もあわせて確認してください。

searchcode・addresszipを呼び出す

トークンを取得したら、住所取得なら searchcode、郵便番号の逆引きなら addresszip を呼びます。トークン取得エンドポイントには x-forwarded-for ヘッダーの指定が必要で、システムリストに登録したIPと一致していないと弾かれます。設計としては、良いAPIクライアントの原則どおりトークン管理と業務ロジックを分離しておくと保守しやすくなります（良いAPI設計のポイントを参照）。

実装例｜郵便番号から住所を取得する

最小構成で、トークン取得→郵便番号による住所取得までの流れを示します。値はダミーです。実際のパラメータ名・レスポンス構造は公式APIリファレンスで最新を確認してください。

トークンを取得する（curl）

curl -X POST "https://api.da.pf.japanpost.jp/api/v1/j/token" \
  -H "Content-Type: application/json" \
  -H "x-forwarded-for: 203.0.113.10" \
  -d '{"grant_type":"client_credentials","client_id":"YOUR_CLIENT_ID","secret_key":"YOUR_SECRET_KEY"}'

# レスポンス例
# {"token":"eyJhbGci...","token_type":"Bearer","expires_in":600}

郵便番号から住所を取得する（Python）

import requests

TOKEN = "eyJhbGci..."  # 取得済みアクセストークン
zipcode = "1000001"    # 郵便番号やデジタルアドレスを渡す

res = requests.get(
    f"https://api.da.pf.japanpost.jp/api/v1/searchcode/{zipcode}",
    headers={"Authorization": f"Bearer {TOKEN}"},
)
data = res.json()
for a in data["addresses"]:
    # 漢字・カナ・ローマ字が返る
    print(a)

住所→郵便番号の逆引きは POST /api/v1/addresszip にボディで pref_name や freeword を渡します。レスポンスの addresses 配列に候補が返るため、複数件ヒットする前提でUIを組みます。

実装で詰まりやすい4つの制約と回避策

公式APIは「無料で公式」である代わりに、他の郵便番号APIより制約が多く、次の点で手が止まりがちです。

• ブラウザから直接呼べない：アクセス元IPを固定する仕様のため、フロントのfetchで直叩きするとIP不一致で失敗する。BFF（サーバー側の中継）を挟む。
• トークンの使い回しと再取得：リクエスト毎にトークンを取ると無駄なので、expires_inまでキャッシュし、期限前に更新する。
• x-forwarded-forの値ずれ：プロキシやロードバランサ配下では送出元IPが変わり、登録IPと食い違うことがある。実際の出口IPを登録する。
• 本番IPの追加漏れ：登録できるIPは最大10件。オートスケールで出口IPが増える構成では、固定IP（NATゲートウェイ等）で出口をまとめる。

導入前の判断ポイント｜公式APIを選ぶべきか、他サービスで足りるか

ここまでの仕様を踏まえると、公式APIは「誰にでも最適」ではありません。要件に照らして選ぶための判断軸を、立場を明確にして整理します。

公式APIが向くケース／ZipCloudで十分なケース

公式APIを選ぶべきなのは、デジタルアドレス対応が要件に入っている場合、または最新の住所データと公式であることが監査・説明上必要な業務システムの場合です。逆に、会員登録フォームで郵便番号から住所を補完したいだけ、社内ツールでさっと動けばよい、という用途では、登録もOAuthも不要なZipCloudで十分で、公式APIの制約はむしろオーバースペックになります。「公式だから常に優先」ではなく、デジタルアドレスを扱うか否かが分岐点です。

デジタルアドレス対応の実務メリットと現状の限界

デジタルアドレス対応の実務メリットは、ユーザーが7桁を入力するだけで最新の登録住所が入り、番地・建物名の打ち間違いや引越しに伴う住所ズレを減らせる点にあります。一方で現状の限界は普及と対応先の少なさで、2026年時点で利用できる場面は郵便局アプリや一部ECに限られます。「デジタルアドレスを入力欄に用意すれば全ユーザーが使う」段階にはまだ達していないため、従来の住所入力と併存させ、デジタルアドレスは任意の時短オプションとして提供するのが現実的です。

個人情報・セキュリティ上の注意

APIで取得する住所は個人情報に該当し得ます。secret_keyやトークンをフロントに露出させない（サーバー側で保持する）、取得した住所を必要以上に保存しない、通信はTLS 1.2以上で行う、といった基本を守ってください。アクセス元IPの固定はセキュリティ上の制約であると同時に、漏洩時の被害を抑える仕組みでもあります。登録IPと利用実態を定期的に棚卸しし、不要になったIPは削除しておきます。

よくある質問（FAQ）

郵便番号・デジタルアドレスAPIは無料ですか？

無料です。ただし利用には、ゆうIDでの「郵便番号・デジタルアドレス for Biz」への登録と、システムリストへのアクセス元登録が必要です。データのメンテナンスは日本郵便側で行われるため、利用者側での住所データ更新は不要です。

デジタルアドレスはAmazonで使えますか？

2026年時点で、Amazonは日本郵便のデジタルアドレスに公式対応していません。Amazonアカウントにある「デジタル購入用の住所」は電子書籍などデジタル商品の請求先で、日本郵便のデジタルアドレスとは別物です。デジタルアドレスが使えるのは、郵便局アプリの送り状作成や楽天市場の住所入力など、対応を表明したサービスです。

デジタルアドレスは何桁で、どう取得しますか？

英数字7桁のコードです。ゆうIDを登録し、郵便局アプリまたはデジタルアドレスWeb版にログインして無料で発行します。住所ではなくゆうIDに紐づくため、引越しても同じコードを使い続けられます。

ブラウザのJavaScriptから直接APIを呼べますか？

呼べません。公式APIはアクセス元IPを最大10件まで登録して固定する仕様のため、ユーザーのブラウザから直接叩くとIP不一致で失敗します。自社サーバーを中継し、そこから登録済みIPで呼び出す構成にします。

ZipCloudなどの無料郵便番号APIと何が違いますか？

ZipCloudは日本郵便のCSVを加工した非公式APIで、登録不要・郵便番号→住所のみに対応します。公式APIは、住所→郵便番号の逆引きやローマ字返却、デジタルアドレス対応を備える一方、登録とOAuth認証、サーバー経由の呼び出しが前提です。手軽さならZipCloud、デジタルアドレス対応や公式データが要るなら公式API、と使い分けます。

関連記事

• OAuth 2.0とは何か？認証・認可フローの仕組みをわかりやすく解説
• 良いAPI設計のポイント｜Google API設計ガイドで学ぶ実践指針
• ベアラートークンとは？WebアプリやAPI認証の基本を解説