Автоматические выгрузки CMNS_API |
Используя CMNS_API Вы можете настроить интеграцию с базой объектов и клиентов Вашего агентства, после чего все объявления публикуемые собственниками, на любых популярных досках объявлений, практически мгновенно появятся в вашей базе.
Так же с помощью CMNS_API, вы можете с легкостью решить вопрос наполнения объектами, сайта вашего агентства недвижимости. При чем он будет наполнятся исключительно объектами собственников!
ССЫЛКА:
https://<ВАШ ГОРОД>.cmns.ru/export/api.phphttps://novosibirsk.cmns.ru/export/api.php
https://ekaterinburg.cmns.ru/export/api.php
https://chelyabinsk.cmns.ru/export/api.php
ПАРАМЕТРЫ (GET/POST):
Параметр | Описание | Возможные значения | ||||||||||||||||||||
key | ключ доступа | выдаётся администрацией cmns * Для настройки можете использовать ключ `DEMO_KEY`, Вам будут показаны последние 10 объявлений из открытых на cmns в демо режиме(менее 5% объявлений). |
||||||||||||||||||||
utf8 | Кодировка ответа | Так уж исторически сложилось, что CMNS.ru работает в кодировке windows-1251. По умолчанию api отдаёт ответ тоже в windows-1251. Если вам требуется получать ответ в кодировке UTF-8, установите данный параметр со значением "1".
Диапазон значений: 0,1 * По умолчанию utf8=0 |
||||||||||||||||||||
hour | За сколько часов должна производиться выборка | Например, при hour=5, будут показаны объявления за последние 5 часов
Диапазон значений: 1-48 * Если параметр не указан показываются объявления за последние 12 часов |
||||||||||||||||||||
limit | Ограничение количества объявлений в выборке | Например, при limit=5, будут показаны только 5 последних объявлений
* Если параметр не указан количество объявлений не ограничено |
||||||||||||||||||||
filetip | Тип файла выгрузки | Основные типы: yrl (Yandex Realty Language) csv json htm xls Если вам не подошел ни один из макетов файла выгрузки, можете попробовать одним из тех, что просили у нас другие пользователи API. Пользовательские типы: csv2 json2 * По умолчанию htm * Если вам не подошел ни один из представленых форматов, мы готовы разработать его специально для Вас совершенно бесплатно, просто напишите нам об этом! |
||||||||||||||||||||
tip | Тип сделки |
Вы можете указать один или несколько типов сделки.
* Если параметр не указан показываются объявления по всем типам сделки |
||||||||||||||||||||
dom | Вид недвижимости | Вы можете указать один или несколько видов недвижимости.
* Если параметр не указан показываются объявления по всем Видам недвижимости |
||||||||||||||||||||
goodaddr | Только распознанные адреса | Большинство объявлений идут с отформатированным адресом, но есть и такие, которые идут в свободной форме, до тех пор пока наши модераторы не уточнят адрес. Если вы хотите видеть объявления с неотформатированным адресом, до их правки, то установите goodaddr=2
Диапазон значений: 1,2 * По умолчанию goodaddr=1 показываются объявления с отформатированным адресом. примечание: При goodaddr=1 будут показаны не только Дома/Коттеджи/Дачи и земельные участки у которых есть адрес, но и те объявления в которых точный адрес не определён, но определены географические координаты. |
||||||||||||||||||||
repeats | Показывать повторы и подъёмы объявлений | Установите repeats=1 если вы хотите видеть все подъёмы и повторы объявлений.
Диапазон значений: 0,1 * По умолчанию repeats=0. |
||||||||||||||||||||
remember | Не показывать те, что уже были показаны | Если remember>0, то все отдаваемые вам по api объявления запоминаются и не показываются в течение последующих remember дней.
Диапазон значений: 0-30 * По умолчанию remember=0. * Функция запоминания не работает при repeats=1 * Функция не работает при использовании `DEMO_KEY` |
||||||||||||||||||||
remember_free | Обнуление запомненых | Для того, чтобы обнулить запомненые и вам были снова показаны объявления которые отсеклись remember=1, запустите один раз параметр remember_free=1.
Диапазон значений: 0,1 * ИСПОЛЬЗУЕЬСЯ РАЗОВО! ТОЛЬКО ЕСЛИ ВЫ РЕГУЛЯРНО ПОЛЬЗУЕТЕСЬ ПАРАМЕТРОМ remember |
||||||||||||||||||||
mtr_dist | Показывать ближайшую станцию метро если она ближе чем mtr_dist метров | Например, при mtr_dist=500, станция метро будет показана только для объектов в радиусе 500 метров. Все остальные объявления будут без станции метро.
Диапазон значений: 100-10000 * Если параметр не указан то по умолчанию mtr_dist=1000(1 километр) |
photos | фотографий |
Диапазон значений: 0-3 * Если параметр не указан то по умолчанию photos=0 примечание: При значениях 1 и 3 количество фотографий ограниченно! Максимум 10 штук. Кроме того они могут быть ниже качеством чем фото размещенные на источнике. |
|||||||||||||||||
sale_delay | Задержка объявлений продажи (в минутах) |
Главный приоритет Cmns - это скорость публикации новых объявлений. Поэтому мы сначала публикуем все новые объявления проходящие автофильтры, а потом их проверяют модераторы сайта, а так же пользователи подают на них жалобы для ускоренной проверки модераторами.
Это позволяет снизить скорость публикации до минимума, но пораждает временный пропуск риэлторских объявлений, пока их не проверят модераторы сайта. Соответственно чем свежее объявление тем больше вероятность того, что это может быть риэлтор. Кроме того некоторые объявления приходят в не информативном виде и нашим модераторам требуется время чтобы привести их в порядок. По этому для выгрузки мы рекомендуем устанавливать задержку объявлений, чтобы снизить пропуск риэлторских и неотформатированных объявлений. Диапазон значений: 1-1000 * Если параметр не указан то по умолчанию sale_delay = 180 (3 часа) |
||||||||||||||||||||
hidden_phones | Скрытие защищённых номеров | При hidden_phones=1 из выгрузки будут убраны все объявления с защищенными(переадресация источника) номерами телефонов. Если hidden_phones=2, то все объявления с защищёнными(переадресация источника) номерами, будут проверяться на дубли. Если будет найдено другое объявление этого подателя, но с не защищенным номером, тогда оно будет показано вместо защищенного. Диапазон значений: 0,1,2 * По умолчанию hidden_phones=0. |
||||||||||||||||||||
rent_delay | Задержка объявлений аренды (в минутах) |
То же что и sale_delay, только для объявлений по аренде.
Диапазон значений: 1-1000 * Если параметр не указан то по умолчанию rent_delay = 60 (1 час) |
ПРИМЕРЫ РАБОТЫ:
Получить последние 3 объявления о сдаче в аренду 1,2,3 комнатных квартир, за последние 24 часа, в формате XLS:https://tyumen.cmns.ru/export/api.php?key=DEMO_KEY&filetip=xls&tip=4&dom=2,3,4&limit=3&hour=24
Показать все объявления по продаже включая те, в которых адрес указан не точно, со всеми повторами, за последние 48 часов, в формате JSON:
https://tyumen.cmns.ru/export/api.php?key=DEMO_KEY&filetip=json&tip=2&repeats=1&goodaddr=2
Показать все объявления по спросу(продажа и аренда), без задержки, за последние 48 часов, в виде HTML-таблицы:
https://tyumen.cmns.ru/export/api.php?key=DEMO_KEY&filetip=htm&tip=1,3&sale_delay=1&rent_delay=1
ВНИМАНИЕ! Используя открытый ключ `DEMO_KEY`, Вам будут доступны лишь последние 10 объявлений из открытых на cmns в демо режиме(это менее 5% от всех объявлений). Все новые объявления по этому ключу недоступны!
Вернуться к описанию CMNS_API