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 Ярославская обл