API торгов ЕФРСБ и ГИС Торги
Запрос лотов — это GET с заголовком x-api-key. Ответ — JSON-массив, а заголовок X-Total-Count говорит, сколько строк подошло под фильтр, даже если на страницу вернулась только часть. Ниже собраны параметры, которые уже умеет список, пример команды и два якоря: чем в этой ленте отличается источник ЕФРСБ от источника ГИС Торги.
Фильтры, сортировка, страница
Список живёт на /v1/lots. Регион передаётся кодом вроде region=msk или значением all. Категория — списком через запятую: квартира и авто в одном запросе выглядят как category=flat,auto. Нижняя граница дисконта — min_discount. Диапазон цены — price_from и price_to. Текст ищет параметр q. Источник ленты — source, организатор по ИНН — inn, тип процедуры — auction_type.
Статус по умолчанию оставляет активные лоты (active). Значение upcoming смотрит вперёд, any снимает этот фильтр. Параметр ends_after отсекает то, что заканчивается слишком скоро для вашей подготовки. pre_market=true показывает ранние оценки из отчётов, когда сами торги ещё не опубликованы: это не «скрытый лот с площадки», это другой вход в базу.
Сортировка задаётся sort: discount_desc, ends_asc, price_asc, score_desc. Сортировка по баллу полезна на тарифе, где балл вообще отдаётся. group=canonical схлопывает повторы одного и того же объекта, если они пришли из разных сообщений. Страница — limit от 1 до 100 и offset.
| Параметр | Зачем |
|---|---|
region, category, q | Сузить ленту до региона, типа имущества и слов из карточки. |
min_discount, price_from, price_to | Отрезать заведомо не ваш ценовой коридор. Дисконт без вашей проверки объекта не равен выгоде. |
source, inn, auction_type | Не смешивать реестр банкротства, ГИС Торги и конкретную ЭТП в одной куче. |
status, ends_after, pre_market | Отделить идущие торги, будущие и ранние оценки из отчётов. |
sort, group, limit, offset | Порядок, схлопывание повторов и постраничное чтение. |
Пример curl
Команда ниже — тот же учебный запрос, что стоял на первом лендинге. Ключ подставляете вы. Хост в примере схематичный: боевой адрес совпадает с тем, куда смотрит ваш клиент.
curl -H "x-api-key: $KEY" "https://api.example/v1/lots?region=msk&category=flat,auto&min_discount=30&q=квартира&sort=discount_desc&group=canonical"
Карточка одного лота — GET /v1/lots/{id}. На Start и выше в ней есть история цен. На Pro и выше появляются flip_score и краткое ai_summary. Поле due_diligence — это ссылки на кадастровую карту, реестр залогов, картотеку арбитражных дел и площадку, а не готовое заключение.
ЕФРСБ в этом API
Источник банкротных сообщений в фильтре отделён от остальных. Практический смысл якоря простой: квартира должника обычно начинается с сообщения в реестре и ссылки на ЭТП, где принимают заявку. В запрос имеет смысл явно передать источник, если вы не хотите увидеть в той же выдаче лот государственного имущества. Что именно лежит в сообщении — состав, задаток, сроки — читается в карточке на ЕФРСБ или на площадке. API не подменяет текст сообщения пересказом «типового регламента».
Сбер-АСТ и Lot-online в продукте — площадки проведения, а не второе имя реестра. Если в карточке указана одна из них, ставка и документы заявки живут там. Смешивать «нашёл в ЕФРСБ» и «заявку уже приняли» нельзя: нашёл — значит увидел публикацию, заявка — отдельное действие по правилам этой площадки.
ГИС Торги в этом API
ГИС Торги в ленте — отдельный source. Туда попадают процедуры государственного и муниципального контура, и у них другой бытовой вопрос: вы покупаете не «квартиру банкрота по привычной схеме», а лот той процедуры, которая указана в карточке. Фильтр по источнику как раз спасает от витрины, где оба мира лежат вперемешку. Сравнение контуров без рекламного шума — в статье ЕФРСБ и ГИС Торги.
Вебхук и заголовок X-Torgi-Sign
Слежка создаётся запросом POST /v1/watchers: в теле фильтр и webhook_url. Когда лот подходит, сервис шлёт тело события. Заголовок X-Torgi-Sign содержит HMAC-SHA256 этого тела, посчитанный ключом API, в виде sha256=<hex>. Проверка на вашей стороне — пересчитать HMAC тем же ключом и сравнить. Ключ в документацию, в блог и в логи чужого сервиса не кладут. Доставка на частный IP отвергается. Неуспех повторяется ограниченное число раз, журнал лежит в GET /v1/watchers/{id}/deliveries. Удаление слежки — DELETE на тот же ресурс. Вебхуки доступны на тарифе, где они включены: это Pro и Business, не Free и не Start.
Тот же ключ Pro понимает телеграм-команды смотрения, но бот не заменяет чтение карточки. Выгрузка CSV — GET /v1/export на Business, фильтры те же, что у списка. Витрина лендинга — отдельный публичный GET /v1/showcase без ключа, пять лотов и короткий ряд цены.
Дальше по смыслу: тарифы, как устроен flip_score и квартира с торгов. Пробный ключ на 200 запросов — на главной.