API v1.0 — Public Beta

解体費用3秒診断 API

建物の解体費用を都道府県・構造・面積から即座に見積もるAPI。無料で利用可能。出典リンクの表記をお願いします。

# Quick Start

curl
curl "https://kaitai.xyz/api/v1/estimate?prefecture=東京都&structure=wood&area_tsubo=30"
Response
{
  "status": "ok",
  "data": {
    "estimated_cost_min": 1200000,
    "estimated_cost_max": 1800000,
    "estimated_cost_avg": 1500000,
    "unit_cost_per_tsubo": 45000,
    "breakdown": {
      "demolition": 900000,
      "waste_disposal": 350000,
      "temporary_works": 150000,
      "misc": 100000
    },
    "prefecture": "東京都",
    "structure": "wood",
    "area_tsubo": 30,
    "currency": "JPY"
  },
  "meta": {
    "api_version": "1.0",
    "source": "https://kaitai.xyz"
  }
}

# Authentication

認証不要。APIキーなしで利用できます。すべてのエンドポイントはパブリックアクセス可能です。

# Endpoints

GETPOST/api/v1/estimate

解体費用の見積もりを取得します。GETはクエリパラメータ、POSTはJSONボディで送信。

GET/api/v1/prefectures

対応都道府県の一覧と地域別単価データを取得します。

# Parameters

NameTypeRequiredDescriptionExample
prefecturestringrequired都道府県名東京都
structurestringrequired建物構造 (wood / steel / rc / src)wood
area_tsubonumberrequired延床面積（坪）30
floorsnumberoptional階数（デフォルト: 2）2
build_yearnumberoptional築年（西暦）1990
has_asbestosbooleanoptionalアスベスト含有の有無false
road_widthnumberoptional前面道路幅（m）4
leftoverbooleanoptional残置物の有無false

# Response Format

200 OK — application/json
{
  "status": "ok",
  "data": {
    "estimated_cost_min": 1200000,
    "estimated_cost_max": 1800000,
    "estimated_cost_avg": 1500000,
    "unit_cost_per_tsubo": 45000,
    "breakdown": {
      "demolition": 900000,
      "waste_disposal": 350000,
      "temporary_works": 150000,
      "misc": 100000
    },
    "prefecture": "東京都",
    "structure": "wood",
    "area_tsubo": 30,
    "currency": "JPY"
  },
  "meta": {
    "api_version": "1.0",
    "source": "https://kaitai.xyz"
  }
}
400 Bad Request
{
  "status": "error",
  "error": {
    "code": "INVALID_PARAMS",
    "message": "prefecture is required. structure must be one of: wood, steel, rc, src"
  }
}

# Rate Limits

100
requests / minute

IPアドレスごとに1分間100リクエストまで。制限を超えた場合は429 Too Many Requestsが返されます。

# Attribution

APIを利用する際は、出典リンクの表記をお願いします。以下のHTMLスニペットをご利用ください。

HTML
<a href="https://kaitai.xyz" target="_blank" rel="noopener">
  解体費用データ提供: kaitai.xyz
</a>

# Code Examples

JavaScript (fetch)
const params = new URLSearchParams({
  prefecture: '東京都',
  structure: 'wood',
  area_tsubo: '30',
});

const res = await fetch(`https://kaitai.xyz/api/v1/estimate?${params}`);
const data = await res.json();

console.log(data.data.estimated_cost_avg);
// => 1500000
Python (requests)
import requests

resp = requests.get("https://kaitai.xyz/api/v1/estimate", params={
    "prefecture": "東京都",
    "structure": "wood",
    "area_tsubo": 30,
})
data = resp.json()

print(data["data"]["estimated_cost_avg"])
# => 1500000
PHP
<?php
$query = http_build_query([
    'prefecture' => '東京都',
    'structure'  => 'wood',
    'area_tsubo' => 30,
]);

$json = file_get_contents("https://kaitai.xyz/api/v1/estimate?{$query}");
$data = json_decode($json, true);

echo $data['data']['estimated_cost_avg'];
// => 1500000
無料で解体費用を診断する