Подключение и получение ключа
Пять шагов от регистрации до рабочих запросов: регистрация, тест 15 дней, оплата, выдача login и token, проверка доступа.
Как подключиться — 5 шагов
Логин для API — это ваш e-mail. Token выдаётся автоматически сразу после активации тестового доступа — на экране личного кабинета.
Создайте аккаунт на rest-app.net или войдите, если уже зарегистрировались
Нажмите «Подключить тестовый доступ на 15 дней (бесплатно)» в кабинете — тест включится сразу,
token появится на экране. Выдаётся один раз. Доступны все эндпоинты, кроме /ad, но есть ограничения:
до 50 записей за запрос, случайная цена; суточный лимит 10 000 объявлений работает и в тесте.
Один доступ для получения объявлений с: Avito, Auto.ru, Cian, Drom.ru, Youla и других. В стоимость входит до 10 000 объявлений в сутки — лимит между всеми API общий: например, авто можно забирать с Avito, Auto.ru и Drom в рамках одного лимита. Нужно больше? Каждые дополнительные 10 000 объявлений в сутки — +3000 ₽ на 30 дней (для 30 000/сутки: 4000 + 3000 + 3000 = 10 000 ₽). Оплата — через автоматическую платёжную систему: полный доступ активируется сразу после платежа.
login и token — на экране сразу после активации теста. Сохраните ключ сразу — в поддержке его не повторяют, а при утечке меняют кнопкой «Сменить» у ключа.
Если в ответе "status":"ok" — вы готовы, переходите
к выгрузке объявлений.
curl -s "https://rest-app.net/api/info?login=user@mail.ru&token=ВАШ_КЛЮЧ"
Тестовый и полный доступ
| Возможность | Тест: 15 дней | Полный: от 4 000 ₽/мес |
|---|---|---|
Эндпоинт /ads | ||
Эндпоинт /ad (объявление по id/url) | ||
| Объявлений за запрос | до 50 | до 1 000 |
| Объявлений в сутки — лимит общий для всех API | до 10 000 | до 10 000 |
| Увеличение суточного лимита (+10 000) | — | +3 000 ₽ / 30 дней |
| Цены в выдаче | случайные | реальные |
| Площадки: Avito, Auto.ru, Cian, Drom.ru, Youla | ||
| json, xml, csv | ||
| Продление после теста | — |
На тестовом доступе можно полностью написать и отладить интеграцию: структура ответа и параметры совпадают с боевым режимом.
Безопасность ключа
Token равен паролю от аккаунта — его попадание к третьим лицам равнодоступу к вашему балансу запросов.
Все запросы к API идут по защищённому протоколу. Не передавайте ключ по e-mail в открытом виде.
Не вызывайте API из JavaScript на публичных страницах — ключ увидят посетители.
Храните ключ в переменных окружения или конфиге вне Git. В примерах — только заглушки.
Если ключ засветился — смените его сами: в кабинете рядом с ключом есть кнопка «Сменить»
Ошибки и диагностика
При проблемах API возвращает "status":"error"
и текстовое message. Типичные ситуации:
| Признак | Причина | Что делать |
|---|---|---|
status: error про авторизацию |
Неверные login или token |
Проверьте e-mail и ключ, символы передавайте через urlencode() |
Пустой массив data |
Под фильтр не попало ни одного объявления | Расширьте окно last_m или уберите часть фильтров |
| Ошибка лимита | Исчерпан суточный лимит запросов | Увеличьте интервал опроса, запрашивайте батчами по date1/date2 |
| Ошибка срока доступа | Закончились 15 дней теста или 30 дней оплаты | Продлите доступ в кабинете — оплата через платёжную систему, активация автоматическая |
Вопросы о подключении
Начните с бесплатных 15 дней
Регистрация, тестовый ключ и помощь с первым запросом
Документация по эндпоинтам — на страницах описания: API для доступа к объявлениям с avito.ru, API для доступа к объявлениям с auto.ru, API для доступа к объявлениям с cian.ru и другим