Об API

Баланс и списания

За что списывается баланс

API работает по модели "pay-per-tender" — вы платите только за новые тендеры, которые раньше не получали. За каждый новый тендер списывается 1 единица баланса.

Как это работает на практике

• Первый запрос: Запрашиваете тендеры по фильтру → получаете 20 тендеров → списывается 20 единиц баланса (если все новые)
• Повторный запрос через час: Запрашиваете те же тендеры → получаете те же 20 тендеров → баланс не списывается
• Запрос через день: Появились 5 новых тендеров → получаете 25 тендеров → списывается только 5 единиц за новые

Отслеживание в ответе API

В ответе на запрос тендеров вы видите:

{
  "new_tenders_count": 5,
  "remaining_balance": 995,
  "items": [...]
}

• new_tenders_count — сколько новых тендеров в этом запросе (столько и списалось с баланса)
• remaining_balance — ваш баланс после этого запроса
• is_new — флаг у каждого тендера, показывающий новый он или вы уже получали его раньше

Суточные лимиты

Для защиты от случайных ошибок и злоупотреблений действуют суточные лимиты на количество получаемых объектов. Лимиты сбрасываются каждый день в 00:00 по московскому времени.

Лимиты по типам

Как проверить текущий лимит

Запросите GET /balance — в ответе придет информация о лимитах:

{
  "limits": {
    "tenders": {
      "current": 45,
      "limit": 1000,
      "remaining": 955,
      "reset_at": "2026-03-21T00:00:00"
    }
  }
}

Фильтры и автопоиск

Как получить тендеры

Тендеры выдаются только по фильтрам, которые созданы в веб-интерфейсе zakupki.fraim.ru. Вы не можете запросить "все тендеры" — только те, что попадают под ваши настроенные фильтры.

Что такое автопоиск

У каждого фильтра есть настройка "Автопоиск". Только фильтры с включенным автопоиском собирают тендеры в фоне и дают доступ к ним через API.

Алгоритм работы

1. Создаёте фильтр в веб-интерфейсе zakupki.fraim.ru
2. Включаете "Автопоиск" для этого фильтра
3. Система начинает собирать подходящие тендеры в фоновом режиме
4. Через API запрашиваете тендеры по ID фильтра
5. Получаете только те тендеры, которые уже собраны

Избранное

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

Особенности

• Избранное привязано к пользователю API токена
• Один и тот же тендер можно добавить в избранное только один раз
• Добавление/удаление из избранного не влияет на баланс
• Получение деталей тендера из избранного списывает баланс, если вы ранее не получали этот тендер
• Отслеживание изменений: добавьте тендер в избранное и периодически проверяйте его детали — так вы увидите изменения статуса, цены, сроков

Сценарий использования избранного для отслеживания изменений

1. Находите интересный тендер через фильтры
2. Добавляете его в избранное POST /favorites/{tender_id}
3. Раз в день запрашиваете GET /favorites/updates — получаете только тендеры с изменениями
4. Запрашиваете детали обновлённых тендеров GET /tenders/{id}
5. Обнаруживаете изменения: сроки продлены, цена изменилась, статус обновлён, документы добавлены

Рекомендуемый сценарий использования

Для регулярного мониторинга

1. Настройте фильтры в веб-интерфейсе с включенным автопоиском
2. Раз в час/день запрашивайте тендеры по фильтру
3. Сохраняйте new_tenders_count и remaining_balance
4. Обрабатывайте только тендеры с is_new: true
5. При необходимости добавляйте интересные тендеры в избранное

Для получения деталей

1. Получаете список тендеров по фильтру
2. Для интересных тендеров запрашиваете детали по GET /tenders/{id}
3. Если много позиций — используйте GET /tenders/{id}/positions с пагинацией
4. Документы доступны в деталях тендера

Важные ограничения