Ошибки API Авито: 401, 403, 429 — причины и решения
back to top
Блог Sapix

Ошибки и лимиты API Авито: 401, 403, 429 и что с ними делать

Антон Сапченко Антон Сапченко, основатель Sapix 15 ноября 2026 3 мин чтения
Ошибки и лимиты API Авито: 401, 403, 429 и что с ними делать

Интеграция с Авито работала неделю, а потом сообщения перестали приходить, и в логах появились непонятные 401 и 429. Меня зовут Антон Сапченко, я авитолог-практик, основатель агентства Sapchenko Studio и сервиса Sapix. Разберу самые частые ошибки API Авито: что они значат, почему возникают и как их исправить без паники.

API Авито развивается: появляются новые методы, меняются версии и ограничения. Ниже — логика работы простыми словами; точные адреса методов, параметры и лимиты сверяйте с официальной документацией Авито для разработчиков на дату настройки.

Как вообще устроен доступ к API

Работа с API Авито начинается с ключей: Client ID и Client Secret. По ним вы получаете токен доступа и прикладываете его к каждому запросу. У токена ограниченный срок жизни — он указан в ответе при выдаче. Когда срок выходит, нужно получить новый. Подробнее о ключах — в статье как получить API-ключ Авито, а о структуре методов — в материале документация API Авито простыми словами.

401 — не авторизован

Самая частая ошибка. Авито не принимает ваш токен.

  • Токен истёк. Решение — автоматически запрашивать новый до окончания срока или при первом 401.
  • Неверные ключи. Опечатка, лишний пробел, ключи от другого аккаунта.
  • Ключи перевыпустили. Если владелец аккаунта сгенерировал новые ключи, старые перестают работать.

403 — доступ запрещён

Токен действителен, но на это действие прав нет.

  • метод недоступен для вашего типа аккаунта или тарифа;
  • вы обращаетесь к данным другого аккаунта;
  • у приложения нет нужного разрешения.

Проверьте, какие возможности API открыты вашему аккаунту, — это зависит от его типа и подключённых инструментов Авито для бизнеса.

404 — не найдено

Неверный адрес метода, устаревшая версия API или объект, которого уже нет: удалённый чат, снятое объявление. Сверьте путь с актуальной документацией.

429 — слишком много запросов

У API есть ограничения на частоту запросов. Если превысить лимит, Авито временно перестаёт отвечать на ваши запросы. Что делать:

  • Делайте паузу и повторяйте. При 429 не бомбите API повторами — увеличивайте интервал между попытками.
  • Не опрашивайте зря. Для сообщений используйте вебхуки вместо частого опроса — об этом в статье вебхуки Авито.
  • Кэшируйте. Данные, которые меняются редко, не нужно запрашивать каждую минуту.
  • Распределяйте нагрузку. Если аккаунтов много, не запускайте все запросы в одну секунду.

5xx — ошибки на стороне Авито

500, 502, 503 означают, что проблема не у вас. Правильная реакция — повторить запрос позже с паузой и не терять данные: ставить задачу в очередь, а не выбрасывать её.

Как не терять данные из-за ошибок

  1. Логируйте каждый ответ API с кодом и временем.
  2. Обновляйте токен автоматически.
  3. Повторяйте неудачные запросы с растущей паузой.
  4. Настройте оповещение, если ошибки идут подряд.
  5. Периодически сверяйте данные полностью, чтобы найти пропуски.

Для авитолога, который ведёт много клиентов, ошибка в одном аккаунте легко теряется среди остальных. Поэтому важно видеть статус каждого подключения — так устроен мониторинг аккаунтов Sapix: если с аккаунтом что-то не так, вы узнаёте об этом сразу.

А если проблема не в технике, а в том, что объявления не приносят обращений, начните с аудита аккаунта Авито.

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

Почему API Авито вдруг перестал работать?

Чаще всего истёк токен или владелец перевыпустил ключи. Реже — превышен лимит запросов или изменилась версия метода.

Сколько живёт токен Авито?

Ограниченное время, которое указано в ответе при выдаче токена. Закладывайте автоматическое обновление.

Какие лимиты у API Авито?

Они зависят от метода и могут меняться. Ориентируйтесь на документацию и на ответ 429 как на сигнал снизить частоту.

Можно ли избежать этих проблем без программиста?

Да, если работать через сервис, который сам обновляет токены, повторяет запросы и следит за лимитами.

Подключите Авито без программиста

Sapix работает с официальным API Авито: вы вставляете ключи, а сообщения, отзывы, статистика и уведомления собираются в одном окне. Первый месяц бесплатно, карта не нужна.

Попробовать Sapix бесплатно

Антон Сапченко
Антон СапченкоОснователь Sapix, авитолог-практик

Ведём клиентов на Авито каждый день. Всё, о чём пишу в блоге, сначала проверяем на реальных аккаунтах — и встраиваем в Sapix.