API торгов: фильтр, история, балл и вебхук

API в этом проекте читает уже собранную ленту открытых торгов. Он не обходит сайты из вашего браузера и не подаёт заявку. Запрос с ключом возвращает JSON: регион, категория, цены, источник, ссылка на площадку, а на старших тарифах ещё история, балл и резюме. Заголовок X-Total-Count говорит, сколько строк подошло под фильтр, даже если на страницу вернулась часть. Смысл простой. Вы перестаёте копировать заголовки руками и начинаете повторять один и тот же запрос завтра.

Проблема самодельного парсера не в том, что он «нелегален на словах», а в том, что он хрупок и часто тащит в таблицу лишнее: телефоны, сканы документов, персональные куски, которые в карточку Torgi как раз не пишутся. Отдельный текст про парсинг ЕФРСБ ещё готовится и ниже без ссылки. Пока рабочая развилка такая. Если вам нужен устойчивый фильтр и вы не хотите сопровождать вёрстку чужого кабинета, смотрите список лотов. Если вам нужен юридически значимый оригинал сообщения, вы всё равно открываете площадку и реестр. API оригинал не заменяет.

Разбор полей, который окупается в первый день. region, category, q, min_discount, price_from, price_to, source, status, sort, group=canonical, limit и offset. pre_market=true показывает ранние оценки из отчётов, когда торги ещё не опубликованы: это другой статус данных, не скрытый лот. Учебная команда curl и таблица параметров лежат на странице документации, там же якоря по ЕФРСБ и ГИС Торги. Источник имеет смысл передавать явно, иначе квартира должника и помещение публичного собственника сядут в одну выдачу. Почему это разные процедуры, см. разбор площадок.

История цен, балл и вебхук включаются не все сразу. Start за 2 990 ₽ даёт 10 000 запросов и ряд цен. Pro за 9 900 ₽ добавляет вебхуки и flip_score, в конфигурации API квота 100 000 запросов, плюс краткое резюме карточки. Business за 29 900 ₽ добавляет CSV и статистику организаторов при квоте 1 000 000. Free за 0 ₽ — 200 запросов и без оценки. Вебхук подписывается заголовком X-Torgi-Sign: HMAC тела вашим ключом. Ключ в блог не кладётся. Адрес на частный IP отвергается. Слежка без узкого фильтра — способ утонуть в почте, а не стратегия.

Пример внедрения без геройства. День первый: пробный ключ и один регион с одной категорией, сверка трёх карточек с площадкой. День второй: если ряд цен нужен для спора «это уже пятое снижение или первое», подключается Start. День третий: если ленту смотрят каждый день, на Pro вешают вебхук на тот же фильтр и балл как вторую сортировку. Балл не первый юрист. Для квартиры порядок чтения людей, доли и задатка описан в инструкции, и ни одно поле JSON его не отменяет.

Вывод. Хаб API — про повторяемый доступ к открытой ленте и про границы этого доступа. Считайте дисконт сигналом сортировки. Считайте балл порядком чтения. Считайте вебхук доставкой события, подпись которого вы проверяете. Не считайте ничего из этого размером задатка: его смотрите в карточке лота на ЕФРСБ или ЭТП. Тарифная сетка целиком — на странице тарифов, ключ на 200 запросов — на главной.