Внимание! Ведутся работы по доработке API. Если есть пожелания, присылайте их на почту info@rest-app.net

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

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

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

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

Доступ к API: Avito, Cian, Drom, Irr, Youla, Olx. Цена - 4000 руб. в месяц (30 дней).

Чтобы получить доступ, авторизуйтесь.

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

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


Описание API

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

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

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

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

Примеры:

https://rest-app.net/api-drom-ru/ads?login=ваш_логин&token=ваш_ключ
https://rest-app.net/api-drom-ru/ads?login=ваш_логин&token=ваш_ключ&date1=2025-12-05+17:00:00&date2=2025-12-05+18:00:00
https://rest-app.net/api-drom-ru/ads?login=ваш_логин&token=ваш_ключ&format=xml&limit=10
https://rest-app.net/api-drom-ru/ads?login=ваш_логин&token=ваш_ключ&format=xml&last_m=5

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

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

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

Примеры:

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

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

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

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

Примеры:

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

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

Скоро будет

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

<?xml version="1.0" encoding="UTF-8"?>
<result>
	<status>ok</status>
	<data>
		<ad>
			<Id>56020970</Id>
			<url>https://www.avito.ru/sankt-peterburg/avtomobili/mitsubishi_pajero_2009_709412345</url>
			<avito_id>709412345</avito_id>
			<title>Mitsubishi Pajero 3.2 AT, 2009, внедорожник</title>
			<price>999000</price>
			<time>2016-01-11 11:59:50</time>
			<operator>Tele2</operator>
			<phone>89522151607</phone>
			<name>Владелец</name>
			<region>Санкт-Петербург</region>
			<city/>
			<district/>
			<address/>
			<metro>Площадь Мужества</metro>
			<images>http://89.img.avito.st/640x480/2182791389.jpg,http://69.img.avito.st/640x480/2182793369.jpg</images>
			<description>Максимальная комплектация.Покупали новым в ноябре 2009 года у оф.дилера Mitsubishi.</description>
		</ad>
		<ad>
			<Id>56020971</Id>
			<url>https://www.avito.ru/samara/avtomobili/vaz_vesta_2015_709412344</url>
			<avito_id>709412344</avito_id>
			<title>ВАЗ (LADA) Vesta 1.6 МТ, 2015, седан</title>
			<price>528000</price>
			<time>2016-01-11 11:59:50</time>
			<operator>Билайн</operator>
			<phone>89033014579</phone>
			<name>Андрей</name>
			<region>Самарская область</region>
			<city>Самара</city>
			<district/>
			<address/>
			<metro>Безымянка</metro>
			<images>http://91.img.avito.st/640x480/2182779891.jpg</images>
			<description>LADA Vesta стильная, стремительная, яркая - такая, каким и должен быть автомобиль LADA.</description>
		</ad>
	</data>
</result>

Как использовать

API в основном предназначено для периодического к нему обращения, например, каждую минуту или 5 минут, и загрузки объявлений себе на сайт или CRM.


Пример на языке PHP (получение данных за последнюю минуту):

date_default_timezone_set('Europe/Moscow');
$login = 'user@mail.ru';     //здесь должен быть ваш логин в системе
$token = 'df6fd21c885ec9c55737*********';     //здесь должен быть ваш token

//делаем запрос к api
$str = file_get_contents("https://rest-app.net/api/ads?login=".urlencode($login)."&token=".urlencode($token)."&category_id=9&last_m=1");

//парсим ответ как json
$json = json_decode($str);

//проходим по всем объявлениям
foreach ($json->data as $ad)    //$ad - объект объявления
{
	//выводим: заголовок объявления, город, номер телефона
	echo $ad->title.';'.$ad->city.';'.$ad->phone;
	echo '<br/>';
}

Пример на языке PHP (получение данных за период):

date_default_timezone_set('Europe/Moscow');
$login = 'user@mail.ru';     //здесь должен быть ваш логин в системе
$token = 'df6fd21c885ec9c55737*********';     //здесь должен быть ваш token

//задаем время получаемых объявлений
$date = new DateTime();    //текущее время
$date1 = clone $date;      //копируем объект даты
$date1->modify("-32 minute");    //текущее минус 32 минуты
$date2 = clone $date;      //копируем объект даты
$date2->modify("-31 minute");   //текущее минус 31 минуты

//таким образом интервал $date1 и $date2 у нас будет 1 минута, теперь можно делать запрос

