API для доступа к объявлениям с cian.ru

API позволяет выгружать объявления с номерами телефонов с сайта cian.ru. Обновление базы каждую секунду.

Подключение к API

API позволяет выгружать объявления cian.ru. В базе присутствуют все категории и объявления. Обновление базы каждую секунду.

Цена - 3000 руб. в месяц (30 дней).

Тестовый доступ на 15 дней бесплатно *

* Для тестового доступа действуют следующие ограничения: он выдается на 15 дней один раз, часть телефона скрыта, за один запрос можно получить не более 50 записей.


Описание API

Запросы для получения объявлений циан.ру
выполняются на адрес https://rest-app.net/api-cian/ads методом GET или POST. За один запрос возвращается не больше 1000 объявлений.

Возможные параметры:

Параметр Обязательный Описание
login да Логин пользователя в системе, e-mail
token да Access token, используемый для авторизации. Выдается на этой странице в разделе "Подключение к API"
category_id да 0 - все категории
1 - квартиры
2 - комнаты
3 - коммерческая недвижимость
4 - загородная недвижимость
deal_id нет 1 - продажа
2 - аренда
region_id нет Идентификатор региона
last_m нет Возможные значения: 1-30. Кол-во последних минут за который нужно вернуть результат (При использовании этого параметра, параметры date1 и date2 не учитываются)
last_s нет Возможные значения: 1-60. Кол-во последних секунд за который нужно вернуть результат (При использовании этого параметра, параметры date1, date2 и last_m не учитываются)
date1 нет Дата от в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС (пример: 2015-09-10 09:05:45 или 2015-09-10)
date2 нет Дата до в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС (пример: 2015-09-10 09:10:45 или 2015-09-10)
price1 нет Цена от
price2 нет Цена до
q нет Текст для поиска по описанию
Замечание: Если вы используете спецсимволы, такие как пробел, вам нужно закодировать запрос при помощи urlencode().
limit нет (1000) Ограничение кол-ва, не может быть больше 1000
format нет (json) Формат ответов. Возможные значения: json, xml

Запрос для получения объявления cian.ru по id
выполняются на адрес https://rest-app.net/api-cian/ad методом GET или POST.

Возможные параметры:

Параметр Обязательный Описание
login да Логин пользователя в системе, e-mail
token да Access token, используемый для авторизации. Выдается на этой странице в разделе "Подключение к API".
id да Идентификатор объявления на cian.ru
format нет (json) Формат ответов. Возможные значения: json, xml

Примеры:

https://rest-app.net/api-cian/ad?login=ваш_логин&token=ваш_ключ&id=198434863

Запрос для получения инфомации по аккаунту
выполняются на адрес https://rest-app.net/api/info методом GET или POST.

Возможные параметры:

Параметр Обязательный Описание
login да Логин пользователя в системе, e-mail
token да Access token, используемый для авторизации. Выдается на этой странице в разделе "Подключение к API".
format нет (json) Формат ответов. Возможные значения: json, xml

Примеры:

https://rest-app.net/api/info?login=ваш_логин&token=ваш_ключ

Пример ответа в формате JSON:

