API объявлений с avito.ru

Выгружайте объявления avito.ru в свою CRM или в аналитику. Обновление базы каждую секунду — данные доступны в API сразу после сбора.

1 сек обновление базы до 1000 объявлений за запрос json / xml / csv все площадки — один доступ тест 15 дней бесплатно

Быстрый старт

От регистрации до первого выгруженного объявления — меньше часа: всё происходит автоматически, без ожидания менеджера.

1
Зарегистрируйтесь на rest-app.net

Укажите e-mail — он станет вашим логином в API.

2
Включите тест 15 дней — token появится сразу

В кабинете (Подключение и API-ключ) нажмите «Подключить тестовый доступ» — token отобразится на экране мгновенно.

3
Проверьте доступ одним запросом

Запрос /api/info вернёт информацию об аккаунте: срок доступа и лимиты.

4
Забирайте свежие объявления

Опрашивайте /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.

GETPOST /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

Примеры запросов

частые сценарии: автомобили (категория 9)
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"])
GETPOST /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
GETPOST /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 }
  }
}
GETPOST /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
примеры: города региона 621590
https://rest-app.net/api/region
https://rest-app.net/api/city?id=621590

Структура ответа

Ответ содержит статус ok или error и массив объявлений data. У каждого объявления — контакты, геоданные, фото и характеристики.

реальный ответ /api/ads (полный доступ, сокращён)
{
  "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 — случайная. Остальная структура — боевая.

format=xml — та же структура, ad на каждый элемент
<?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 География объявления
imagesURL фото через запятую
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) каждую минуту — так вы не пропустите ни одного объявления и не запросите лишнее.

crontab: каждые 5 минут и каждую минуту
*/5 * * * * /path/to/php /path/to/script.php
* * * * * /path/to/php /path/to/script.php

Для Windows — стандартный планировщик заданий.

Выгрузка за большой период

Вместо классической пагинации двигайте временное окно параметрами date1/date2 (например, шаг — 1 час) и не забывайте делать паузу между запросами.

PHP — выгрузка за неделю, шаг 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 (справочники открыты, работают без токена).

Категории

Ничего не найдено.

Регионы

Ничего не найдено.

Города — 3624 шт.

Частые вопросы

Зарегистрируйтесь на rest-app.net и в кабинете (Подключение и API-ключ) нажмите «Подключить тестовый доступ на 15 дней» — он включится сразу, token появится на экране. Бесплатно и один раз. В тесте доступны все эндпоинты, кроме /api/ad.
Один доступ от 4000 ₽/мес покрывает все подключённые площадки — объявление можно забирать с любой, где оно есть. В стоимость входит выгрузка до 10 000 объявлений в сутки — лимит между всеми API общий: например, автомобильные объявления с разных площадок укладываются в один лимит. Нужно больше? Каждые дополнительные 10 000 объявлений в сутки — +3000 ₽ за 30 дней: запрос на 30 000 объявлений в сутки будет стоить 4000 + 3000 + 3000 = 10 000 ₽ за 30 дней. Полный доступ означает реальные цены в выдаче.
Объявления попадают в базу и становятся доступны API в среднем за секунду после сбора. Рекомендуемый режим опроса — раз в 1–5 минут с окном last_m или last_s.
Двигайте временное окно date1/date2 порциями (минута, час — по объёму категории) с паузой между запросами. Пример кода — в разделе «Опрос базы по расписанию».

Готовы забрать первые объявления?

Тест 15 дней бесплатно, настройка за один вечер, 8 (499) 991-71-61

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

Остались вопросы по интеграции? Пишите на info@rest-app.net — поможем. Или загляните в инструкции.