https://support.cian.ru/ru/knowledge_base/art/299/cat/88/
Вопросы: Интеграция циан со своим сайтом.
Доступно на тарифе “Базовый”.
- Для подключения Базового тарифа в Москве, Московской области, Санкт-Петербурге и Ленинградской области, Краснодаре, Краснодарском крае, Ростове-на-Дону, Ростовской области, Севастополе, Симферополе, Крыму, Ялте, Перми, Пермском крае, Архангельске и пригороде, Архангельской области, Челябинске и пригороде, Челябинской области, Екатеринбурге и пригороде, Свердловской области, Новосибирске и пригороде, Новосибирской области, Красноярске и пригороде, Красноярском крае, Тюмени и пригороде, Тюменской области, Омской области, Волгограде, Волгоградской области, Калининграде, Калининградской области, Кемерове, Кемеровская область, Уфе, Башкортостане, Самаре, Самарской области, Казани, Татарстане, Нижнем Новгороде, Нижегородской области: обратитесь в поддержку.
- Для подключения Базового тарифа в других регионах перейдите на страницу Тарифы и цены.
Для чего предназначен API
Важно! Через API передается информация по объявлениям, которые вы публикуете на Циан. Если нужны аналитические данные по другим объектам, оставьте заявку в разделе Анализ рынка недвижимости, - специалисты свяжутся с вами для консультации.
Циан API - сервис, который дает возможность интегрировать данные об объектах на Циан в свою внутреннюю базу или CRM.
С помощью API вы сможете видеть информацию из личного кабинета Циан в едином окне собственной CRM, без необходимости переключаться между интерфейсами.
API позволяет:
Анализировать статистику по объявлениям.
Получать данные и собирать отчеты произвольного вида.
Прорабатывать ошибки выгрузки.
Настраивать всевозможные триггеры и уведомления в своей системе (например, когда заканчиваются деньги) и многое другое, что придет в голову вашим разработчикам.
Отправлять сообщения клиенту прямо из CRM системы.
Подробнее на странице: Циан.API
Какие данные можно получить через API
Список объявлений с возможностью фильтрации по статусу, источнику и списку сотрудников.
Состояние последнего актуального отчёта по выгрузке: фиды, дату их проверки, наличие/отсутствие проблем с объявлениями или фото, № заказа и дату последней обработки фидов.
Статистику по объявлениям: охват объявления*, количество просмотров и кликов “показать телефон” по дням и за все время.
*Охват - это доля пользователей, увидевших объявление, под чей поиск подошёл объект.
Отчет по звонкам с возможностью фильтрации по датам и ID сотрудника.
Информацию по биллингу: текущий баланс, активные типы размещения объявлений, детализацию операций со счетом (списание, пополнение).
Список сотрудников агентства.
Активные ставки по аукциону.
Жалобы пользователей на объявления.
Сообщения от клиентов с возможностью ответа и начала диалога.
Состояние прочитанности сообщений от клиентов.
Системные сообщения и уведомления от службы качества Циан.
Уведомления из личного кабинета (о пополнении счета, активации тарифа, предупреждения об ограничениях к аккаунту, информация от службы контроля качества, и др.).
Оценку недвижимости с возможностью получить оценку квадратного метра в многоэтажном доме и данные БТИ по адресу.
Важно! Доступ к методу платный. Для его активации, после получения ключа к API, напишите на почту b2bdatasales@cian.ru.
Как получить доступ к API
Для работы с API требуется ключ авторизации (ACCESS KEY). Получить его можно в личном кабинете.
Перейдите в раздел Настройки → Ещё → Циан API.
Нажмите “Получить ключ API”.
Важно! Ключ авторизации отправляется только на Email, на который зарегистрирован аккаунт. Проверить, на какую почту был отправлен ключ можно в разделе Настройки → Регистрационные данные.
Часто задаваемые вопросы по API
Что такое API Циан?
API Циан - сервис, который дает возможность интегрировать данные об объектах и сообщениях на Циан в свою внутреннюю базу или CRM.
Как подключить API Циан?
Для работы с API требуется ключ авторизации (ACCESS KEY). Получить его можно в личном кабинете, раздел Настройки → Ещё → Циан API.
Как подключить сообщения по API Циан?
Если интеграция по API Циан уже настроена - обратитесь к техническому специалисту вашей CRM системы для добавления нового метода “Сообщения”. Убедитесь, что получение сообщений включено в личном кабинете Циан.
К каким CRM системами можно подключить сообщения по API Циан?
Подключить сообщения по API Циан можно к абсолютно любой CRM системе, которая поддерживает API Циан с настроенным методом “Сообщения”.
Как быстро будут приходить сообщения?
Уведомления о сообщениях будут поступать мгновенно. Вы сможете всегда оставаться на связи с вашими клиентами для оперативного ответа на запросы.
Можно ли отправить не только текстовое сообщение, а например презентацию?
Вы можете обмениваться текстовыми сообщениями, фотографиями и документами.
Для кого работает API?
Для пользователей тарифа Базовый, как агентств недвижимости, так и частных маклеров.
В ответ на запрос - ошибка. Что делать?
Проверьте, верный ли метод используется. Все данные можно получить только GET-запросом. Если проблема не в этом, для анализа ситуации пришлите в поддержку: import@cian.ru
В обращении уточните:
1. Ваш ID аккаунта;
2. Используемый ключ доступа к API.
3. Какой метод API используете.
4. CURL запроса.
5. Текущий результат (скриншот).
6. Ожидаемый результат.
Какое действует ограничение на количество запросов?
5 запросов в секунду. Рекомендуем распределять нагрузку в течение дня.
Есть ли ограничение на количество объявлений в запросе?
Рекомендуем не более 50.
По запросу get-my-offers приходит ответ без идентификаторов в фиде
Запрос get-my-offers вызывается только по ID объявления на Циан (offerId). Для связки объявления в вашей системе и Циан нужно воспользоваться запросом get-order, где есть и externalId, и offerId.
Кому доступен контроль за прочтением сообщений и получение системных уведомлений и сообщений от службы качества Циан?
Контроль за прочтением сообщений и получение системных уведомлений и сообщений от службы качества доступно всем пользователям, у кого подключен метод “Сообщения”.
Статьи по теме:
- Документация Циан API для агентств недвижимости и риелторов
- Сервис “Сотрудники”
- Стоимость размещения объявлений
- Условия использования сервиса API