日本企業名正規化API Docs

AI Toolの使い分け

使うとき

前株・後株を吸収して名寄せしたい
（株）、KK、Co., Ltd.を比較したい
全角半角・空白・記号を統一したい

使わないとき

その企業が実在するか確認する場合
法人番号を取得する場合

推奨Tool Call: japan_company_name_normalize({"company_name":"（株）ＳＡＭＰＬＥ"})

入力・出力schema

POST `/v1/japan/company-name/normalize`

必須入力

company_name: 正規化する企業名

任意入力

なし

返却内容

original・display・normalized
法人格と位置
検索候補
normalization_steps

OpenAPI 3.1 / JSON Schemaを確認

実行例

curl -X POST https://api.japanapistore.com/v1/japan/company-name/normalize \
  -H "Authorization: Bearer ${JAPAN_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"company_name":"（株） ＳＡＭＰＬＥ"}'

JSONリクエスト

{
  "company_name": "（株） ＳＡＭＰＬＥ"
}

JSONレスポンス

{
  "success": true,
  "data": {
    "original": "（株） ＳＡＭＰＬＥ",
    "display": "(株) SAMPLE",
    "normalized": "株sample",
    "corporate_type": null,
    "normalization_steps": [
      "全角・半角をNFKCで統一"
    ]
  },
  "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を確認してください。