MLS-каталог
MLS (Multiple Listing Service) — общая база объектов недвижимости, доступная всем участникам системы. Каждый листинг-агент публикует свои объекты, а другие участники могут их находить и запрашивать контакты собственников.
Что видно в каталоге
В MLS попадают объекты, прошедшие проверку и одобренные. Для каждого объекта доступны: тип, тип сделки, город, район, цена, площадь, количество комнат, этаж и превью фото.
Контактные данные собственника в каталоге не отображаются — их нужно запрашивать отдельно.
Поиск объектов
Любой клиент (бот, сайт, CRM) может искать объекты в каталоге без аутентификации. Доступна фильтрация по городу, типу объекта, типу сделки, диапазону цен и листинг-агенту.
Защита контактных данных
Контактные данные собственника — ключевой актив системы. Доступ к ним контролируется на нескольких уровнях.
Изоляция контактов
Контакт собственника не возвращается ни в поиске, ни в карточке объекта. Получить имя и телефон можно только через отдельный авторизованный эндпоинт.
Аудит-трейл
Каждый запрос контакта логируется и публикуется как событие contact_request.received. Собственник может подписаться на это событие через уведомления и отслеживать, какие агентства интересуются его объектами.
Дедупликация: повторный запрос контакта того же объекта тем же тенантом в течение 24 часов возвращает данные, но не создаёт новую запись в логе и не расходует лимит. Через 24 часа запрос считается новым.
Лимиты
По умолчанию тенант может запросить 5 новых контактов в день. Лимит настраивается индивидуально. При превышении API возвращает 429 Too Many Requests.
Конверсионный контроль
Система отслеживает конверсию: соотношение запрошенных контактов к отчётам об исходе. Тенант обязан отчитываться о результате работы с каждым контактом через эндпоинт отчёта об исходе.
Если за последнюю неделю менее 10% запрошенных контактов имеют положительный исход — доступ к контактам блокируется (403 Forbidden).