GeoAlpha API v1

機関投資家・不動産デベロッパー向けに、Alpha Score（地価の割安・割高指標）と施設充実度スコアを JSON / GeoJSON 形式で提供します。
XGBoost モデル（R²=0.750、OOT R²=0.552）で算出した理論地価と実取引価格の乖離を定量化しています。

CORS 対応GeoJSON 対応Bearer 認証

ベース URL

https://geoalpha.h-hirata.com

認証

すべてのリクエストに API キーが必要です。以下の 2 通りで渡せます。

① Authorization ヘッダー（推奨）

Authorization: Bearer YOUR_API_KEY

② クエリパラメータ

GET /api/v1/scores?api_key=YOUR_API_KEY&city=福岡市

API キーの発行はお問い合わせください。

エンドポイント

GET/api/v1/scoresAlpha Score データを取得

クエリパラメータ

パラメータ	型	デフォルト	説明
`city`	string	福岡市	市区町村名（前方一致）。例: 福岡市博多区、北九州市
`year`	integer	2025	取引年。2020〜2025 が有効。
`minAlpha`	float	-1	Alpha Score 下限（−1〜+1）
`maxAlpha`	float	1	Alpha Score 上限（−1〜+1）
`limit`	integer	2000	最大取得件数（上限 5,000）
`format`	string	json	"json" または "geojson"。GeoJSON は GIS ツール連携用。

使用例

福岡市博多区の割安物件（Alpha > 0.2）を取得

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://geoalpha.h-hirata.com/api/v1/scores?city=福岡市博多区&minAlpha=0.2&year=2024&limit=100"

GeoJSON 形式で取得（QGIS・MapLibre GL JS と直接連携）

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://geoalpha.h-hirata.com/api/v1/scores?city=福岡市&format=geojson&year=2024"

Python での利用例

import requests

resp = requests.get(
    "https://geoalpha.h-hirata.com/api/v1/scores",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={
        "city": "福岡市",
        "minAlpha": 0.3,
        "year": 2024,
        "limit": 500,
    },
)
data = resp.json()
print(f"{data['meta']['count']} 件取得")
for row in data["data"]:
    print(row["municipality"], row["address"], row["alpha_score"])

レスポンス形式（JSON）

{
  "data": [ /* AlphaScorePoint の配列 */ ],
  "meta": {
    "count": 240,
    "city": "福岡市",
    "year": 2024,
    "alpha_range": [-1, 1],
    "generated_at": "2026-04-08T00:00:00.000Z",
    "api_version": "1.0"
  }
}

AlphaScorePoint フィールド

フィールド	型	説明
`id`	string	取引 ID（UUID）
`prefecture`	string	都道府県名（例: 福岡県）
`municipality`	string	市区町村名（例: 福岡市博多区）
`district_name`	string	地区名・大字
`address`	string	住所（丁目レベル）
`latitude`	number	緯度（WGS84）
`longitude`	number	経度（WGS84）
`price_per_sqm`	number	実取引価格（円/㎡）
`theoretical_price`	number	XGBoost 理論地価（円/㎡）
`alpha_score`	number	Alpha Score = log(theoretical / market)。正値=割安、負値=割高。範囲: −1 〜 +1
`percentile`	number	Alpha Score パーセンタイル（0〜100）
`convenience_score`	number	施設充実度スコア（重力モデル合算）
`land_area`	number	土地面積（㎡）
`total_price`	number	取引総額（万円）
`transaction_year`	integer	取引年
`transaction_quarter`	integer	取引四半期（1〜4）
`land_use`	string	土地利用種別
`coverage_ratio`	number	建蔽率（%）
`floor_area_ratio`	number	容積率（%）
`station_count`	integer	800m圏内の駅数
`supermarket_count`	integer	800m圏内のスーパー数
`convenience_store_count`	integer	800m圏内のコンビニ数
`school_count`	integer	800m圏内の学校数
`hospital_count`	integer	800m圏内の病院数
`park_count`	integer	800m圏内の公園数
`restaurant_count`	integer	800m圏内の飲食店数

モデル精度・データ仕様

学習データ

国交省 REINFOLIB 164,615件

福岡県全域 2020〜2025年

モデル

XGBoost（3サブモデル）

土地 / 土地+建物 / マンション別学習

CV精度（全データ）

R² = 0.750

5-fold Cross Validation

Out-of-time精度

R² = 0.552

2021以前学習 → 2022以降89,864件テスト

特徴量

43次元

重力スコア・ハザード・用途地域・人口統計・公示地価等

Alpha Score 定義

log(理論地価 / Kriging市場実勢価)

正値=割安、負値=割高、範囲: −1 〜 +1

カバレッジ: 現在は福岡県対応（β版）。東京23区・大阪府は順次対応予定。

エラーコード

HTTP ステータス	説明
`200 OK`	正常取得。data 配列が空の場合は条件に一致するデータなし。
`401 Unauthorized`	API キーが未指定または無効。
`500 Internal Server Error`	DB クエリエラー。error フィールドにメッセージ。

API キーの発行・導入相談

アカウント登録でお問い合わせ