{
    "status": "ok",
    "data": [
        {
            "Id": 199205766,
            "url": "https:\/\/www.cian.ru\/rent\/flat\/199205766",
            "price": 60000,
            "time": "2019-01-04 15:58:36",
            "time_publish": "2019-01-04 15:53:45",
            "phone": "89967919050",
            "person_type": "агент",
            "region": "",
            "city": "Санкт-Петербург",
            "address": "Россия, Санкт-Петербург, Аптекарская набережная, 6",
            "metro": "Петроградская,Выборгская,Лесная",
            "rooms_count": 2,
            "floor_number": 5,
            "floors_count": 7,
            "area": "72.0",
            "area_kitchen": "14.0",
            "area_living": "36.0",
            "area_land": null,
            "building_year": 2009,
            "deal_type": "сдам",
            "images": "https:\/\/cdn-p.cian.site\/images\/7\/932\/916\/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239749-1.jpg,https:\/\/cdn-p.cian.site\/images\/7\/932\/916\/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239735-1.jpg,https:\/\/cdn-p.cian.site\/images\/7\/932\/916\/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239739-1.jpg,https:\/\/cdn-p.cian.site\/images\/7\/932\/916\/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239738-1.jpg,https:\/\/cdn-p.cian.site\/images\/7\/932\/916\/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239740-1.jpg,https:\/\/cdn-p.cian.site\/images\/7\/932\/916\/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239737-1.jpg,https:\/\/cdn-p.cian.site\/images\/7\/932\/916\/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239736-1.jpg,https:\/\/cdn-p.cian.site\/images\/7\/932\/916\/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239746-1.jpg,https:\/\/cdn-p.cian.site\/images\/7\/932\/916\/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239742-1.jpg,https:\/\/cdn-p.cian.site\/images\/7\/932\/916\/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239744-1.jpg,https:\/\/cdn-p.cian.site\/images\/7\/932\/916\/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239747-1.jpg,https:\/\/cdn-p.cian.site\/images\/7\/932\/916\/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239748-1.jpg,https:\/\/cdn-p.cian.site\/images\/7\/932\/916\/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239743-1.jpg,https:\/\/cdn-p.cian.site\/images\/7\/932\/916\/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239745-1.jpg",
            "description": "Сдаётся уютная двухкомнатная квартира,расположенная в историческом центре города,в Петроградском районе ,в пяти минутах ходьбы от метро Чкаловская, по адресу : Гатчинская 18. Квартира общей площадью 65кв.м имеет 2 просторные комнаты,просторную кухню-гостиную,совмещённый санузел с большой ванной. Из окон квартиры открывается прекрасный вид на Малый проспект Петроградской стороны. В квартире выполнен качественный современный ремонт,имеется вся необходимая мебель и бытовая техника,в том числе система кондиционирования . В пешей доступности исторические достопримечательности города : Александровский парк, Артиллерийский остров,Петропавловская крепость. Все объекты социальной инфраструктуры в непосредственной близости",
            "category": "Квартиры",
            "subcategory": "Вторичное",
            "category_Id": 1,
            "region_Id": null,
            "city_Id": 2,
            "coords": {
                "lat": 59.972811,
                "lng": 30.327546
            }
        },
        {
            "Id": 199205518,
            "url": "https:\/\/www.cian.ru\/rent\/flat\/199205518",
            "price": 28000,
            "time": "2019-01-04 15:35:32",
            "time_publish": "2019-01-04 15:24:13",
            "phone": "89643764544",
            "person_type": "собственник",
            "region": "",
            "city": "Санкт-Петербург",
            "address": "Россия, Санкт-Петербург, Туристская улица, 23к4",
            "metro": "Беговая",
            "rooms_count": 1,
            "floor_number": 8,
            "floors_count": 23,
            "area": "35.0",
            "area_kitchen": "10.0",
            "area_living": "18.0",
            "area_land": null,
            "building_year": 2013,
            "deal_type": "сдам",
            "images": "https:\/\/www.cian.ru\/image-temp\/3\/032\/916\/kvartira-sanktpeterburg-turistskaya-ulica-619230313-1.jpg,https:\/\/www.cian.ru\/image-temp\/3\/032\/916\/kvartira-sanktpeterburg-turistskaya-ulica-619230315-1.jpg,https:\/\/www.cian.ru\/image-temp\/3\/032\/916\/kvartira-sanktpeterburg-turistskaya-ulica-619230305-1.jpg,https:\/\/www.cian.ru\/image-temp\/3\/032\/916\/kvartira-sanktpeterburg-turistskaya-ulica-619230300-1.jpg,https:\/\/www.cian.ru\/image-temp\/3\/032\/916\/kvartira-sanktpeterburg-turistskaya-ulica-619230314-1.jpg,https:\/\/www.cian.ru\/image-temp\/3\/032\/916\/kvartira-sanktpeterburg-turistskaya-ulica-619230316-1.jpg,https:\/\/www.cian.ru\/image-temp\/3\/032\/916\/kvartira-sanktpeterburg-turistskaya-ulica-619230319-1.jpg",
            "description": "Сдается:\n\nОднокомнатная квартира, площадью 35 м2\nнаходится на 8-м этаже 25-ти этажного дома\nкомната - 18м2\nкухня -10 м2\nготова для проживания,\nполностью мебелирована, со всей техникой.\nсдается на длительный срок.",
            "category": "Квартиры",
            "subcategory": "Вторичное",
            "category_Id": 1,
            "region_Id": null,
            "city_Id": 2,
            "coords": {
                "lat": 60.003327,
                "lng": 30.215787
            }
        }
    ]
}
						

