本文へスキップ

Blog / 業界動向

不動産情報ライブラリのAPIで何ができるか — 取引価格データを鑑定実務で使うための仕組み・限界・前処理

不動産情報ライブラリのAPIで何ができるか — 取引価格データを鑑定実務で使うための仕組み・限界・前処理

「国交省が取引価格のデータを公開している。APIで一括取得できるらしい」

そう聞いて期待した方は多いのではないでしょうか。事例収集は鑑定評価の土台であり、同時に最も時間を食う工程です。それが自動で取れるなら、実務の形が変わります。

ただ、実際に触ると話はそう単純ではありませんでした。取得したデータには2つの出所が混在し、粒度も充足率も項目によってまったく違います。「そのまま事例として使える」という期待で臨むと、必ず裏切られます。

本記事では、当事務所が国土交通省「不動産情報ライブラリ」のAPIを実際に叩き、事例整理の下ごしらえに使ったときの経験をもとに、このAPIで何ができて、何ができないのかを率直に整理します。

第1章: 不動産情報ライブラリのAPIとは何か

Webサイトの裏側がそのまま開放されている

不動産情報ライブラリは、取引価格・地価公示・都市計画・ハザード情報などを地図上で閲覧できる国土交通省のWebサイトです。このサイトが内部で使うデータが、そのままAPI(アプリケーション・プログラミング・インターフェース。ソフトウェア同士がデータをやり取りする接続口)として公開されています。国土交通省「不動産情報ライブラリ API操作説明」によれば公開APIは31種類、価格情報から都市計画・周辺施設・防災情報まで揃います。

鑑定実務で効くのは、まず3つ

31種類すべてを追う必要はありません。鑑定実務で使い出があるのは、実感としては次の3つです。

  • XIT001(不動産価格情報取得): 取引価格情報・成約価格情報を四半期単位で取得する。本記事の主役
  • XCT001(鑑定評価書情報): 地価公示・地価調査の標準地について、鑑定評価書の内容を取得する
  • XPT002(地価公示・地価調査ポイント): 標準地・基準地の位置情報を取得する

特にXCT001は鑑定士にとって見逃せません。1平方メートル当たりの価格や公示価格だけでなく、取引事例比較法・収益還元法・原価法・開発法による各価格、標準地の地積・形状・方位・接面道路状況、用途地域・建蔽率・容積率まで返ります。対象は最新年から5年分です。

利用申請とキーの発行

利用にはAPIキーの申請が必要です。「API利用申請」ページから氏名・メールアドレス・利用目的などを記入して申請し、審査結果は申請後5営業日を目安にメールで通知されます。発行されたキーはリクエストヘッダの Ocp-Apim-Subscription-Key に設定して送信します。キーは秘密情報ですので、コードに直接書き込まず環境変数やシークレット管理機能に入れてください。

第2章: 取引価格情報と成約価格情報は別物です

ここが最初の、そして最大のつまずきどころです。

アンケート由来と、レインズ由来

XIT001が返すデータには、性格の異なる2種類が混在しています。

区分出所対象期間
不動産取引価格情報登記情報をもとにした取引当事者へのアンケート回答2005年以降
成約価格情報レインズ(指定流通機構)に登録された成約情報2021年以降

前者はアンケートに答えた方の分だけが集まるため回収率の影響を受け、後者は仲介を介した成約が源泉です。母集団が異なり、混ぜて平均を取ると意味の読めない数字になります。

パラメータで出し分ける

XIT001のリクエストは year(西暦4桁)と quarter(1〜4)が必須で、加えて area(都道府県コード)、city(市区町村コード)、station(駅コード)のいずれか1つ以上が必要です。

出し分けは priceClassification で行います。「01」で取引価格情報のみ、「02」で成約価格情報のみ、指定しなければ両方が返ります。指定しないのが既定である点が落とし穴です。 当事務所では原則として「02」を明示し、成約価格情報だけを扱っています。

公開のタイミングと、乗り越えられないラグ

データの更新は四半期ごと、4月・7月・10月・1月です。取引時点から公開までは概ね2四半期程度のラグが生じ、これは工夫で縮められるものではありません。直近の市場動向を追う用途には、このデータは向きません。 当事務所はこのAPIを「直近の答え」ではなく「背景の相場観を厚くする材料」と位置づけ、時点修正や市場の肌感は別の情報源で補っています。

第3章: 実装でつまずく4つの罠

当事務所が実際に詰まった点を、そのまま共有します。

罠1: レスポンスはgzip圧縮で返る

APIの出力はgzip(データ圧縮形式)でエンコードされています。素朴にHTTPリクエストを投げると読めないバイト列が返ります。curl なら --compressed オプション、プログラムから叩くなら圧縮解除に対応した設定が必要です。

罠2: データが無い期間は空配列ではなく404

多くのAPIは「該当データなし」を空配列で返しますが、XIT001・XIT002・XCT001はHTTPステータス404を返します。「404なら異常終了」と書くと、データが無いだけの四半期でプログラム全体が止まります。404はデータ無しとして正常に読み飛ばす設計にしてください。

罠3: 地区名・地区コードの連続性は保証されない

API操作説明には、地区コード・地区名が更新時に変更される場合があり連続性は保証しないと明記されています。過去分を蓄積して時系列で追うなら、コードの変化を検知して名寄せする仕組みが要ります。同じ地区が別々の集計単位に分かれ、母数が薄くなるためです。

罠4: 連続リクエストにはアクセス制限がかかる

明示的な上限値は公表されていませんが、同一APIキーで短期間に多数のリクエストを送るとアクセス制限が設けられる旨が案内されています。間隔を空けた逐次取得と、途中から再開できる設計が安全です。

第4章: 当事務所が事例整理に使ったときの前処理