//делаем запрос к api
$str = file_get_contents("https://rest-app.net/api/ads?login=".urlencode($login)."&token=".urlencode($token)."&category_id=9"
						  ."&date1=".urlencode($date1->format('Y-m-d H:i:s'))
						  ."&date2=".urlencode($date2->format('Y-m-d H:i:s')));

//парсим ответ как json
$json = json_decode($str);

//проходим по всем объявлениям
foreach ($json->data as $ad)    //$ad - объект объявления
{
	//выводим: заголовок объявления, город, номер телефона
	echo $ad->title.';'.$ad->city.';'.$ad->phone;
	echo '<br/>';
}

Скрипт можно запускать по расписанию для получения новых объявлений.

Запук каждые 5 минут, пример для crontab: */5 * * * *   /path/to/php   /path/to/script

или каждую минуту, пример для crontab: * * * * *   /path/to/php   /path/to/script

Для Windows можно использовать стандартный планировщик заданий


Получение данных за большой период или пагинация:

Если вам надо получить объявления, для примера, за неделю, и нужна пагинация, то для этого используйте временной интервал. Т.е. вместо пагинации вы запрашиваете объявления порциями по 5 минут или даже за минуту, используя параметры date1 (Дата от) и date2 (Дата до) для задания границ временного интервала. Только между запросами обязательно делайте задержку.

Пример на языке PHP (получение данных за большой период):

date_default_timezone_set('Europe/Moscow');
$token = '6159c82bcb4ec5************'; //токен (ключ)
$login = 'user@mail.ru'; //логин

#шаг
$interval = "+1 hour";

#получение данных за период (с .. по ..)
$date_start = new DateTime('2017-01-01');
$date_finish = new DateTime(); // текущее время

$i=0;
while($date_start<$date_finish){
	$date1= clone $date_start;

	$date_start->modify($interval);
	if($date_start>$date_finish){
		$date2= clone $date_finish;
	}else{
		$date2= clone $date_start;
	}

	$str = get_data("https://rest-app.net/api/ads?login=".urlencode($login)."&token=".urlencode($token)."&category_id=24"
					  ."&date1=".urlencode($date1->format('Y-m-d H:i:s'))
					  ."&date2=".urlencode($date2->format('Y-m-d H:i:s'))."&limit=1000");

	$arr=json_decode($str, true);
	if($arr['status']=='error'){
		echo $arr['message']."\n";
		die;
	}

	if(!count($arr['data'])){
		continue;
	}

	foreach($arr['data'] as $ad){
		print_r($ad); //выводим объявления
	}

	sleep(2);
}

function get_data($url){
	$ch = curl_init();
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
	$output = curl_exec($ch);
	curl_close($ch);

	return $output;
}

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

region_id Название
1Москва
2Московская область
191Санкт-Петербург
192Ленинградская область
282Адыгея
308Алтайский край
388Амурская область
406Архангельская область
452Астраханская область
482Башкортостан
573Белгородская область
616Брянская область
662Бурятия
689Владимирская область
729Волгоградская область
781Вологодская область
815Воронежская область
886Дагестан
950Еврейская АО
962Забайкальский край
1013Ивановская область
1046Ингушетия
1060Иркутская область
1121Кабардино-Балкария
1153Калининградская область
1181Калмыкия
1192Калужская область
1229Камчатский край
1239Карачаево-Черкесия
1264Карелия
1290Кемеровская область
1344Кировская область
1397Коми
1434Костромская область
1461Краснодарский край
1692Красноярский край
2499Крым
1768Курганская область
1798Курская область
1832Липецкая область
1857Магаданская область
1868Марий Эл
1891Мордовия
1924Мурманская область
1955Ненецкий АО
1958Нижегородская область
2046Новгородская область
2067Новосибирская область
2118Омская область
2157Оренбургская область
2210Орловская область
2232Пензенская область
2276Пермский край
2351Приморский край
2415Псковская область
2442Республика Алтай
2451Ростовская область
2551Рязанская область
2584Самарская область
2648Саратовская область
2674Сахалинская область
2700Саха (Якутия)
2748Свердловская область
2865Северная Осетия
2895Смоленская область
2928Ставропольский край
3061Тамбовская область
3097Татарстан
3153Тверская область
3195Томская область
3224Тульская область
3273Тыва
3293Тюменская область
3336Удмуртия
3370Ульяновская область
3408Хабаровский край
3443Хакасия
3464Ханты-Мансийский АО
3504Челябинская область
3572Чеченская республика
3593Чувашия
3621Чукотский АО
3626Ямало-Ненецкий АО
3646Ярославская область

Содержание