API для доступа к объявлениям с cian.ru
API позволяет выгружать объявления с сайта cian.ru. Обновление базы каждую секунду.
Подключение к API
API позволяет выгружать объявления cian.ru. Обновление базы каждую секунду.
Доступ к API: Avito, Cian, Irr, Youla, Olx. Цена - 4000 руб. в месяц (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(). |
| phone | нет | Телефон в формате 8xxxYYYYYYY, по которому требуется фильтрация / поиск. Выводит объявления с этим телефоном. (минимум спишет 5 ед. с суточного лимита) |
| limit | нет (1000) | Ограничение кол-ва, не может быть больше 1000 |
| offset | нет (0) | Смещение |
| 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 | Республика Алтай |