Возвращает инструкцию. 'apartment-search' — как разложить критерии пользователя по инструментам и в каком порядке идти. 'criteria-coverage' — на что livo.ge отвечает, на что отвечает приблизительно, и чего не знает вовсе. Вызывай перед сборкой многокритериального поиска.

Считает результаты по фильтру, не выкачивая их — один дешёвый запрос. Годится, чтобы проверить осмысленность критериев и сравнить варианты фильтра между собой. Возвращает total — полное число объявлений под фильтр.

Ищет объявления на livo.ge. Возвращает частичную выдачу — сравнивай returned с total. Цены отдаются сразу в GEL, USD и EUR. age_days/published — настоящий возраст объявления; updated — правка или платное поднятие, не публикация. applied_filters — эхо самого API о том, что он разобрал из фильтра.

Полная карточка: описание, удобства, координаты, этажность, состояние, кадастр, просмотры, телефон (частично скрыт). Здесь есть created_at — настоящая дата публикации, единственное место, где она приходит явно.

Города, районы и микрорайоны с id. search() принимает названия и резолвит их сам; этот инструмент — посмотреть доступное или снять неоднозначность. С параметром query работает как автодополнение сайта и возвращает готовую связку city/district/urban.

Словари id -> название для фильтров, которые принимают только id: conditions, project_types, heating_types, material_types, metro_stations, amenities и др. Большинство словарей разбиты по типу недвижимости — укажи estate, чтобы получить только применимые значения. Названия приходят на языке сервера (LIVO_LOCALE).

Проекты застройщиков — отдельный набор данных livo, не подмножество объявлений. min_price приходит диапазоном и в трёх валютах. С параметром uuid возвращает карточку одного проекта.