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