Пример ответа в формате XML:

<?xml version="1.0" encoding="utf-8"?>
<result>
  <status>ok</status>
  <data>
    <ad>
      <Id>199205766</Id>
      <url>https://www.cian.ru/rent/flat/199205766</url>
      <price>60000</price>
      <time>2019-01-04 15:58:36</time>
      <time_publish>2019-01-04 15:53:45</time_publish>
      <phone>89967919050</phone>
      <person_type>агент</person_type>
      <region></region>
      <city>Санкт-Петербург</city>
      <address>Россия, Санкт-Петербург, Аптекарская набережная, 6</address>
      <metro>Петроградская,Выборгская,Лесная</metro>
      <rooms_count>2</rooms_count>
      <floor_number>5</floor_number>
      <floors_count>7</floors_count>
      <area>72.0</area>
      <area_kitchen>14.0</area_kitchen>
      <area_living>36.0</area_living>
      <area_land></area_land>
      <building_year>2009</building_year>
      <deal_type>сдам</deal_type>
      <images>https://cdn-p.cian.site/images/7/932/916/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239749-1.jpg,https://cdn-p.cian.site/images/7/932/916/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239735-1.jpg,https://cdn-p.cian.site/images/7/932/916/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239739-1.jpg,https://cdn-p.cian.site/images/7/932/916/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239738-1.jpg,https://cdn-p.cian.site/images/7/932/916/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239740-1.jpg,https://cdn-p.cian.site/images/7/932/916/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239737-1.jpg,https://cdn-p.cian.site/images/7/932/916/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239736-1.jpg,https://cdn-p.cian.site/images/7/932/916/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239746-1.jpg,https://cdn-p.cian.site/images/7/932/916/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239742-1.jpg,https://cdn-p.cian.site/images/7/932/916/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239744-1.jpg,https://cdn-p.cian.site/images/7/932/916/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239747-1.jpg,https://cdn-p.cian.site/images/7/932/916/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239748-1.jpg,https://cdn-p.cian.site/images/7/932/916/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239743-1.jpg,https://cdn-p.cian.site/images/7/932/916/kvartira-sanktpeterburg-aptekarskaya-naberezhnaya-619239745-1.jpg</images>
      <description>Сдаётся уютная двухкомнатная квартира,расположенная в историческом центре города,в Петроградском районе ,в пяти минутах ходьбы от метро Чкаловская, по адресу : Гатчинская 18. Квартира общей площадью 65кв.м имеет 2 просторные комнаты,просторную кухню-гостиную,совмещённый санузел с большой ванной. Из окон квартиры открывается прекрасный вид на Малый проспект Петроградской стороны. В квартире выполнен качественный современный ремонт,имеется вся необходимая мебель и бытовая техника,в том числе система кондиционирования . В пешей доступности исторические достопримечательности города : Александровский парк, Артиллерийский остров,Петропавловская крепость. Все объекты социальной инфраструктуры в непосредственной близости</description>
      <category>Квартиры</category>
      <subcategory>Вторичное</subcategory>
      <category_Id>1</category_Id>
      <region_Id></region_Id>
      <city_Id>2</city_Id>
      <coords>
        <lat>59.972811</lat>
        <lng>30.327546</lng>
      </coords>
    </ad>
    <ad>
      <Id>199205518</Id>
      <url>https://www.cian.ru/rent/flat/199205518</url>
      <price>28000</price>
      <time>2019-01-04 15:35:32</time>
      <time_publish>2019-01-04 15:24:13</time_publish>
      <phone>89643764544</phone>
      <person_type>собственник</person_type>
      <region></region>
      <city>Санкт-Петербург</city>
      <address>Россия, Санкт-Петербург, Туристская улица, 23к4</address>
      <metro>Беговая</metro>
      <rooms_count>1</rooms_count>
      <floor_number>8</floor_number>
      <floors_count>23</floors_count>
      <area>35.0</area>
      <area_kitchen>10.0</area_kitchen>
      <area_living>18.0</area_living>
      <area_land></area_land>
      <building_year>2013</building_year>
      <deal_type>сдам</deal_type>
      <images>https://www.cian.ru/image-temp/3/032/916/kvartira-sanktpeterburg-turistskaya-ulica-619230313-1.jpg,https://www.cian.ru/image-temp/3/032/916/kvartira-sanktpeterburg-turistskaya-ulica-619230315-1.jpg,https://www.cian.ru/image-temp/3/032/916/kvartira-sanktpeterburg-turistskaya-ulica-619230305-1.jpg,https://www.cian.ru/image-temp/3/032/916/kvartira-sanktpeterburg-turistskaya-ulica-619230300-1.jpg,https://www.cian.ru/image-temp/3/032/916/kvartira-sanktpeterburg-turistskaya-ulica-619230314-1.jpg,https://www.cian.ru/image-temp/3/032/916/kvartira-sanktpeterburg-turistskaya-ulica-619230316-1.jpg,https://www.cian.ru/image-temp/3/032/916/kvartira-sanktpeterburg-turistskaya-ulica-619230319-1.jpg</images>
      <description>Сдается: Однокомнатная квартира, площадью 35 м2 находится на 8-м этаже 25-ти этажного дома комната - 18м2 кухня -10 м2 готова для проживания, полностью мебелирована, со всей техникой. сдается на длительный срок.</description>
      <category>Квартиры</category>
      <subcategory>Вторичное</subcategory>
      <category_Id>1</category_Id>
      <region_Id></region_Id>
      <city_Id>2</city_Id>
      <coords>
        <lat>60.003327</lat>
        <lng>30.215787</lng>
      </coords>
    </ad>
  </data>