取得できただけでは使えません。前処理の設計こそが、このデータの価値を決めます。

設計1: 成約価格情報だけに絞る

前述のとおり priceClassification を「02」に固定します。母集団を揃えることが、その後の集計すべての前提です。

設計2: 区平均は使わない。地区の粒度で集計する

これが実務上いちばん重要な判断でした。当事務所が2026年7月に江東区のマンション成約データを地区別に集計したところ、次の差が出ています。

地区平均単価(1平方メートル当たり)区平均との関係
豊洲約193万円大幅に上回る
東砂約82万円大幅に下回る

同じ区の中で2倍を超える開きがあります。区の平均値は、どちらの地区の実態も表していません。 集計はレスポンス項目の DistrictNameDistrictCode の粒度で行うべきで、区平均は鑑定評価の検討材料としては使えないと考えています。

設計3: 充足率の低い項目は補正に使わない

成約価格情報を項目別に見ると、地区名・価格・間取り・面積・築年はほぼ100パーセント埋まる一方、リフォームの有無・方位・階数はほとんど空欄でした。

したがって当事務所は補正の軸を地区・築年帯・面積帯の3つに置いています。空欄の多い項目を無理に補正要因へ組み込むと、母数が激減するか欠測を推測で埋めることになります。後者は最も避けるべき処理です。

想定されるケース: 件数が確保できるかを先に確かめる

たとえば「江東区・豊洲・築15〜25年・専有面積60〜80平方メートル」という条件で直近2年(8四半期)分を集計するとします。ここで確認すべきは平均値より先に件数です。該当が5件しかなければ、その平均は1件の特殊な取引で簡単に動きます。

当事務所では集計表に必ず件数列を置き、件数が一定数に満たないセルは数値を出さず「サンプル不足」と表示させています。自動化すると、もっともらしい平均値だけが並ぶ表ができあがりがちです。判断を誤らせない表を作ることまでが前処理だと考えています。この種の一覧化と検算の型は取引事例の整理を自動化した手順でも紹介しています。

第5章: 鑑定実務で採用可否を判断するときの留意点

取引事例そのものではなく、相場の背景

不動産鑑定評価基準は、取引事例比較法において事例の適格性(取引事情の正常性、時点修正の可能性、地域要因・個別的要因の比較が可能であること)を求めています。APIから得られるデータは所在が地区名までの粒度で、個別の物件を特定できず、取引事情が正常であったかも確認できません。前面道路の状況、隣地との関係、法令上の制限の内容、建物の維持管理状態といった価格を左右する要素も、レスポンスには含まれません。

したがって当事務所は、このデータを比準の対象となる取引事例そのものとしては扱っていません。地域の価格水準や推移を把握する背景資料、そして収集した事例の水準が地域の実態から外れていないかを確かめる検算材料、という位置づけです。役所調査や現地調査を置き換えるものではないと、はっきり申し上げます(役所調査側の効率化は役所調査でAIをどこまで使えるかで別途整理しています)。

採否の判断は鑑定士が行う

データ取得と集計は自動化できます。しかし、どの水準を採用し、どう補正し、結論にどう反映するかは鑑定士の判断であり、不動産鑑定士の独占業務の中核です。当事務所は自動化の範囲を「集計表ができるまで」と線引きしています。生成AIに集計や要約を任せる場合、出力をそのまま信じず元データと突き合わせる工程が不可欠です。詳しくは生成AIのハルシネーション対策をご覧ください。

まとめ

不動産情報ライブラリのAPIは、事例収集の下ごしらえを大きく軽くする道具です。ただしそのまま事例として使える代物ではなく、前処理の設計と鑑定実務上の線引きがあって初めて役に立ちます。

要点を振り返ります。

  • 公開APIは31種類。鑑定実務で効くのはXIT001(価格情報)、XCT001(鑑定評価書情報)、XPT002(地価公示ポイント)
  • XIT001には「不動産取引価格情報」(アンケート由来・2005年以降)と「成約価格情報」(レインズ由来・2021年以降)が混在する。priceClassification で明示的に絞る
  • 実装の罠は4つ。gzip圧縮、データ無しは404、地区コードの連続性が非保証、連続リクエストへのアクセス制限
  • 更新は4月・7月・10月・1月の四半期ごとで、取引時点から概ね2四半期のラグがある。直近の市場動向を追う用途には向かない
  • 区平均は使わない。集計は地区の粒度で行い、件数が不足するセルは数値を出さない
  • 得られるのは比準対象の取引事例そのものではなく、地域の価格水準を把握する背景資料と検算材料

事例収集に時間を取られている鑑定士の方、価格データを社内システムに取り込みたい不動産会社の経営者様にとって、このAPIは検討に値する選択肢です。ただし申請・実装・前処理・評価上の線引きまでを一人で組み立てるのは、決して軽い作業ではありません。

当事務所は鑑定事務所として自らこのAPIを叩き、前処理を設計し、実務に乗せてきました。データ取得の自動化やAI活用のご相談は、その使い込んだ経験をもとにお応えします。無料相談をご利用ください。AI活用の考え方をまとめた無料資料もこちらからダウンロードいただけます。

吉田 健人

代表取締役社長・不動産鑑定士

吉田 健人

外資IT企業でデータ分析・クラウドサービスの営業に従事した後、不動産鑑定士として独立。鑑定実務とITの両面の経験を活かし、同業の鑑定士事務所のIT化を支援している。

Free Consultation

まずは無料相談から
お気軽にお問い合わせください

「何から始めればよいか」「今のサイトを診断してほしい」「費用感だけ知りたい」——そんなご相談だけでも歓迎です。鑑定士同士、業界の文脈を共有できる安心感のある相談時間をお約束します。

営業時間: 平日 9:00〜18:00

電話で相談無料相談