APIドキュメント

郵便番号から住所を検索。前方一致(3桁〜)・完全一致(7桁)に対応。

Query Parameters

Response

{
  "success": true,
  "data": {
    "results": [{
      "postal_code": "1060032",
      "prefecture": "東京都",
      "city": "港区",
      "town": "六本木",
      "prefecture_code": "13",
      "prefecture_kana": "トウキョウト",
      "city_kana": "ミナトク",
      "town_kana": "ロッポンギ"
    }],
    "count": 1
  }
}

住所テキストから郵便番号を逆引き検索

Query Parameters

Response

{
  "success": true,
  "data": {
    "results": [{
      "postal_code": "1060032",
      "prefecture": "東京都",
      "city": "港区",
      "town": "六本木",
      "prefecture_code": "13"
    }],
    "count": 1
  }
}

住所を構造化データに正規化。表記揺れ統一・郵便番号付与。

Request Body

{
  "address": "東京都港区六本木6丁目10番1号"
}

Response

{
  "success": true,
  "data": {
    "prefecture": "東京都",
    "prefecture_code": "13",
    "city": "港区",
    "town": "六本木",
    "block": "6-10-1",
    "building": null,
    "normalized": "東京都港区六本木6-10-1",
    "postal_code": "1060032"
  }
}

住所のバッチバリデーション（最大100件）

Request Body

{
  "addresses": [
    "東京都港区六本木6-10-1",
    "東京都存在しない区1-1-1"
  ]
}

Response

{
  "success": true,
  "data": {
    "results": [
      {
        "input": "東京都港区六本木6-10-1",
        "is_valid": true,
        "normalized": "東京都港区六本木6-10-1",
        "postal_code": "1060032",
        "errors": []
      },
      {
        "input": "東京都存在しない区1-1-1",
        "is_valid": false,
        "normalized": "東京都存在しない区1-1-1",
        "postal_code": null,
        "errors": ["「東京都存在しない区」がデータベースに見つかりません"]
      }
    ],
    "all_valid": false,
    "count": 2
  }
}