GET /mls/properties — поиск объектов

Поиск объектов в MLS-каталоге с фильтрацией и пагинацией.

Доступ

Публичный. Аутентификация не требуется.

Параметры запроса

Параметр	Тип	По умолчанию	Описание
city_id	integer	—	Фильтр по городу
property_type_id	integer	—	Фильтр по типу объекта
deal_type_id	integer	—	Фильтр по типу сделки
tenant_id	integer	—	Фильтр по тенанту-владельцу
min_price	decimal	—	Минимальная цена
max_price	decimal	—	Максимальная цена
limit	integer	50	Количество результатов (1–100)
offset	integer	0	Смещение для пагинации

Все параметры опциональны. Без фильтров возвращаются все объекты на MLS.

Ответ

{
  "items": [
    {
      "id": 42,
      "property_type": { "id": 1, "name": "Квартира" },
      "deal_type": { "id": 1, "name": "Продажа" },
      "city": { "id": 1, "name": "Лимассол" },
      "district": { "id": 5, "name": "Центр" },
      "residential_complex": null,
      "price": 250000.00,
      "area": 85.5,
      "rooms": 3,
      "floor": 4,
      "total_floors": 10,
      "thumbnail_url": "https://cdn.estatekit.io/images/42/thumb.jpg",
      "created_at": "2026-02-10T14:30:00+00:00"
    }
  ],
  "total": 128,
  "limit": 50,
  "offset": 0
}

Поля объекта

Поле	Тип	Описание
id	integer	ID объекта
property_type	object	Тип объекта (id, name)
deal_type	object	Тип сделки (id, name)
city	object	Город (id, name)
district	object | null	Район
residential_complex	object | null	Жилой комплекс
price	decimal | null	Цена
area	decimal | null	Площадь (м²)
rooms	integer | null	Количество комнат
floor	integer | null	Этаж
total_floors	integer | null	Этажность дома
thumbnail_url	string | null	URL превью
created_at	datetime	Дата создания