POST /v1/parse｜ドキュメント

住所の文字列を27のラベルに分解し、検証レベルと座標を返します。住所のテキストは保存しません。

要確認 本文の項目名（text）と、応答の JSON の正確な構造は、公開前に確定します。ここでは名前の分かっている項目を、簡略化した形で示します。

リクエスト

項目	型	必須	説明
`text`	string	○	住所の文字列。全角・半角・旧字体・漢数字は、そのまま送れます
`mode`	string	—	`"all"` で全候補の一覧を返します（Growth 以上）

curl -s https://api.zorynto.com/v1/parse \
  -H "Authorization: Bearer $KITEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"東京都港区六本木６丁目１０−１ 六本木ヒルズ森タワー"}'

応答（例・簡略化）

{
  "level": "L5",
  "address": {
    "prefecture": "東京都", "city": "港区", "town": "六本木",
    "chome": "6丁目", "block": "10-1", "building": "六本木ヒルズ森タワー", "floor": null
  },
  "location": { "lat": 35.6605, "lon": 139.7292, "precision": "rsdt", "precision_level": 7 },
  "corrections": [{ "type": "全角→半角", "from": "６", "to": "6" }],
  "warnings": [],
  "request_id": "req_…"
}

主な項目

項目	説明	プラン
住所の各要素	都道府県から号・建物名・階まで	全プラン
`location` と精度	座標と、決めた層（精度の階段）	全プラン
検証レベル	L1〜L5（検証レベル）	全プラン
`corrections` / `annotations`	直した箇所・補った箇所の開示	全プラン
`jis_code` `machiaza_id` `addr_flg` `paradigm` `zip_inferred`	自治体コード・町字ID・住所の種別・住所体系・郵便番号の推定	全プラン
`single_tenant` / 警告 U7	単独利用の建物か。多床ビルで階が空なら警告	全プラン
`n_addresses`	本文中の住所の件数	全プラン
`kana` `roma` `reading`	読み仮名・ローマ字	Starter 以上
`nearest_station` `elevation` `resolved_from`	最寄駅・標高・時点の解決	Growth 以上

エラー

コード	原因
400	`text` が空、または JSON が不正
401	認証に失敗
403	`mode="all"` を Developer / Starter で指定
402	月間の上限を超えた
429	秒間の上限・過負荷

詳しくはエラーを参照してください。

次に読む

POST /v1/validate · 検証レベル · CSVの住所を清掃する