</result>

Регионы / Города

Id Название
181462 Крым
4555 Алтайский край
4556 Амурская область
4557 Архангельская область
4558 Астраханская область
4561 Белгородская область
4562 Брянская область
4563 Бурятия
4564 Владимирская область
4565 Волгоградская область
4566 Вологодская область
4567 Воронежская область
4569 Еврейская АО
4570 Ивановская область
4571 Ингушетия
4572 Иркутская область
4573 Кабардино-Балкария
4574 Калининградская область
4575 Калмыкия
4576 Калужская область
4577 Камчатский край
4578 Карачаево-Черкесия
4580 Кемеровская область
4581 Кировская область
4583 Костромская область
4584 Краснодарский край
4585 Красноярский край
4586 Курганская область
4587 Курская область
4588 Ленинградская область
4589 Липецкая область
4590 Магаданская область
1 Москва
4593 Московская область
4594 Мурманская область
4595 Ненецкий АО
4596 Нижегородская область
4597 Новгородская область
4598 Новосибирская область
4599 Омская область
4600 Оренбургская область
4601 Орловская область
4602 Пензенская область
4603 Пермский край
4604 Приморский край
4605 Псковская область
4553 Адыгея
4560 Башкортостан
4568 Дагестан
4579 Карелия
4582 Коми
4591 Марий Эл
4592 Мордовия
4610 Саха (Якутия)
4613 Северная Осетия
4618 Татарстан
4622 Тыва
4628 Хакасия
4606 Ростовская область
4607 Рязанская область
4608 Самарская область
2 Санкт-Петербург
4609 Саратовская область
4611 Сахалинская область
4612 Свердловская область
4614 Смоленская область
4615 Ставропольский край
4617 Тамбовская область
4619 Тверская область
4620 Томская область
4621 Тульская область
4623 Тюменская область
4624 Удмуртия
4625 Ульяновская область
4627 Хабаровский край
4629 Ханты-Мансийский АО
4630 Челябинская область
4631 Чеченская республика
187450 Забайкальский край
4633 Чувашия
4634 Чукотский АО
4635 Ямало-Ненецкий АО
4636 Ярославская область
4554 Республика Алтай