API для доступа к объявлениям с irr.ru
API позволяет выгружать данные irr.ru Обновление базы каждую секунду.
Подключение к API
API позволяет выгружать объявления irr.ru. В базе присутствуют все категории и объявления. Обновление базы каждую секунду.
Доступ к API: Avito, Cian, Irr, Youla, Olx. Цена - 4000 руб. в месяц (30 дней).
Тестовый доступ на 15 дней бесплатно *
* Для тестового доступа действуют следующие ограничения: он выдается на 15 дней один раз, часть телефона скрыта, за один запрос можно получить не более 50 записей.
Описание API
Запросы для получения объявлений
выполняются на адрес https://rest-app.net/api-irr/ads методом GET или POST. За один запрос возвращается не больше 1000 объявлений.
Возможные параметры:
| Параметр | Обязательный | Описание |
|---|---|---|
| login | да | Логин пользователя в системе, e-mail |
| token | да | Access token, используемый для авторизации. Выдается на этой странице в разделе "Подключение к API" |
| category_id | да | Идентификатор категории, 0 - все категории |
| 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 |
| offset | нет (0) | Смещение |
| format | нет (json) | Формат ответов. Возможные значения: json, xml |
Запрос для получения объявления по id
выполняются на адрес https://rest-app.net/api-irr/ad методом GET или POST.
Возможные параметры:
| Параметр | Обязательный | Описание |
|---|---|---|
| login | да | Логин пользователя в системе, e-mail |
| token | да | Access token, используемый для авторизации. Выдается на этой странице в разделе "Подключение к API". |
| id | да | Идентификатор объявления на irr.ru |
| format | нет (json) | Формат ответов. Возможные значения: json, xml |
Примеры:
https://rest-app.net/api-irr/ad?login=ваш_логин&token=ваш_ключ&id=685674499
Запрос для получения инфомации по аккаунту
выполняются на адрес 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": "640048020",
"date_create": "2017-05-15 20:04:32",
"date_finish": "2017-06-29 20:04:32",
"source_from": "0",
"power": "0",
"user": "marinabarminova@yandex.ru",
"url": "https:\/\/irr.ru\/real-estate\/out-of-town\/cottage-houses\/kottedzh-214-kv-m-istrinskiy-r-n-novopetrovskoe-s-advert640048020.html",
"price": 9900000,
"currency": "руб.",
"converted_prices": [
{
"price": 9900000,
"currency": "руб."
},
{
"price": 152499,
"currency": "$"
},
{
"price": 139027,
"currency": "€"
}
],
"category": "Продажа коттеджей",
"category_url": "real-estate\/out-of-town\/cottage-houses\/",
"advert_type": "realty_cottage_house",
"phone": [
"+79036785014"
],
"phone_add": "",
"phone2": [
],
"phone_add2": "",
"seller": "марина",
"seller2": "",
"power_site": "",
"mm_id": "",
"od_id": "",
"skype": "",
"icq": "",
"email": "marinabarminova@yandex.ru",
"region": "Новопетровское",
"region_url": "russia\/moskovskaya-obl\/istrinskiy-r_n\/novopetrovskoe-selo\/",
"status": "1",
"status_moderate": "2",
"status_pay": "2",
"ispremium": "",
"ismarkup": false,
"ispushup": false,
"isvip": false,
"video": "",
"text": "Продается участок с домом в деревне Глебово-Избищи недалеко от города Истра. До Волоколамского шоссе 3 км, до Новорижского шоссе 7 км. До города Истра 5 км. Дом без внутренней отделки из пенопроистерольных блоков и кирпича, крыша металлочерепица, фундамент - бетонная плита, оштукатурен, имеется погреб. Электричество заведено в дом, вода - скважина, канализация - выгребная яма. Дом имеет два этажа. На первом этаже три комнаты, котельная и санузел, а на втором этаже три спальни (в каждой есть балкон), холл, санузел. Участок огорожен (металлический штакетник в шахматном порядке), ухожен, посажены плодовые деревья и кустарники, цветы, отсыпан асфальтной крошкой въезд на две-три машины. Позади участка имеется еще один участок, площадью 8 соток, который находится в аренде на три года.На участке имеется двухэтажная баня, в которой можно жить. Баня из бревна с панорамными окнами, парилкой, имеется санузел и комната на первом и мансардном этаже. Хороший асфальтированный подъезд. Недалеко от дома есть пруд.В доме никто не прописан и не проживает. Соседи живут круглогодично. Документы готовы к сделке.\nПохожие объявления",
"title": "Коттедж 214 кв.м, Истринский р-н, Новопетровское с, площадь участка 12 соток",
"group_custom_fields": [
{
"title": "Основные характеристики",
"sort_index": "1",
"custom_fields": [
{
"name": "shosse",
"title": "Шоссе",
"value": "Волоколамское ш."
},
{
"name": "meters-total",
"title": "Площадь строения",
"value": "214"
},
{
"name": "land",
"title": "Площадь участка",
"value": "12"
},
{
"name": "direction",
"title": "Направление",
"value": "Рижское"
}
]
},
{
"title": "Подробнее о строении",
"sort_index": "2",
"custom_fields": [
{
"name": "rooms",
"title": "Количество комнат",
"value": "5"
},
{
"name": "etage-all",
"title": "Количество этажей",
"value": "2"
},
{
"name": "watersupply",
"title": "Водопровод",
"value": true
},
{
"name": "sewage",
"title": "Канализация",
"value": true
}
]
},
{
"title": "Подробнее об участке",
"sort_index": "3",
"custom_fields": [
]
}
],
"images": [
{
"orig": "https:\/\/monolith1.izrukvruki.ru\/img\/catalog\/i4\/63\/ca\/43baa6762-590x1050-640048020-orig.jpg",
"mobile": "https:\/\/monolith1.izrukvruki.ru\/img\/catalog\/i4\/63\/ca\/43baa6762-590x1050-640048020-resize_640_480.jpg"
},
{
"orig": "https:\/\/monolith1.izrukvruki.ru\/img\/catalog\/i2\/63\/ca\/421b3ac5c-590x1050-640048020-orig.jpg",
"mobile": "https:\/\/monolith1.izrukvruki.ru\/img\/catalog\/i2\/63\/ca\/421b3ac5c-590x1050-640048020-resize_640_480.jpg"
},
{
"orig": "https:\/\/monolith1.izrukvruki.ru\/img\/catalog\/i4\/63\/ca\/21ce68912-590x1050-640048020-orig.jpg",
"mobile": "https:\/\/monolith1.izrukvruki.ru\/img\/catalog\/i4\/63\/ca\/21ce68912-590x1050-640048020-resize_640_480.jpg"
},
{
"orig": "https:\/\/monolith1.izrukvruki.ru\/img\/catalog\/i2\/63\/ca\/3df07fdae-590x1050-640048020-orig.jpg",
"mobile": "https:\/\/monolith1.izrukvruki.ru\/img\/catalog\/i2\/63\/ca\/3df07fdae-590x1050-640048020-resize_640_480.jpg"
},
{
"orig": "https:\/\/monolith1.izrukvruki.ru\/img\/catalog\/i2\/63\/ca\/9f60ab2b5-590x1050-640048020-orig.jpg",
"mobile": "https:\/\/monolith1.izrukvruki.ru\/img\/catalog\/i2\/63\/ca\/9f60ab2b5-590x1050-640048020-resize_640_480.jpg"
},
{
"orig": "https:\/\/monolith1.izrukvruki.ru\/img\/catalog\/i2\/63\/ca\/9ff0525c6-590x1050-640048020-orig.jpg",
"mobile": "https:\/\/monolith1.izrukvruki.ru\/img\/catalog\/i2\/63\/ca\/9ff0525c6-590x1050-640048020-resize_640_480.jpg"
}
],
"geo_lat": "55.991390",
"geo_lng": "36.484994",
"auth_token": "",
"seller_info": {
"id": "13517085",
"name": ""
},
"phone_call_time": [
],
"services": [
],
"votes": 0,
"isfavorited": false,
"views_count": 2,
"dt": 1494870465
}
]
}
Пример ответа в формате XML:
<?xml version="1.0" encoding="UTF-8"?>
<result>
<status>ok</status>
<data>
<ad>
<id>640048020</id>
<date_create>2017-05-15 20:04:32</date_create>
<date_finish>2017-06-29 20:04:32</date_finish>
<source_from>0</source_from>
<power>0</power>
<user>marinabarminova@yandex.ru</user>
<url>
https://irr.ru/real-estate/out-of-town/cottage-houses/kottedzh-214-kv-m-istrinskiy-r-n-novopetrovskoe-s-advert640048020.html
</url>
<price>9900000</price>
<currency>руб.</currency>
<converted_prices>
<ad>
<price>9900000</price>
<currency>руб.</currency>
</ad>
<ad>
<price>152499</price>
<currency>$</currency>
</ad>
<ad>
<price>139027</price>
<currency>€</currency>
</ad>
</converted_prices>
<category>Продажа коттеджей</category>
<category_url>real-estate/out-of-town/cottage-houses/</category_url>
<advert_type>realty_cottage_house</advert_type>
<phone>
<ad>+79036785014</ad>
</phone>
<phone_add/>
<phone2/>
<phone_add2/>
<seller>марина</seller>
<seller2/>
<power_site/>
<mm_id/>
<od_id/>
<skype/>
<icq/>
<email>marinabarminova@yandex.ru</email>
<region>Новопетровское</region>
<region_url>
russia/moskovskaya-obl/istrinskiy-r_n/novopetrovskoe-selo/
</region_url>
<status>1</status>
<status_moderate>2</status_moderate>
<status_pay>2</status_pay>
<ispremium/>
<ismarkup/>
<ispushup/>
<isvip/>
<video/>
<text>
Продается участок с домом в деревне Глебово-Избищи недалеко от города Истра. До Волоколамского шоссе 3 км, до Новорижского шоссе 7 км. До города Истра 5 км. Дом без внутренней отделки из пенопроистерольных блоков и кирпича, крыша металлочерепица, фундамент - бетонная плита, оштукатурен, имеется погреб. Электричество заведено в дом, вода - скважина, канализация - выгребная яма. Дом имеет два этажа. На первом этаже три комнаты, котельная и санузел, а на втором этаже три спальни (в каждой есть балкон), холл, санузел. Участок огорожен (металлический штакетник в шахматном порядке), ухожен, посажены плодовые деревья и кустарники, цветы, отсыпан асфальтной крошкой въезд на две-три машины. Позади участка имеется еще один участок, площадью 8 соток, который находится в аренде на три года.На участке имеется двухэтажная баня, в которой можно жить. Баня из бревна с панорамными окнами, парилкой, имеется санузел и комната на первом и мансардном этаже. Хороший асфальтированный подъезд. Недалеко от дома есть пруд.В доме никто не прописан и не проживает. Соседи живут круглогодично. Документы готовы к сделке. Похожие объявления
</text>
<title>
Коттедж 214 кв.м, Истринский р-н, Новопетровское с, площадь участка 12 соток
</title>
<group_custom_fields>
<ad>
<title>Основные характеристики</title>
<sort_index>1</sort_index>
<custom_fields>
<ad>
<name>shosse</name>
<title>Шоссе</title>
<value>Волоколамское ш.</value>
</ad>
<ad>
<name>meters-total</name>
<title>Площадь строения</title>
<value>214</value>
</ad>
<ad>
<name>land</name>
<title>Площадь участка</title>
<value>12</value>
</ad>
<ad>
<name>direction</name>
<title>Направление</title>
<value>Рижское</value>
</ad>
</custom_fields>
</ad>
<ad>
<title>Подробнее о строении</title>
<sort_index>2</sort_index>
<custom_fields>
<ad>
<name>rooms</name>
<title>Количество комнат</title>
<value>5</value>
</ad>
<ad>
<name>etage-all</name>
<title>Количество этажей</title>
<value>2</value>
</ad>
<ad>
<name>watersupply</name>
<title>Водопровод</title>
<value>1</value>
</ad>
<ad>
<name>sewage</name>
<title>Канализация</title>
<value>1</value>
</ad>
</custom_fields>
</ad>
<ad>
<title>Подробнее об участке</title>
<sort_index>3</sort_index>
<custom_fields/>
</ad>
</group_custom_fields>
<images>
<ad>
<orig>
https://monolith1.izrukvruki.ru/img/catalog/i4/63/ca/43baa6762-590x1050-640048020-orig.jpg
</orig>
<mobile>
https://monolith1.izrukvruki.ru/img/catalog/i4/63/ca/43baa6762-590x1050-640048020-resize_640_480.jpg
</mobile>
</ad>
<ad>
<orig>
https://monolith1.izrukvruki.ru/img/catalog/i2/63/ca/421b3ac5c-590x1050-640048020-orig.jpg
</orig>
<mobile>
https://monolith1.izrukvruki.ru/img/catalog/i2/63/ca/421b3ac5c-590x1050-640048020-resize_640_480.jpg
</mobile>
</ad>
<ad>
<orig>
https://monolith1.izrukvruki.ru/img/catalog/i4/63/ca/21ce68912-590x1050-640048020-orig.jpg
</orig>
<mobile>
https://monolith1.izrukvruki.ru/img/catalog/i4/63/ca/21ce68912-590x1050-640048020-resize_640_480.jpg
</mobile>
</ad>
<ad>
<orig>
https://monolith1.izrukvruki.ru/img/catalog/i2/63/ca/3df07fdae-590x1050-640048020-orig.jpg
</orig>
<mobile>
https://monolith1.izrukvruki.ru/img/catalog/i2/63/ca/3df07fdae-590x1050-640048020-resize_640_480.jpg
</mobile>
</ad>
<ad>
<orig>
https://monolith1.izrukvruki.ru/img/catalog/i2/63/ca/9f60ab2b5-590x1050-640048020-orig.jpg
</orig>
<mobile>
https://monolith1.izrukvruki.ru/img/catalog/i2/63/ca/9f60ab2b5-590x1050-640048020-resize_640_480.jpg
</mobile>
</ad>
<ad>
<orig>
https://monolith1.izrukvruki.ru/img/catalog/i2/63/ca/9ff0525c6-590x1050-640048020-orig.jpg
</orig>
<mobile>
https://monolith1.izrukvruki.ru/img/catalog/i2/63/ca/9ff0525c6-590x1050-640048020-resize_640_480.jpg
</mobile>
</ad>
</images>
<geo_lat>55.991390</geo_lat>
<geo_lng>36.484994</geo_lng>
<auth_token/>
<seller_info>
<id>13517085</id>
<name/>
</seller_info>
<phone_call_time/>
<services/>
<votes>0</votes>
<isfavorited/>
<views_count>2</views_count>
<dt>1494870465</dt>
</ad>
</data>
</result>
Категории
| Id | Название |
|---|---|
| 394 | Бизнес |
| 839 | Другое |
| 792 | Животные и растения |
| 674 | Личные вещи |
| 1 | Недвижимость |
| 810 | Отдам даром |
| 134 | Работа и образование |
| 461 | Товары для дома и дачи |
| 39 | Транспорт |
| 740 | Хобби и отдых |
| 198 | Электроника и бытовая техника |
Регионы / Города
| Id | Название |
|---|---|
| 2 | Адыгея Респ |
| 5 | Алтай Респ |
| 7 | Алтайский край |
| 20 | Амурская обл |
| 31 | Архангельская обл |
| 45 | Астраханская обл |
| 53 | Башкортостан Респ |
| 75 | Белгородская обл |
| 87 | Брянская обл |
| 104 | Бурятия Респ |
| 111 | Владимирская обл |
| 135 | Волгоградская обл |
| 155 | Вологодская обл |
| 171 | Воронежская обл |
| 188 | Дагестан Респ |
| 199 | Еврейская Аобл |
| 202 | Забайкальский край |
| 213 | Ивановская обл |
| 231 | Ингушетия Респ |
| 236 | Иркутская обл |
| 260 | Кабардино-Балкарская Респ |
| 269 | Калининградская обл |
| 292 | Калмыкия Респ |
| 296 | Калужская обл |
| 321 | Камчатский край |
| 325 | Карачаево-Черкесская Респ |
| 330 | Карелия Респ |
| 344 | Кемеровская обл |
| 365 | Кировская обл |
| 384 | Коми Респ |
| 395 | Костромская обл |
| 408 | Краснодарский край |
| 435 | Красноярский край |
| 459 | Крым Респ |
| 476 | Курганская обл |
| 486 | Курская обл |
| 497 | Ленинградская обл |
| 530 | Липецкая обл |
| 539 | Магаданская обл |
| 542 | Марий Эл Респ |
| 547 | Мордовия Респ |
| 555 | Москва регион |
| 561 | Московская обл |
| 646 | Мурманская обл |
| 665 | Ненецкий АО |
| 667 | Нижегородская обл |
| 697 | Новгородская обл |
| 709 | Новосибирская обл |
| 725 | Омская обл |
| 732 | Оренбургская обл |
| 745 | Орловская обл |
| 753 | Пензенская обл |
| 767 | Пермский край |
| 793 | Приморский край |
| 807 | Псковская обл |
| 823 | Ростовская обл |
| 847 | Рязанская обл |
| 860 | Самарская обл |
| 872 | Санкт-Петербург регион |
| 883 | Саратовская обл |
| 905 | Саха /Якутия/ Респ |
| 919 | Сахалинская обл |
| 935 | Свердловская обл |
| 984 | Севастополь регион |
| 987 | Северная Осетия - Алания Респ |
| 994 | Смоленская обл |
| 1010 | Ставропольский край |
| 1030 | Тамбовская обл |
| 1039 | Татарстан Респ |
| 1063 | Тверская обл |
| 1087 | Томская обл |
| 1094 | Тульская обл |
| 1114 | Тыва Респ |
| 1120 | Тюменская обл |
| 1126 | Удмуртская Респ |
| 1133 | Ульяновская обл |
| 1140 | Хабаровский край |
| 1148 | Хакасия Респ |
| 1154 | Ханты-Мансийский Автономный округ - Югра АО |
| 1171 | Челябинская обл |
| 1203 | Чеченская Респ |
| 1209 | Чувашская Респ |
| 1219 | Чукотский АО |
| 1223 | Ямало-Ненецкий АО |
| 1232 | Ярославская обл |