Japan Address API

Endpoints (7 live)

• POST /reverse-geocode — Reverse-geocode WGS84 lat/lng coordinates within Japan to a normalized Japanese (JP) address with structured components. Use to label a GPS fix, a map pin, or a photo location with a human-readable address. (0.005 USDC on Base)
• POST /geocode — Geocode a Japanese (JP) address to WGS84 lat/lng coordinates, with a granularity level (prefecture → city → town → chome → banchi) and a 0-1 confidence score showing how precisely the input resolved. Japan-only. Use for mapping, distance calculation, or delivery routing. (0.005 USDC on Base)
• POST /normalize — Japanese address normalization (住所正規化): standardize a JP address into clean prefecture / city / town / chome-banchi components. Fixes fullwidth/halfwidth digits, old-form kanji, and chome-banchi notation variants, and resolves the 7-digit postal code. Returns a 0-1 confidence score so agents can flag low-quality input. Use for address validation, cleansing, deduplication, and canonicalization before storage or comparison. (0.005 USDC on Base)
• GET /postal-code/:zip — Look up Japanese (JP) address candidates for a 7-digit postal code (郵便番号), backed by the official Japan Post KEN_ALL dataset. One postal code can map to several towns; all candidates are returned with kana readings. Use for address autofill and postal-code validation. (0.001 USDC on Base)
• POST /parse — Parses and normalizes addresses from input text or data. (0.005 USDC on Base)
• POST /batch — Returns batch address data for multiple requests across supported networks. (0.004 USDC on Solana)
• GET /postal-code/1 — Look up Japanese (JP) address candidates for a 7-digit postal code (郵便番号), backed by the official Japan Post KEN_ALL dataset. One postal code can map to several towns; all candidates are returned with kana readings. Use for address autofill and postal-code validation. (0.001 USDC on Base)