物件情報を絞り込めますか?
はい。GET /v1/properties は以下のフィルターを受け付けます。定義されていないパラメーターは invalid_parameter で拒否され、黙って無視されることはありません。
- country(必須): 国を表す ISO 3166-1 alpha-2 コード。例: TH
- listing_type: all(既定値)、sale、rent のいずれかを指定します
- property_type: 物件の種類をひとつ指定します。例: condominium
- province_id、city_id、area_id: 物件情報に含まれている識別子を使って、場所(州・県、市区町村、地区)を指定します
- city と area: 場所を名前で指定します。大文字と小文字は区別されません
- min_price と max_price: 価格の範囲を、その物件自体の通貨で指定します
- limit: ひとつのページに含める物件の数。リファレンスに記載された上限まで指定できます
- cursor: 前のページで受け取った next_cursor を指定します
city と city_id、area と area_id は、それぞれどちらか一方だけを使ってください。綴りを誤ったパラメーターや不明なパラメーターは、無視されずに invalid_parameter(HTTP 400)で拒否されるため、入力ミスによって絞り込まれていないページが黙って返されることはありません。