Japanese Contact Data Cleaner (郵便番号・電話番号)

Clean the postal codes, addresses and phone numbers in a Japanese customer list in one pass.

• Postal code lookup and check: normalizes １００－０００５ / 1000005 to 100-0005, says whether the code exists, and returns prefecture / city / town with kana readings (including large-office codes)
• Address → postal code: finds the postal code for an address, handling spelling variants such as 霞ヶ関 / 霞が関, 丸ノ内 / 丸の内, 1丁目 / 一丁目, a missing prefecture, or a 字 prefix
• Mismatch detection: flags rows where the postal code and the address point to different places (postalCodeMatchesAddress: false), a common sign of typos
• Phone numbers: formats to 03-1234-5678 and +81312345678, and tells landline, mobile, IP phone (050), toll free (0120/0800) and navi dial (0570) apart
• Runs entirely on bundled data, so your records never leave the run and there are no third-party API limits

Typical uses: cleaning CRM or EC customer lists before a mailing, checking form submissions, preparing data for deduplication (名寄せ). Pair it with the Japanese Address Normalizer for full address cleaning.

Input

{
  "records": [
    { "id": 1, "postalCode": "１００－０００５", "address": "東京都千代田区丸ノ内1丁目1-1", "phone": "03(1234)5678" },
    { "id": 2, "postalCode": "5300001", "address": "千代田区霞が関1-2", "phone": "０９０１２３４５６７８" }
  ]
}

Field names can be changed with postalCodeField, addressField and phoneField. Any field can be missing.

Output (one row per record)

field	example	meaning
input	{ "id": 1, ... }	the record as given
postalCode / postalCodeValid	100-0005 / true	normalized code and whether it exists
prefecture / city / town (+ …Kana)	東京都 / 千代田区 / 丸の内	place of the postal code
officeName	null	business name for large-office postal codes
addressPostalCode	100-0013	postal code found for the address (null when several codes are possible)
addressPostalCodeCandidates	["100-0013"]	every possible code for the address
addressMatchLevel	town	town, city, prefecture, ambiguous or none
postalCodeMatchesAddress	false	whether the given postal code fits the address (null when it can't be checked)
phoneNational / phoneE164	090-1234-5678 / +819012345678	formatted phone number
phoneType	mobile	fixed, mobile, ip, toll_free, navi_dial, …
phoneValid	true	whether the number is a valid phone number
error	null	set when the record had nothing to clean

Pricing

You pay per record that had a postal code, address or phone number to clean, about $0.50 per 1,000 records. Records with none of them are free. The run stops automatically at your spending limit, so a test with a few records costs a fraction of a cent.

FAQ

Are my records sent anywhere? No. Postal code data and phone rules are bundled inside the Actor, so nothing is sent to a third-party API and nothing is stored after the run except your own dataset.

How fresh is the postal code data? Japan Post updates postal codes monthly; this Actor picks up each update automatically after it passes tests.

Does a valid phone number mean it is in service? No. The check confirms the number follows Japan's numbering plan and tells you its type; it does not call the number.

How do I call it from code or an AI agent? Use the Apify API or the Apify MCP server with the input shown above; results come back as JSON or CSV from the run's dataset. Pair it with the Japanese Address Normalizer & Geocoder for full address cleaning.

Data sources and credits

• 郵便番号データ（日本郵便株式会社）. Japan Post states that it does not claim copyright on the postal code data and that it may be freely redistributed.
• Repackaged by jpostcode-data (SmartHR, MIT) and jpostcode (MIT); the bundled data is refreshed monthly.
• Phone number rules from libphonenumber-js (MIT), based on Google's libphonenumber.

This Actor is not affiliated with or endorsed by Japan Post, SmartHR or Google. Results are best-effort: a valid phone number format does not mean the number is in service.

---

日本語の説明

顧客名簿などの郵便番号・住所・電話番号をまとめて整えます。郵便番号の実在確認と住所の補完、住所からの郵便番号検索、郵便番号と住所の食い違いの検出、電話番号の表記統一と種別（固定・携帯・050・フリーダイヤル・ナビダイヤル）の判定ができます。データは Actor 内に同梱しているため、入力したデータが外部に送信されることはありません。郵便番号データは毎月更新します。