Tôi có thể lọc tin đăng không?
Có. GET /v1/properties chấp nhận các bộ lọc được liệt kê dưới đây. Tham số không được định nghĩa sẽ bị từ chối với invalid_parameter, không bao giờ bị bỏ qua một cách âm thầm.
- country (bắt buộc): mã ISO 3166-1 alpha-2 của quốc gia, ví dụ TH
- listing_type: all (mặc định), sale hoặc rent
- property_type: một loại bất động sản, ví dụ condominium
- province_id, city_id và area_id: một địa điểm, theo mã định danh có trong tin đăng
- city và area: một địa điểm, theo tên, không phân biệt chữ hoa chữ thường
- min_price và max_price: một khoảng giá, theo đơn vị tiền tệ của chính tin đăng
- limit: số tin đăng trong một trang, tối đa theo mức nêu trong tài liệu tham chiếu
- cursor: giá trị next_cursor từ trang trước
Dùng city hoặc city_id, và area hoặc area_id, không dùng cả hai. Tham số viết sai chính tả hoặc không xác định sẽ bị từ chối với invalid_parameter (HTTP 400) thay vì bị bỏ qua, nên một lỗi đánh máy không thể âm thầm trả về một trang chưa được lọc.