JAPAN API STOREAPIs for Japan Market Success
Log inSign up
Menu

日本国内向けAPI Docs

日本自治体情報API

japan_municipality_lookup

住所・郵便番号・自治体名から正規自治体名と自治体コードを取得します。

無料APIキーを作る国内API一覧

AI Toolの使い分け

使うとき

  • 住所から自治体コードを知りたい
  • 郵便番号から市区町村を判定したい
  • 自治体名を正規表記へ揃えたい

使わないとき

  • 番地・建物まで住所全体を検証する場合
  • 企業所在地を法人情報と照合する場合

推奨Tool Call: japan_municipality_lookup({"query":"100-0005"})

入力・出力schema

POST /v1/japan/municipality/lookup

必須入力

  • query: 住所、郵便番号、自治体名

任意入力

  • なし

返却内容

  • 都道府県と都道府県コード
  • 市区町村と自治体コード
  • 関連郵便番号
  • 候補とconfidence
OpenAPI 3.1 / JSON Schemaを確認

実行例

curl -X POST https://api.japanapistore.com/v1/japan/municipality/lookup \
  -H "Authorization: Bearer ${JAPAN_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"query":"100-0005"}'

JSONリクエスト

{
  "query": "100-0005"
}

JSONレスポンス

{
  "success": true,
  "data": {
    "found": true,
    "prefecture": "東京都",
    "prefecture_code": "13",
    "municipality": "千代田区",
    "municipality_code": "13101"
  },
  "confidence": 0.92,
  "source": [
    {
      "source_id": "official_source",
      "name": "公的データ",
      "url": null,
      "updated_at": null
    }
  ],
  "updated_at": "2026-09-04T00:00:00.000Z",
  "request_id": "req_0123456789abcdef0123456789abcdef",
  "warnings": []
}

失敗例

{
  "success": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "入力内容を確認できませんでした。",
    "retryable": false,
    "suggested_action": "必須項目と型をOpenAPIで確認してください。"
  },
  "request_id": "req_0123456789abcdef0123456789abcdef"
}

401、403、429、500、503も同じ機械可読構造で返ります。429と5xxはretryable: trueです。

判定可能範囲・判定不能条件

  • 同名自治体や部分入力は候補になる場合があります。
  • 廃置分合の時点指定は現仕様の対象外です。

すべての応答でconfidence、source、updated_at、warningsを確認してください。