セルフサービスの不動産データ API
Housing Market Group のポータルの物件情報と市場データ。API はひとつ。
コンソールで申し込み、国とティアを選び、サーバーを登録して支払えば、キーはすぐに有効になります。どちらのティアもすべての物件詳細を含む物件情報を返し、アドバンストでは、集計された市場インサイトの提供開始後すぐに、同じキーでそれらも利用できます。後から国を追加しても、同じキーで利用できます。
curl -H "x-api-key: $HMA_API_KEY" \
"https://api.housingmarketapi.com/v1/properties?country=TH&listing_type=sale&property_type=condominium&limit=100"ご利用の流れ
営業担当との商談なしで、登録から最初のリクエストまで
対応範囲を選ぶ
国を一つずつ、地域、または全世界から選び、次にスタンダードかアドバンストかを選びます。請求は月払いまたは年払いです。
サーバーを登録する
キーは登録した IP アドレスからのリクエストにのみ応答するため、ほかの場所からは使用できません。
規約に同意して支払う
API 利用規約を読んで同意し、支払いを行います。支払いが完了するとすぐにキーが作成され、一度だけ表示されます。
API を呼び出す
キーを x-api-key ヘッダーで送信すると、JSON が返されます。後から国を追加したりアップグレードしたりしても、同じキーで利用できます。
二つのティア、同じ料金
API が返す内容を選ぶ
どのプランでも、二つのティアは同じ料金です。後からアップグレードしても、同じキーで利用できます。
スタンダード
リファレンスに記載されたすべての物件詳細を含む、公開中の物件情報。
アドバンスト
スタンダードのすべての内容に加え、Insights(場所と期間ごとに集計された市場データ)を近日提供予定です。アドバンストのお客様は、Insights の提供開始後すぐに同じキーで利用できます。
組み込みのための設計
コピーするためではなく、その上に構築するために
カーソル方式のページネーション
カーソルをたどってページを順に読み進めます。ページ番号、総件数、一括エクスポートはありません。
プランに合わせて範囲が設定された、ひとつのキー
キーには、ご契約の国とティアが設定されています。国の追加やアップグレードは、支払いが確認され次第、同じキーに適用されます。
分岐に使えるエラー
すべてのエラーには HTTP ステータスと変わることのないコードが含まれ、ドキュメントのどの言語でも同一です。
機械可読な仕様
OpenAPI 3.1 ファイル、そこから生成されたリファレンス、そしてオンラインで読むことも PDF でダウンロードすることもできる導入ガイドを用意しています。
データについて率直に
得られるもの、そしてデータでできること
- 説明文から連絡先は削除されており、どのティアでも掲載者、仲介会社、所有者、問い合わせのデータは返されません。
- 所有者自身が掲載した住宅は、番地を除き、所在地を粗くした形で返されます。
- 現在、物件情報には画像が含まれていません。画像リンクは今後提供予定です。元の写真はポータル上で引き続き公開されています。
- データは自社製品の中で利用するためのものです。再販売、データセットとしての再公開、第三者への提供はできません。
対応範囲
国ごと、地域ごと、または全世界で購入
すべての国のデータは Housing Market Group のポータルから提供されます。単独で販売できるだけの物件掲載数がまだない国には「近日対応」と表示されています。
アジア太平洋
アジア、オーストラリア、ニュージーランド、太平洋地域
- Australia
- Cambodia
- China
- Hong Kong
- India近日対応
- Indonesia
- Japan
- Malaysia
- Philippines
- Singapore
- Taiwan近日対応
- Thailand
- Vietnam
中東
エジプトを含む
- Bahrain近日対応
- Dubai, UAE
- Egypt
- Oman
- Qatar
- Saudi Arabia近日対応
ヨーロッパ
トルコとキプロスを含む
- Cyprus
- Germany
- Spain
- Turkey
- United Kingdom
南北アメリカ
北米、中米、南米(ハワイは米国として扱います)
- Argentina
- Brazil
- Canada近日対応
- Colombia
- Mexico
- Panama
- Paraguay
- United States
- Uruguay
- Venezuela