Пробный API

1. Ключ

Кабинет → Аккаунт и тариф → «Пробный API» → «Получить пробный ключ». Скопируйте avi_test_… сразу — полностью он показывается один раз.

2. Запуск

curl -X POST https://aviparse.ru/api/v1/trial/tasks \
  -H "Authorization: Bearer avi_test_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"query": "iPhone 15", "region": "moskva", "pages_count": 2}'

Нужны query или link (ссылка на выдачу Авито) и pages_count — от 1 до 5. Необязательно: price_min, price_max, category, sort_type. В ответе — task_id.

3. Результат

curl https://aviparse.ru/api/v1/trial/tasks/TASK_ID -H "Authorization: Bearer avi_test_ВАШ_КЛЮЧ"          # статус
curl https://aviparse.ru/api/v1/trial/tasks/TASK_ID/results -H "Authorization: Bearer avi_test_ВАШ_КЛЮЧ"  # объявления
curl https://aviparse.ru/api/v1/trial/me -H "Authorization: Bearer avi_test_ВАШ_КЛЮЧ"                     # остаток страниц

4. Выгрузка

curl -OJ https://aviparse.ru/api/v1/trial/tasks/TASK_ID/export -H "Authorization: Bearer avi_test_ВАШ_КЛЮЧ"  # JSON-файл
curl -OJ https://aviparse.ru/api/v1/trial/tasks/TASK_ID/photos -H "Authorization: Bearer avi_test_ВАШ_КЛЮЧ"  # ZIP с фото

В архиве — папка на каждое объявление (ID/01.jpg, 02.webp … — формат как на Авито: JPEG или WebP) и index.json со ссылками и названиями. Фото одного объявления: /photos?ad_id=ID. Ссылки на фото есть и в JSON — поле images.

Ограничения

• 5 страниц на аккаунт один раз; списываются при запуске, при отмене не возвращаются.
• Закончились страницы — ошибка TRIAL_LIMIT_EXCEEDED; неверный ключ — INVALID_API_KEY.
• Без отложенного запуска, баланса и сотрудников — это есть в корпоративном API по тарифу.