メインコンテンツへ移動
Housing Market GroupHousing Market Groupチュートリアル

Housing Market API コース チュートリアル

開発者向けの不動産データ：キー、対応国、プラン、ドキュメント。

開発者、データ チーム向け。4 セクション、チュートリアル 17 本。

概要から始める製品を開く

進み具合: 17 本中 0 本を視聴済み

1. はじめに

  1. Housing Market API のドキュメント、PDF ガイド、請求現在更新中Housing Market API を連携するために必要なものは、すべてコンソールにあります。API が実際に動作しているものと同じ仕様から生成されたドキュメント、ご自身のツールで使える OpenAPI ファイル、そして PDF としてダウンロードできる連携ガイドです。カード情報と請求書もワンクリックで開けます。このチュートリアルでは、ドキュメントを順に見ていき、OpenAPI ファイルとガイドの場所を確認し、請求 (Billing) がどこにあるかをご紹介します。
  2. Housing Market API が対応している国を確認する現在更新中Housing Market API の Coverage（対応国）ページでは、API が対応できるすべての国を地域別に確認できます。地域はアジア太平洋、中東、ヨーロッパ、南北アメリカの四つです。すべての国は Housing Market Group のポータル由来で、国ごと、地域単位、または世界全体の対応をご購入いただけます。Currently updating（更新中）と表示された国はまだ販売対象ではありません。国名をクリックすると、その国のポータルが新しいタブで開き、データの元になっている物件をご覧いただけます。このチュートリアルでは Coverage（対応国）ページを開いて、内容を順に説明します。アカウントは不要です。

2. アカウント

  1. Housing Market API コンソールにサインインする方法現在更新中Housing Market API コンソールは、対象の国とプランを選び、サーバーアドレスを登録し、お支払いを済ませて API キーを確認する場所です。サインインには Housing Market アカウント、つまりポータルや CRM、その他の Housing Market 製品でお使いのメールアドレスとパスワードをそのままお使いいただけます。このチュートリアルでは、コンソールのサインインページを開き、何を入力するのかをご案内し、アカウント作成用のリンクとパスワードをお忘れの場合のリンク、そしてヘッダーの言語メニューをご紹介します。
  2. Housing Market API アカウントの作成方法現在更新中Housing Market API は、Housing Market のポータルに掲載されている物件を国ごとにお使いのソフトウェアへ提供します。まずは API コンソールでアカウントを作成します。このチュートリアルでは、登録ページを開き、メールアドレスとパスワードを入力し、メールで届く確認コードについて説明し、次に何をするかをご紹介します。
  3. Housing Market API コンソールでメールアドレスをリンクで認証する現在更新中アカウントを作成すればすぐに Housing Market API コンソールにサインインできますが、実際に利用できるのはメールアドレスの認証が完了してからです。このチュートリアルでは、まだ認証されていないアドレスでサインインし、Check your email（メールをご確認ください）ページの内容を見て、認証メールを再送し、入力を間違えたアドレスを修正する方法をご紹介します。そのうえで、届いたメールのリンクを開き、そのページのボタンを押します。コードを入力する場所はどこにもありません。
  4. メールリンクで Housing Market API アカウントを作成する方法現在更新中Housing Market API は、Housing Market ポータルに公開されている物件情報を国ごとにお使いのソフトウェアへ提供します。まずは API コンソールでアカウントを作成しましょう。このチュートリアルでは、登録ページを開き、メールアドレスとパスワードを入力し、メールで届く確認リンク（入力するコードはありません）について説明し、その次の手順をご紹介します。

