Japan Postal Code & Address API

Japanese address lookup by postal code, reverse postal-code search by address, and prefecture list. Official Japan Post data (120,000+ codes).

原始信息汇总

数据集概述

名称：Japan Postal Code & Address API

功能：提供日本地址与邮政编码的相互查询服务，支持通过邮政编码查找地址、通过地址文本反向搜索邮政编码，以及获取日本都道府县列表。

数据来源：数据来自日本邮政（日本郵便 郵便番号データ），每月更新，覆盖超过12万条邮政编码记录。

核心端点：

• GET /v1/zip：输入7位邮政编码（可带或不带连字符），返回对应的地址信息，包括都道府县、城市、城镇及其片假名读音。一个邮政编码可能对应多个城镇。
• GET /v1/search：通过地址文本（支持部分匹配）查询邮政编码，可配合都道府县、城市、城镇等筛选条件。可选参数limit控制返回条数（最大100条）。
• GET /v1/prefectures：返回日本47个都道府县的名称列表，无需参数。

认证方式：订阅计划后，RapidAPI自动注入X-RapidAPI-Key和X-RapidAPI-Host请求头，无需手动管理密钥。

适用场景：结账地址自动填充、物流配送、数据清洗等需要处理日本地址的场合。

定价计划：

• BASIC：免费
• PRO：$4.99/月
• ULTRA：$29.99/月

注意事项：

• 响应中包含attribution字段，需显示出处标识。
• 若地址对应“以下に掲載がない場合”（无具体城镇），则town字段返回空值。