プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
Realtorの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | keywordに都市名と州を指定して、Realtorで不動産エージェントを検索します。買主・売主のどちらを得意とするかや最低評価で絞り込めます。事務所、ブローカー、免許番号、レビューを取得できます。掲載情報は免許が現在も有効であることを確認するものではなく、エージェントを推薦するものでもありません。 | 1,000リクエストあたり$1.39 | 正常 |
物件検索property_search | keywordに米国のZIPコードまたは「City, ST」形式を指定して、Realtorの住宅物件を検索します。価格、寝室数、浴室数、掲載ステータスでの絞り込みと並び順の指定ができます。掲載価格、成約価格、それぞれの日付は別々のフィールドです。また、結果は物件がまだ販売中であることを保証しません。 | 1,000リクエストあたり$1.39 | 正常 |
物件詳細property_detail | 詳細ページのURL、物件ID、または住所から、Realtorの物件を1件取得します。ステータス、掲載価格と成約価格、売却日、寝室数、浴室数、室内面積（平方フィート）、建築年を取得できます。住宅診断、不動産鑑定、権原調査の代わりにはなりません。 | 1,000リクエストあたり$1.39 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Realtorの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索
| keyword | agent_type, min_rating | Sync配信 | カタログ値：defaultLimit=100、maxLimit=500。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · name · url · title · text · office_name · broker_name · city · state · postal_code · country · license_no · rating · rating_scale · review_count · active_listings · recently_sold · price_min · price_max · specialties · languages · served_areas · emails · phones · image_url · platform |
property_search物件検索
| keyword | baths_min, beds_min, city, max_price, min_price, sort, status | Sync配信 | カタログ値：defaultLimit=20、maxLimit=200。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · url · title · status · price · sold_price · sold_at · listed_at · property_type · beds · baths · area_sqft · lot_sqft · year_built · address · city · state · postal_code · county · lat · lng · image_url · photo_count · is_new_listing · is_price_reduced · is_foreclosure · advertiser_emails · advertiser_phones · platform |
property_detail物件詳細 詳細ページのURL、物件ID、または住所から、Realtorの物件を1件取得します。ステータス、掲載価格と成約価格、売却日、寝室数、浴室数、室内面積（平方フィート）、建築年を取得できます。住宅診断、不動産鑑定、権原調査の代わりにはなりません。 | url | — | Sync配信 | — | 1,000リクエストあたり$1.39 | id · url · title · status · price · sold_price · sold_at · updated_at · property_type · beds · baths · area_sqft · year_built · address · city · state · postal_code · platform |
Realtorのsearchのパラメータはそれぞれどういう意味ですか？
keywordに都市名と州を指定して、Realtorで不動産エージェントを検索します。買主・売主のどちらを得意とするかや最低評価で絞り込めます。事務所、ブローカー、免許番号、レビューを取得できます。掲載情報は免許が現在も有効であることを確認するものではなく、エージェントを推薦するものでもありません。
keyword必須- Realtorリクエストの検索地域を指定します。
searchでは、市と州（例：Austin, TX）を入力してエージェントを検索します。property_searchでは、5桁の米国ZIPコードまたはCity, ST形式の略記を入力します。自由形式の物件説明は指定できません。 agent_type任意searchで使用するエージェントの種類を指定します。指定できる値はboth（買主側・売主側の両方のエージェント、デフォルト）、buyer（買主側エージェントのみ）、seller（売主側エージェントのみ）です。このパラメータは物件の掲載ステータスを表すものではありません。指定可能な値:bothbuyersellerRealtor：買主側エージェントと売主側エージェントの違い — Realtorのエージェント検索では、エージェントをBuy、Sell、Bothに分類しており、買主側エージェントと物件を売り出す売主側エージェントは異なる役割を担うと説明されています。これは不動産エージェントの区分を明確にするもので、EveryInfraが仲介代理サービスを提供していることを示すものではありません。 · 確認日min_rating任意searchで、エージェントを最低評価で絞り込みます。["4"]のような文字列の配列を渡してください。指定できる値は0、1、2、3、4、5で、0を指定すると絞り込みは無効になります。このパラメータはエージェントの評価を絞り込むもので、物件の評価は対象外です。指定可能な値:012345
Realtorのproperty_searchのパラメータはそれぞれどういう意味ですか？
keywordに米国のZIPコードまたは「City, ST」形式を指定して、Realtorの住宅物件を検索します。価格、寝室数、浴室数、掲載ステータスでの絞り込みと並び順の指定ができます。掲載価格、成約価格、それぞれの日付は別々のフィールドです。また、結果は物件がまだ販売中であることを保証しません。
keyword必須- Realtorリクエストの検索地域を指定します。
searchでは、市と州（例：Austin, TX）を入力してエージェントを検索します。property_searchでは、5桁の米国ZIPコードまたはCity, ST形式の略記を入力します。自由形式の物件説明は指定できません。 baths_min任意- バスルームの最小数を設定します。値は整数として扱われるため、1.5のようなハーフバスを含む値は保持できません。
beds_min任意- ベッドルームの最小数を整数で設定します。物件の総部屋数ではありません。
city任意property_searchの市名を上書きします。ZIPコードで検索する場合は、矛盾する地域条件が生じないよう、ZIPコードと食い違う市名を渡さないでください。max_price任意- 標準入力での掲載価格の上限を指定します。同じリクエスト内の
price_maxより優先されます。価格は売買物件と賃貸物件で別々に解釈してください。絞り込みには整数を使用し、小数は切り上げられます（145.98は146になります）。 min_price任意- 標準入力での掲載価格の下限を指定します。同じリクエスト内の
price_minより優先されます。このパラメータは物件価格を絞り込むもので、エージェントの手数料は対象外です。絞り込みには整数を使用し、小数は切り捨てられます（39.81は39になります）。 sort任意property_searchの並び順で、常に降順です。newest（新しい掲載順、デフォルト）、price_desc（掲載価格）、sold_price_desc（成約価格）、recently_sold、bedrooms_desc、lot_size_desc、photo_count_desc、recently_updatedを指定できます。昇順のオプションはないため、価格の安い順に並べることはできません。指定可能な値:bedrooms_desclot_size_descnewestphoto_count_descprice_descrecently_soldrecently_updatedsold_price_descstatus任意property_searchで使用する掲載ステータスを1つ、文字列で指定します。デフォルトはfor_saleです。既知の値はsold、for_rent、ready_to_build、off_market、other、new_communityです。値は固定リストと照合されないため、それ以外の文字列も拒否されません。配列ではなく、単一のステータスを送信してください。
Realtorのproperty_detailのパラメータはそれぞれどういう意味ですか？
詳細ページのURL、物件ID、または住所から、Realtorの物件を1件取得します。ステータス、掲載価格と成約価格、売却日、寝室数、浴室数、室内面積（平方フィート）、建築年を取得できます。住宅診断、不動産鑑定、権原調査の代わりにはなりません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況url必須property_detailで使用するRealtorの詳細URLを指定します。property_idを抽出するため、URLには_M<digits>-<digits>形式のサフィックスが含まれている必要があります。このフィールドには物件IDまたは完全な住所を渡すこともできます。抽出可能なIDを含まないその他のURLは、解決できる保証がありません。
Realtor APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"realtor","action":"search","params":{"keyword":"<keyword>"}}'
Realtor APIに関する質問
Realtor APIでは何を取得できますか？
platformをrealtorに設定します。現在のカタログには検索、物件検索、物件詳細が掲載されています。これらのアクション名はそれぞれ異なるRealtorのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Realtorのsearchリクエストを開始するには、どの入力を使用しますか？
Realtorリクエストの検索地域を指定します。searchでは、市と州（例：Austin, TX）を入力してエージェントを検索します。property_searchでは、5桁の米国ZIPコードまたはCity, ST形式の略記を入力します。自由形式の物件説明は指定できません。params内のkeywordとして送信してください。
Realtorのsearchはどのフィールドを返しますか？
宣言されたスキーマにはname、title、text、office_nameが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Realtorのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。