3. プラン、対応国、お支払い

  1. Housing Market API の対象国とプランの選び方現在更新中Housing Market API はカバー範囲に応じて販売されます。国単位、地域全体、または世界全体から選び、月額または年額でご請求します。プランは二つあり、物件情報とその詳細すべてを含む Standard と、提供開始後に市場の集計 Insights が加わる Advanced で、料金はどちらも同じです。このチュートリアルでは、対象国を選び、地域全体と世界全体のオプションを比較し、プランと請求期間を選んで次に進みます。
  2. 国を追加する／Housing Market API プランをアップグレードする方法現在更新中Housing Market API のプランは事業の成長に合わせて拡張できます。国を追加する、地域全体または世界全体に移行する、Advanced に移行する、いずれの場合も入金が確認され次第、同じキーがそのまま対応します。このチュートリアルではプラン変更画面を開き、国を追加し、追加と削除の料金の仕組みを説明します。
  3. Housing Market API の料金：国ごと・地域単位・全世界から選ぶ現在更新中Housing Market API はカバー範囲に応じて販売されます。国ごと、地域全体、または全世界から選べ、月額または年額でのご請求です。プランは二つあり、物件とその詳細すべてをご利用いただける Standard と、公開後に集計された市場 Insights が加わる Advanced で、料金はどちらも同じです。このチュートリアルでは、国を選び、地域と全世界のオプションを比較し、プランと請求期間を選んで次に進みます。
  4. 国を追加する、または Housing Market API のプランをアップグレードする（キーはそのまま）現在更新中Housing Market API のプランは事業の成長に合わせて拡張できます。国を追加する、地域全体または世界全体に移行する、Advanced に移行する、いずれの場合も入金が確認され次第、同じキーがそのまま対応します。このチュートリアルではプラン変更画面を開き、国を追加し、追加と削除の料金の仕組みを説明します。
  5. Housing Market API：お支払いが完了しなかった場合は、もう一度お支払いください現在更新中Housing Market API のプランの初回のお支払いが完了しなかった場合、コンソールのダッシュボードにその旨が表示され、「Pay again」（もう一度支払う）ボタンが用意されます。API キーは作成されておらず、何も保存されていないため、同じカードでも別のカードでも、あらためてお試しいただけます。お支払いが成功した時点で API キーが作成されます。このチュートリアルでは、表示されるメッセージと「Pay again」（もう一度支払う）の遷移先をご紹介します。
  6. Housing Market API：プランの対象国を追加・削除する現在更新中Housing Market API の国別プランでは、Your countries（ご利用の国）ページで対象国を追加・削除できます。課金される前に確認ステップが表示され、何が変わるのか、追加時に今すぐ請求される金額、変更後の料金、適用されるタイミングがわかります。このチュートリアルでは国を追加し、続いて削除の流れを確認します。

4. キーと最初のリクエスト

  1. Housing Market API でサーバー IP を登録する方法現在更新中Housing Market API のキーは、登録した一つのサーバーアドレスからのみ利用できます。また、お支払いの前に API の利用規約に同意していただきます。このチュートリアルでは、サーバーの IP アドレスを入力し、ブラウザーに表示されるアドレスが通常は正しいものではない理由を説明し、規約の手順を確認して、安全な決済ページまで進みます。
  2. Housing Market API キーの取得方法 — 表示は一度だけ現在更新中最初のお支払いが確認されると、Housing Market API キーが発行され、表示されるのは一度だけです。このチュートリアルでは、キーを開いてコピーし、どこに保管するか、どのようにリクエストごとに送信するかを説明します。
  3. Housing Market API への最初のリクエスト現在更新中キーを取得すれば、一度の HTTPS リクエストで、料金を支払った国の物件情報を取得できます。このチュートリアルでは、ドキュメントのリクエスト例を開き、ping でキーを確認し、タイの物件を照会して、レスポンスとカーソルを読み取り、次のページを取得します。
  4. Housing Market API ダッシュボード — 使用状況、キーのローテーション、IP現在更新中Housing Market API のダッシュボードでは、対象範囲、本日と今月の利用量、API キー、そして通信元となるサーバーアドレスを確認できます。このチュートリアルでは、対象範囲と使用状況テーブルの読み方、24 時間の併用期間があるキーのローテーション、登録済みサーバーアドレスの変更方法を解説します。
  5. Housing Market API：コンソールのお知らせ現在更新中Housing Market Group からお伝えすることがある場合、お知らせや計画メンテナンスの予定などが、Housing Market API コンソールのヘッダー下に帯で表示されます。このチュートリアルでは、お知らせの見え方、Learn more（詳細）リンクの開き方、そして邪魔にならないようにそのブラウザーで非表示にする方法をご紹介します。この動画のお知らせはすべて例です。