APIドキュメント

FUDOSAN DB REST API v1 の利用方法

概要

FUDOSAN DB APIは、国交省不動産情報ライブラリのデータを構造化して提供するREST APIです。JSON形式でレスポンスを返します。

Base URL: https://fudosandb.jp/v1
Content-Type: application/json
            

認証

全てのAPIリクエストにはAPIキーが必要です。X-API-Key ヘッダーで送信してください。

curl -H "X-API-Key: YOUR_API_KEY" \
  https://fudosandb.jp/v1/municipalities
            

APIキーは開発者ページから無料で取得できます。

レート制限

プランごとにリクエスト上限が設定されています。

プラン	月間上限	日次上限
Free	100	3,000
Pro	10,000	30,000
Business	100,000	300,000

エラーレスポンス

{
  "status": "error",
  "error": "Municipality 99999 not found"
}
            

コード	説明
400	不正なリクエストパラメータ
401	APIキーが無効または未指定
404	リソースが見つからない
429	レート制限超過
500	サーバーエラー

エリアプロファイル

GET /v1/area-profile/{municipality_code} 市区町村の概要データ

パラメータ

名前	型	必須	説明
municipality_code	string	必須	5桁の市区町村コード（例: 13101）

レスポンス例

{
  "status": "ok",
  "data": {
    "municipality_code": "13101",
    "prefecture_name": "東京都",
    "municipality_name": "千代田区",
    "total_transactions": 4521,
    "median_price": 89500000,
    "latest_land_price": 5280000,
    "land_price_yoy": 3.2
  }
}
                        

エリア検索

GET /v1/area-profiles エリア一覧・検索

名前	型	必須	説明
prefecture	string	任意	都道府県名でフィルタ
q	string	任意	市区町村名で検索
page	int	任意	ページ番号（デフォルト: 1）
per_page	int	任意	1ページあたり件数（デフォルト: 50、最大: 200）

価格推移

GET /v1/price-trends/{municipality_code} 四半期ごとの取引価格推移

名前	型	必須	説明
municipality_code	string	必須	5桁の市区町村コード
property_type	string	任意	物件種別でフィルタ（宅地(土地), 中古マンション等など）

地価推移

GET /v1/land-price-trends/{municipality_code} 年次の地価推移

名前	型	必須	説明
municipality_code	string	必須	5桁の市区町村コード

名前	型	必須	説明
metric	string	必須	ランキング指標
limit	int	任意	取得件数（デフォルト: 20）

市区町村一覧

GET /v1/municipalities 市区町村マスタ

名前	型	必須	説明
prefecture	string	任意	都道府県名でフィルタ

賃料推定

POST /v1/estimate-rent 賃料推定（v5 Ensemble）

LightGBM + XGBoost Ensembleモデル（v5）による賃料推定。全国385K件の賃貸物件データ + 13データソースの特徴量で学習。都市部MAPE=2.1%、地方MAPE=2.6%。

パラメータ（JSON body）

名前	型	必須	説明
municipality_code	string	必須	市区町村コード（5桁。例: 13101=千代田区）
area_m2	number	必須	専有面積（m²）
layout	string	任意	間取り（1K, 1LDK, 2DK, ワンルーム等）
build_age_years	integer	任意	築年数
walk_min	integer	任意	最寄駅徒歩分数
floor	integer	任意	所在階
total_floors	integer	任意	建物階数
category	string	任意	物件種別（マンション/アパート等、デフォルト: マンション）

リクエスト例

curl -X POST https://fudosandb.jp/v1/estimate-rent \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"municipality_code":"13101","area_m2":25,"layout":"1K","build_age_years":10,"walk_min":5}'

レスポンス例

{
  "status": "ok",
  "data": {
    "estimated_rent_yen": 72109,
    "estimated_rent_manyen": 7.21,
    "confidence": {
      "model": "v5_noleak_urban",
      "mae_manyen": 0.211,
      "mape_percent": 2.1,
      "range_low_yen": 69999,
      "range_high_yen": 74219
    },
    "time_adjustment": {
      "training_date": "2026-03",
      "land_price_yoy_rate": 0.1139,
      "rent_adjustment_rate": 0.057,
      "base_estimate_yen": 68224
    }
  }
}

モデル精度

モデル	MAE（万円）	MAPE	R²	対象
v5_noleak_urban	0.211	2.1%	0.977	都市部9都府県
v5_noleak_rural	0.138	2.6%	0.943	地方38道県

精度の詳細はモデル精度検証ページを参照

MCP接続

FUDOSAN DBはModel Context Protocol（MCP）に対応しています。Claude DesktopなどのAIツールから直接接続できます。

Claude Desktop での設定

claude_desktop_config.json に以下を追加:

{
  "mcpServers": {
    "fudosandb": {
      "command": "npx",
      "args": ["mcp-remote", "https://fudosandb.jp/mcp"]
    }
  }
}
            

設定後、Claude Desktopで「渋谷区の不動産相場を教えて」や「千代田区の1K 25m2の賃料を推定して」のように質問するとデータを取得できます。

利用可能なMCPツール

ツール名	説明
search_areas	エリア名で市区町村を検索
get_area_profile	エリアプロファイル取得
get_price_trends	価格推移データ取得
get_land_price_trends	地価推移データ取得
get_rankings	ランキング取得
list_municipalities	市区町村一覧
estimate_rent	賃料推定（v5 Ensemble、MAPE 2.1〜2.6%）

APIドキュメント

概要

認証

レート制限

エラーレスポンス

エリアプロファイル

パラメータ

エリア検索

価格推移

地価推移

ランキング

市区町村一覧

賃料推定

パラメータ（JSON body）

リクエスト例

レスポンス例

モデル精度

MCP接続

Claude Desktop での設定

利用可能なMCPツール