Торги.Открыто

API-доступ к данным

Read-only JSON API поверх того же нормализованного каталога, что и веб-версия. Сейчас API временно бесплатен и не требует ключа — как и остальные функции, изначально задуманные для Pro. В будущем возможны авторизация и лимиты, но уже открытый доступ бесплатным и останется для тех, кто пришёл раньше.

GET/api/lots

Список лотов с фильтрами и пагинацией — те же параметры, что и у каталога /.

qПоиск: слова из названия, адреса, кадастрового номера, VIN, № дела.
channelКанал(ы) через запятую: bankruptcy, gov_property, arrested_property.
categoryКатегория(и): real_estate, transport, land, equipment, claims, other.
regionКод(ы) региона через запятую, напр. 77,78.
formФорма торгов: open_auction, public_offer, competition.
statusСтатус(ы) торгов через запятую: announced, accepting_bids, in_progress, completed, cancelled.
pmin / pmaxДиапазон цены (₽), по текущей цене лота.
depmin / depmaxДиапазон задатка (₽).
areamin / areamaxДиапазон площади (м²) — у лотов без площади фильтр не применяется.
datefrom / datetoДиапазон дат начала торгов, формат YYYY-MM-DD.
discountminМин. % снижения текущей цены к стартовой (в т.ч. для публичного предложения).
riskfreeriskfree=1 — только лоты без тревожных флагов (залог/ЕГРЮЛ/ФССП).
photophoto=1 — только лоты с фото (сейчас реально есть лишь у канала bank_collateral).
sortfresh (по умолчанию), bidding_end, price_asc, price_desc, discount_desc.
pageНомер страницы, начиная с 1.
pageSizeРазмер страницы, по умолчанию 20, максимум 100.
curl "https://ваш-домен/api/lots?category=real_estate&region=77&sort=price_asc&pageSize=10"

Ответ

{
  "meta": { "total": 21, "page": 1, "pageSize": 10, "totalPages": 3 },
  "items": [ { "id": "lot_...", "title": "...", "channel": "gov_property", ... } ]
}

GET/api/lots/:id

Один лот целиком, с источниками и историей цены.

curl "https://ваш-домен/api/lots/lot_fcee680b4d03a680a161"

Ответ

{ "item": { "id": "lot_fcee680b4d03a680a161", "title": "...", "sources": [...], "priceSchedule": [...] } }

// Если лот не найден:
{ "error": "Лот не найден" }  // HTTP 404
Поля лота полностью совпадают с карточкой лота в интерфейсе — каноничный нормализованный объект (категория, регион, цены, задаток, форма торгов, организатор, должник, источники-дедуп, история изменений цены). Точную схему полей смотрите в ответе — она не урезана относительно веб-версии.

Нужна вся отфильтрованная выборка одним файлом, а не через пагинацию? Смотрите кнопку «Экспорт CSV» в каталоге.