Новое объявление
Карточка с ценой, ссылкой, фото и данными продавца в JSON. Набор полей один для поддерживаемых площадок; неприменимые поля остаются пустыми.
new listing
Что приходит
Не выгрузка каталога, а поток событий по вашим поискам
Сначала настройте поиск в Visi: ссылка с площадки и её фильтры сохраняются как есть. Затем API передаёт то, что сервис увидел по этому поиску.
Снижение цены
Отдельное событие приходит при каждом снижении. Его можно связать с исходным объявлением и обновить карточку в CRM или таблице.
price drop
Дополнительные сведения
Для части объявлений Авито позже поступают характеристики, состояние, доставка и оценка цены. Это обновление, а не новое объявление.
details
Два способа
Вебхук или опрос ленты
Вебхук — без постоянного опроса
Visi сам отправляет событие POST-запросом на ваш адрес. Подходит для Albato, Make, n8n, CRM и простых автоматизаций: новое событие приходит сразу, как только появляется.
webhook
Опрос ленты — для своего кода
Ваш сервис забирает новые события по API-ключу и сохраняет курсор. При следующем запросе продолжает с того места, где остановился.
polling
⚠️
Ключ — это доступ к вашей выдаче. Не публикуйте его в коде, таблицах с общим доступом и скриншотах. Если ключ утёк, перевыпустите его в личном кабинете бота — старый перестанет работать.
Быстрый старт
Подключение занимает четыре шага
Шаг 01
Включите тариф с API
Подойдёт бесплатный Пробный тариф на 24 часа: один поиск, API и вебхук уже включены.
Шаг 02
Добавьте поиск в Visi
Пришлите боту ссылку на поиск Авито, ЦИАН, ДомКлика, Drom или auto.ru с нужными фильтрами.
Шаг 03
Возьмите ключ или задайте вебхук
В боте откройте «Личный кабинет»: ключ выдаётся отдельной кнопкой, адрес вебхука задаётся там же.
Шаг 04
Подключите вашу систему
Для точного формата событий, полей, ограничений и примеров откройте техническую документацию.
🔑
Проверить ключ за минуту. Подставьте свой ключ в запрос: пустой список событий — нормально, они появятся с первым новым объявлением по вашему поиску.
curl -H "X-API-Key: visi_xxx" "https://api.visi.su/api/v1/events?limit=5"Шлюз
Нужна разовая выдача, а не ожидание события?
В API есть шлюз: он получает страницу поиска или каталога по вашей ссылке и возвращает объявления в том же формате, что и события. Поиск не нужно предварительно добавлять в бота. Для карточки одного объявления есть отдельный метод: по ссылке он отдаёт описание, фото, характеристики и продавца.
| Задача | Что выбрать |
|---|---|
| Следить за своими сохранёнными поисками | События: вебхук или опрос ленты |
| Один раз проверить выдачу по ссылке | Шлюз API |
| Изменить фильтры и список поисков | Бот Visi, не API |
Лимиты: 6 запросов выдачи и 12 карточек в минуту, до 1500 в сутки. На Пробном тарифе для шлюза доступно 50 запросов за весь пробный период — этого хватает, чтобы проверить интеграцию до оплаты.
Вопросы
Что важно знать до подключения
Нет. Поиск, фильтры и стоп-слова настраиваются в боте Visi. API передаёт результат по уже готовым поискам — так в данные попадает ровно та выдача, которую вы задали на площадке.
Это значит, что по вашему поиску пока не было новых объявлений или снижения цены. API получает те же события, что и уведомления Visi: нет нового в ленте — нечего передавать.
Нет. Для вебхука достаточно указать адрес в личном кабинете. API-ключ нужен, когда ваш сервис сам забирает события из ленты.
Доступ к API остановится вместе с тарифом. Ключ сохраняется: после подключения тарифа с API интеграция продолжит работать без перенастройки.
Читайте также
Парсер Авито для новых объявлений
Как Visi сохраняет фильтры поиска и передаёт каждое новое объявление в чат или систему.
Объявления в CRM и таблицу
Чем вебхук отличается от опроса ленты и какой способ выбрать под вашу задачу.
Бот для Авито
Настройте поиск, фильтры и уведомления — это основа для дальнейшей передачи данных в API.
Начать в Telegram
Открыть в MAX