Выгружайте объявления avito.ru в свою CRM или в аналитику. Обновление базы каждую секунду — данные доступны в API сразу после сбора.
Подключим, поможем с первым запросом и подбором фильтров.
От регистрации до первого выгруженного объявления — меньше часа: всё происходит автоматически, без ожидания менеджера.
Укажите e-mail — он станет вашим логином в API.
В кабинете (Подключение и API-ключ) нажмите «Подключить тестовый доступ» — token отобразится на экране мгновенно.
Запрос /api/info вернёт информацию об аккаунте: срок доступа и лимиты.
Опрашивайте /api/ads раз в минуту с окном last_m=1 —
это типичная схема выгрузки «только что появившихся» объявлений.
curl -s "https://rest-app.net/api/info?login=user@mail.ru&token=ВАШ_КЛЮЧ"
Каждый запрос к API должен содержать два параметра (login и token). Все обращения — только по HTTPS.
| Параметр | Обязательный | Описание |
|---|---|---|
login | да | Логин пользователя в системе — ваш e-mail |
token | да | Access token, выдаётся в кабинете на странице Подключение и API-ключ |
Токен равен паролю от аккаунта: не размещайте его в JavaScript браузера, не коммитьте в репозитории и передайте только по HTTPS. Утёк — нажмите «Сменить» рядом с ключом в личном кабинете: новый токен активен сразу.
Базовый адрес — https://rest-app.net.
Все эндпоинты принимают методы GET и POST, ответ — json (по умолчанию), xml или csv.
/api/ads
поиск и выгрузка объявлений
Основной запрос для получения объявлений. За один запрос возвращается не больше 1000 объявлений. Минимальное списание — 1 ед. с суточного лимита.
| Параметр | Обяз. | Описание |
|---|---|---|
login | да | E-mail пользователя |
token | да | Access token |
category_id | да | Идентификатор подкатегории (одна из 51; верхний уровень дерева — ошибка), 0 — все категории |
region_id | нет | Идентификатор региона |
city_id | нет | Идентификатор города |
last_m | нет | Последние N минут (1–30). Перекрывает date1/date2. По умолчанию 30 — если не задан ни один временной фильтр, сервер отдаёт последние 30 минут |
last_s | нет | Последние N секунд (1–60). Перекрывает last_m и date1/date2 |
date1 | нет | Дата от: 2026-09-10 09:05:45 или 2026-09-10 |
date2 | нет | Дата до (формат как date1);
без времени — это 00:00 указанного дня |
price1 | нет | Цена от |
price2 | нет | Цена до |
q | нет | Текст поиска, до 150 символов. Спецсимволы — через urlencode() |
in | нет | Где искать q: title (default) или description |
phone | нет | Фильтр по телефону продавца: 11 цифр, начиная с 8
(напр. 89001234567), иначе — Error phone format.
Спишет минимум 10 ед. с суточного лимита |
pv | нет | Значение в параметрах объявления, напр. pv=Жёсткие+диски.
Категория должна быть выбрана |
sort | нет | По дате добавления в базу: asc / desc (default) |
limit | нет | Не больше 1000 (default 1000); в тестовом доступе — не больше 50 |
offset | нет | Смещение (default 0) |
format | нет | json (default), xml, csv |
https://rest-app.net/api/ads? login=user@mail.ru&token=ВАШ_КЛЮЧ&category_id=9 https://rest-app.net/api/ads? login=…&token=…&category_id=9 &date1=2026-11-10+17:00:00&date2=2026-11-10+18:00:00 https://rest-app.net/api/ads? login=…&token=…&category_id=9&format=xml&limit=10 https://rest-app.net/api/ads? login=…&token=…&category_id=9&last_m=5&price1=500000&price2=2000000
curl -s "https://rest-app.net/api/ads?login=user@mail.ru&token=ВАШ_КЛЮЧ&category_id=9&last_m=5"
<?php
date_default_timezone_set('Europe/Moscow');
$login = 'user@mail.ru'; // ваш логин в системе
$token = 'ВАШ_КЛЮЧ'; // access token из личного кабинета
// запрос к API: категория 9, последняя минута
$url = "https://rest-app.net/api/ads?login=" . urlencode($login)
. "&token=" . urlencode($token)
. "&category_id=9&last_m=1";
$str = file_get_contents($url);
$json = json_decode($str);
foreach ($json->data as $ad) {
// заголовок, город, телефон
echo $ad->title . ';' . $ad->city . ';' . $ad->phone;
echo '<br/>';
}
import requests
params = {
"login": "user@mail.ru",
"token": "ВАШ_КЛЮЧ",
"category_id": 9,
"last_m": 5,
}
r = requests.get("https://rest-app.net/api/ads", params=params)
for ad in r.json()["data"]:
print(ad["title"], ad["city"], ad["phone"])
/api/ad
объявление по id
Получение объявления по его идентификатору на avito.ru
(avito_id). Снятое с публикации или несуществующее объявление —
пустой "data": [] без ошибки.
В тестовом доступе (15 дней) эндпоинт недоступен — работает только на полном доступе.
| Параметр | Обяз. | Описание |
|---|---|---|
login | да | E-mail пользователя |
token | да | Access token |
id | да | Идентификатор объявления на avito.ru |
format | нет | json, xml, csv |
https://rest-app.net/api/ad? login=user@mail.ru&token=ВАШ_КЛЮЧ&id=685674499
/api/info
информация об аккаунте
Проверка доступа: вернёт status и информацию
по аккаунту. Удобно использовать для мониторинга («жив ли ключ»).
api_time_limit — окончание доступа (unix-time; в тесте — +15 дней
от активации), demo: 1 — тестовый доступ,
api_limit — счётчик суток: used (потрачено сегодня)
из of (10 000 на все API-площадки, сброс в 00:00 GMT+0).
| Параметр | Обяз. | Описание |
|---|---|---|
login | да | E-mail пользователя |
token | да | Access token |
format | нет | json, xml, csv |
https://rest-app.net/api/info? login=user@mail.ru&token=ВАШ_КЛЮЧ
{
"status": "ok",
"data": {
"balance": "0.00",
"api_time_limit": 1794334861,
"demo": 1,
"api_limit": { "used": 61, "of": 10000 }
}
}
/api/region, /api/city, /api/category
регионы, города и категории
Открытые справочники: работают без login/token —
/api/region — список регионов,
/api/city?id=… — населённые пункты региона
(без id — все города с parent_Id),
/api/category — дерево категорий.
| Параметр | Обяз. | Описание |
|---|---|---|
id | для /api/city | Идентификатор региона |
format | нет | json, xml, csv |
https://rest-app.net/api/region https://rest-app.net/api/city?id=621590
Ответ содержит статус ok или error
и массив объявлений data. У каждого объявления — контакты,
геоданные, фото и характеристики.
{
"status": "ok",
"data": [
{
"Id": "3168056726",
"url": "https://www.avito.ru/kirov/avtomobili/…",
"avito_id": "3168056726",
"title": "Hyundai Santa Fe 2.7 AT, 2008, 230 000 км",
"price": 3900000,
"time": "2026-10-26 20:29:10",
"operator": "",
"phone": "89127654321",
"name": "Пользователь",
"region": "Кировская область",
"city": "Киров",
"district": "Ленинский",
"address": "Кировская обл., Киров, мкр-н Дружба",
"metro": "",
"images": "https://40.img.avito.st/image/1/…, …",
"description": "Продаю семейный автомобиль. В одних руках 4 года…",
"params": [
{ "name": "Год выпуска", "value": "2008" },
{ "name": "Пробег", "value": "230 000 км" },
{ "name": "Коробка передач", "value": "Автомат" },
{ "name": "Тип кузова", "value": "Внедорожник 5-дверный" }
],
"category_Id": "1",
"subcategory_Id": "9",
"region_Id": "650130",
"city_Id": "650210",
"marka": "Hyundai",
"model": "Santa Fe",
"year": "2008",
"coords": { "lat": 58.638, "lng": 49.655 },
"other": []
}
]
}
В тестовом доступе сервер подменяет
чувствительные поля: phone → последние три цифры
заменены на XXX, url и avito_id
→ "hidden_in_demo", а price — случайная.
Остальная структура — боевая.
<?xml version="1.0" encoding="UTF-8"?>
<result>
<status>ok</status>
<data>
<ad>
<Id>56020970</Id>
<url>https://www.avito.ru/sankt-peterburg/avtomobili/…</url>
<avito_id>709412345</avito_id>
<title>Mitsubishi Pajero 3.2 AT, 2009, внедорожник</title>
<price>999000</price>
<time>2026-11-10 11:59:50</time>
<operator>Tele2</operator>
<phone>89522151607</phone>
<name>Владелец</name>
<region>Санкт-Петербург</region>
<metro>Площадь Мужества</metro>
<images>https://89.img.avito.st/640x480/2182791389.jpg,…</images>
<description>Внедорожник в отличном состоянии…</description>
</ad>
</data>
</result>
csv: разделитель ;, кодировка
Windows-1251; характеристики —
name=value|name=value.
| Поле | Описание |
|---|---|
Id / avito_id | Идентификаторы в базе и на avito.ru |
url | Ссылка на объявление |
title / description | Заголовок и текст |
price | Цена, руб. |
time | Дата и время добавления в базу |
phone / name / operator |
Контакты продавца (в тесте последние три цифры phone = XXX) |
region / city / district / address / metro |
География объявления |
images | URL фото через запятую |
params / other | Массивы характеристик name/value |
coords | Координаты lat/lng, если есть |
category_Id / subcategory_Id / region_Id / city_Id |
Идентификаторы категории и географии |
marka / model / year / body /
transmission / engine_vol |
Автомобильные характеристики (для соответствующих категорий) |
Ошибка приходит с HTTP 400,
status = error, текст — в message.
{
"status": "error",
"error_code": 400,
"message": "Access denied"
}
message | Причина |
|---|---|
Not set param(s) token | Не передан обязательный параметр (так же — category_id и др.) |
Access denied | Неверный логин или token |
Expiry date 31.12.2026 23:59 | Срок доступа истёк (дата в сообщении) |
Exceeded the daily limit | Выбран суточный лимит — сброс в 00:00 GMT+0 |
Please check value in param category_id | Несуществующая категория (аналогично — region_id) |
Please check value in param q (max len 150 chars) | Поисковый запрос длиннее 150 символов |
Error phone format | Телефон не в формате 8+10 цифр |
Access denied! This function is available only after the payment of access |
Эндпоинт /ad (и др. платные) на тестовом доступе |
Error: Too Many Requests | Слишком частые обращения — сделайте паузу |
API рассчитана на периодические обращения — раз в 1–5 минут — и загрузку объявлений в CRM или аналитическую систему. Время в запросах и ответах — московское.
Запрашивайте окно last_m=1 (или last_s) каждую минуту —
так вы не пропустите ни одного объявления и не запросите лишнее.
*/5 * * * * /path/to/php /path/to/script.php * * * * * /path/to/php /path/to/script.php
Для Windows — стандартный планировщик заданий.
Вместо классической пагинации двигайте временное окно параметрами
date1/date2 (например, шаг — 1 час) и не забывайте
делать паузу между запросами.
$login = 'user@mail.ru'; // ваш логин в системе
$token = 'ВАШ_КЛЮЧ'; // access token из личного кабинета
$date_start = new DateTime('7 days ago');
$date_finish = new DateTime();
$interval = "+1 hour";
while ($date_start < $date_finish) {
$date1 = clone $date_start;
$date_start->modify($interval);
$date2 = ($date_start > $date_finish)
? clone $date_finish : clone $date_start;
$url = "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(file_get_contents($url), true);
if ($arr['status'] == 'error') { die($arr['message']); }
foreach ($arr['data'] as $ad) {
// сохраняем объявления
}
sleep(2); // пауза между запросами
}
Соберите URL запроса /api/ads —
подставьте свои логин и токен, скопируйте и вставьте в браузер или консоль.
Запросы без логина вернут status: error —
это нормально, конструктор работает офлайн.
Идентификаторы категорий, регионов и городов — те же, что
возвращают /api/category, /api/region, /api/city
(справочники открыты, работают без токена).
Ничего не найдено.
Ничего не найдено.
/api/ad.last_m или last_s.date1/date2
порциями (минута, час — по объёму категории) с паузой между запросами.
Пример кода — в разделе «Опрос базы по расписанию».Тест 15 дней бесплатно, настройка за один вечер, 8 (499) 991-71-61
Остались вопросы по интеграции? Пишите на info@rest-app.net — поможем. Или загляните в инструкции.