Строка поиска позволяет искать тендеры:

  • по ИНН и наименованию заказчика, например, «Аэрофлот»
  • по месту поставки, например, «Новосибирск»
  • по предмету тендера, например, «погружной насос», «строительство Владивосток»
  • по ОКПД2 или КТРУ, например, «20.59.43»
  • по номеру тендера с нашего сайта или с ЕИС

Важно! Если указать несколько ключевых слов, то в результаты поиска не войдут тендеры, которые содержат только одно ключевое слово.

Для создания сложных поисковых запросов с несколькими ключевыми словами и словами-исключениями воспользуйтесь расширенным поиском.

Строка поиска позволяет искать тендеры:

  • по ИНН и наименованию заказчика, например, «Аэрофлот»
  • по месту поставки, например, «Новосибирск»
  • по предмету тендера, например, «погружной насос», «строительство Владивосток»
  • по ОКПД2 или КТРУ, например, «20.59.43»
  • по номеру тендера с нашего сайта или с ЕИС

Важно! Если указать несколько ключевых слов, то в результаты поиска не войдут тендеры, которые содержат только одно ключевое слово.

Для создания сложных поисковых запросов с несколькими ключевыми словами и словами-исключениями воспользуйтесь расширенным поиском.

Client API (РосТендер)

Документация для интеграции вашего сервиса с РосТендер: получение карточек тендеров, шаблонов поиска, избранного и меток.

Базовый URL: https://rostender.info/api/tenders/get/


Как пользоваться

  • Базовый путь: api/tenders/get/
  • Только метод GET
  • Ответ по умолчанию — JSON (UTF-8). Для XML: заголовок Accept: application/xml

Успешный ответ:

{
  "success": true,
  "data": { },
  "_meta": { }
}

_meta есть только у списков с пагинацией (и содержит в том числе применённый sort).

Ошибка:

{
  "success": false,
  "message": "Описание ошибки",
  "code": 404
}

code в теле совпадает с HTTP-статусом ответа (400, 403, 404, 500 и т.д.).

  • 400 — неверные параметры (в т.ч. недопустимый sort)
  • 401 — нет или неверный ключ X-API-KEY
  • 403 — API недоступен по тарифу или исчерпан дневной лимит
  • 404 — ресурс не найден

Сортировка списков

Параметр sort — у template/{id}, favorites, tag/{id}.

Эндпоинт Дефолт
template/{id} new-first
favorites first-changed
tag/{id} new-first

Стандартные значения (как в ЛК):

  • new-first — сначала новые
  • old-first — сначала старые
  • first-changed — сначала с изменениями
  • cheap-top — по убыванию цены
  • expensive-top — по возрастанию цены

Названия cheap-top и expensive-top сохранены для совместимости с личным кабинетом. Ориентируйтесь на указанное направление сортировки.


Авторизация

В каждом запросе передавайте API-ключ в заголовке:

X-API-KEY: <ваш_ключ>

Ключ выдаётся в личном кабинете: Профиль → Интеграции → API (/profile/api). Там же — дневной лимит и журнал запросов.

  • Лимит общий для всех ключей клиента, сутки по Москве (сброс в 00:00)
  • По одному запросу списывают только успешные ответы (2xx) методов {id}, eis/{number} и template/{id}
  • info, templates, tags, tag/{id} и favorites лимит не расходуют
  • В ответе: заголовки X-RateLimit-Limit и X-RateLimit-Remaining

Не передавайте ключ в URL и не публикуйте его в логах. Ответ метода info содержит полный текущий ключ в current_api_key, поэтому его тоже следует считать секретом.

curl -s -H "X-API-KEY: YOUR_API_KEY_HERE" \
  "https://rostender.info/api/tenders/get/info"

Работа с аккаунтами

Если у клиента несколько аккаунтов, в запросе favorites можно передать account_id. Аккаунт должен принадлежать владельцу API-ключа. Если параметр не указан, используется аккаунт по умолчанию.

Шаблон поиска уже содержит нужный аккаунт, поэтому для template/{id} передавать account_id не требуется. Ссылка files.archive формируется для аккаунта, связанного с API-ключом.


Справочник методов

Все запросы — GET, ключ в заголовке X-API-KEY.

Полный URL: https://rostender.info/api/tenders/get/<метод>


Эндпоинты

Лимит и ключ

GET api/tenders/get/info — лимит не списывается.

curl -s -H "X-API-KEY: YOUR_API_KEY_HERE" \
  "https://rostender.info/api/tenders/get/info"
{
  "success": true,
  "data": {
    "client_id": 1,
    "current_api_key": "YOUR_API_KEY_HERE",
    "daily_limit": 1000,
    "used_today": 51,
    "remaining": 949,
    "resets_at": "2026-07-17T00:00:00+03:00",
    "api_keys": [
      {
        "is_active": 1,
        "created_at": "2026-06-04 17:10:54",
        "key_preview": "abcd1234...wxyz7890"
      }
    ]
  }
}
ПолеТипОписание
client_idintegerID клиента
current_api_keystringПолный ключ, которым выполнен запрос; секретное значение
daily_limitintegerДневной лимит; 0 означает, что тарифицируемые методы недоступны
used_todayintegerЧисло списанных запросов за текущие сутки MSK
remainingintegerОстаток лимита
resets_atstringНачало следующих суток MSK в ISO 8601
api_keys[]arrayВсе ключи клиента: маска, признак активности и дата создания

key_preview показывает первые и последние 8 символов ключа через многоточие; is_active = 1 означает активный ключ, is_active = 0 — деактивированный или отозванный ключ; created_at — дата и время в формате YYYY-MM-DD HH:MM:SS.


Карточка тендера по ID

GET api/tenders/get/{id}

id — обязательное положительное целое число: ID обычного или архивного тендера, электронной процедуры (ЕП) либо 12-значный ID позиции плана закупки. Для плана нужен доступ по тарифу и отсутствие блокировки клиента. Иначе возвращается 403: «Доступ к планам закупок ограничен вашим тарифом.»

У позиции плана is_plans = true. У тендера или ЕП plan содержит связанную позицию плана при наличии связи и доступа; иначе возвращается null.

files.archive — ссылка на ZIP документов (ключ для скачивания не нужен).

Значения поля stage

Значение Описание
Планируемая закупка Закупка включена в план, но извещение о её проведении ещё не опубликовано. Заявки подавать нельзя, а сроки и условия могут измениться.
Приём заявок Закупка активна: поставщики могут изучать документацию и подавать заявки до установленного срока.
Работа комиссии Приём заявок завершён. Заказчик рассматривает заявки, проводит торги, сравнивает предложения или подводит итоги.
Завершён Закупочная процедура закончена: итоги подведены либо завершились предусмотренные процедурой сроки.
Отменён Объявленная закупка официально отменена; дальнейшее проведение процедуры прекращено.
Пустая строка Этап отсутствует в исходных данных или не определён.

Одинаковые значения используются в полной карточке и элементах списков. Значения передаются как точные строки UTF-8 и чувствительны к написанию, включая букву ё. Для позиции плана закупки возвращается Планируемая закупка, для электронной процедуры — Завершён. Интеграция должна корректно обрабатывать пустую строку и неизвестное строковое значение: в будущем перечень этапов может расширяться.

Значения поля type

ЗначениеОписание
commerceКоммерческая закупка
223Закупка по 223-ФЗ
44Закупка по 44-ФЗ
615Закупка по Постановлению Правительства РФ № 615
Пустая строкаКатегория не определена в исходных данных

Для позиции плана type сейчас передаётся целым числом: 1 — коммерческая, 2 — 223-ФЗ, 3 — 44-ФЗ, 4 — ПП РФ № 615. Интеграции следует учитывать оба представления и неизвестные будущие значения.

Логические признаки и флаги доступа

Полеtruefalse
is_plansКарточка является позицией планаТендер или электронная процедура
smpЗакупка для субъектов малого предпринимательстваПризнак не установлен
favoritesAvailableМожно добавить в избранноеДобавление недоступно в текущем контексте
customerAvailableДоступны полный предмет закупки и данные заказчикаПолные данные ограничены
tagsAvailableМожно добавлять меткиДобавление меток недоступно
commentsAvailableМожно добавлять комментарииДобавление комментариев недоступно
inFavoritesКарточка уже в избранномКарточки нет в избранном

Флаги *Available показывают возможность действия для текущего аккаунта, а не наличие данных. Они могут меняться вместе с правами, тарифом или аккаунтом.

curl -s -H "X-API-KEY: YOUR_API_KEY_HERE" \
  "https://rostender.info/api/tenders/get/987654"
{
  "success": true,
  "data": {
    "id": 92747611,
    "url": "https://rostender.info/tender/92747611",
    "dts": "2026-06-01",
    "dte": "2026-06-01",
    "dte-formatted": "2026-06-01 11:00:00",
    "price": {
      "value": null,
      "currency": "RUB",
      "amounts": []
    },
    "type": "commerce",
    "stage": "Завершён",
    "is_plans": false,
    "plan": null,
    "smp": false,
    "place": "г. Новоалтайск, г. Кемерово",
    "delivery_address": [
      "Российская Федерация, Кемеровская область, г. Кемерово, ул. Ленина, д. 1"
    ],
    "regions": ["Алтайский край", "Кемеровская область"],
    "cities": ["Кемерово город"],
    "branches": ["Овощи, Фрукты, в том числе консервированные, Сухофрукты"],
    "placement": {
      "title": "Прочее",
      "source": "Стандартные торги"
    },
    "customer": {
      "name": "ООО Мария-РА",
      "inn": "",
      "contacts": {
        "person": "",
        "phone": "",
        "email": ""
      }
    },
    "descr": "Дополнительные торги Фрукты - Овощи",
    "positions": [
      {
        "name": "ОВОЩИ КАРТОФЕЛЬ ФАС. 2.5КГ",
        "unit": "шт",
        "price": null,
        "classifier": null
      }
    ],
    "favoritesAvailable": false,
    "customerAvailable": true,
    "tagsAvailable": true,
    "commentsAvailable": true,
    "inFavorites": false,
    "eis": "",
    "etp": ["800638306"],
    "links": [],
    "files": {
      "archive": "https://rostender.info/integration/files-archive?t=...",
      "items": [
        {
          "title": "Извещение.pdf",
          "extension": "pdf",
          "link": "https://example.com/file.pdf",
          "size": "245 Kb",
          "created_at": "2026-06-01 10:00:00"
        }
      ]
    }
  }
}

Карточка по номеру ЕИС / площадки

GET api/tenders/get/eis/{number}

number — обязательная непустая строка: номер из ЕИС или с торговой площадки (как в поиске на сайте). Возвращается одна карточка тендера, ЕП или позиции плана; формат ответа и ограничения доступа к планам такие же, как у карточки по ID. Передавайте номер строкой, сохраняя ведущие нули; специальные символы кодируйте для URL.

curl -s -H "X-API-KEY: YOUR_API_KEY_HERE" \
  "https://rostender.info/api/tenders/get/eis/800638306"
{
  "success": true,
  "data": {
    "id": 92747611,
    "url": "https://rostender.info/tender/92747611",
    "dts": "2026-06-01",
    "dte": "2026-06-01",
    "dte-formatted": "2026-06-01 11:00:00",
    "eis": "",
    "etp": ["800638306"]
  }
}

Список шаблонов

GET api/tenders/get/templates

Возвращаются видимые шаблоны клиента. Элемент содержит id (integer), name (string) и shared: 1 — общий шаблон для учётных записей клиента в многопользовательском режиме, 0 — личный. Если шаблонов нет, data — пустой массив.

curl -s -H "X-API-KEY: YOUR_API_KEY_HERE" \
  "https://rostender.info/api/tenders/get/templates"
{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "Все тендеры",
      "shared": 0
    },
    {
      "id": 2,
      "name": "Все тендеры2",
      "shared": 0
    }
  ]
}

Тендеры по шаблону

GET api/tenders/get/template/{id}?page=1&sort=new-first — по 100 записей на страницу.

id — обязательный ID доступного клиенту шаблона; page — номер страницы, по умолчанию 1; sort — см. Сортировка списков (по умолчанию new-first). Неизвестная сортировка возвращает 400, недоступный шаблон — 403.

curl -s -H "X-API-KEY: YOUR_API_KEY_HERE" \
  "https://rostender.info/api/tenders/get/template/101?page=1&sort=cheap-top"
{
  "success": true,
  "data": [
    {
      "id": 92822826,
      "url": "https://rostender.info/tender/92822826",
      "dts": "2026-06-01",
      "dte": "2026-06-10 17:00:00",
      "price": {
        "value": 1500000,
        "currency": "RUB"
      },
      "place": "Волгоградская обл",
      "regions": "Волгоградская область",
      "stage": ""
    }
  ],
  "_meta": {
    "totalCount": 250,
    "pageCount": 3,
    "currentPage": 1,
    "perPage": 100,
    "sort": "cheap-top"
  }
}

Избранное

GET api/tenders/get/favorites?account_id=5001&page=1&sort=first-changed — без account_id берётся аккаунт по умолчанию.

account_id должен принадлежать клиенту; иначе возвращается 404. page — номер страницы, по умолчанию 1. Параметр sort — см. Сортировка списков (по умолчанию first-changed).

curl -s -H "X-API-KEY: YOUR_API_KEY_HERE" \
  "https://rostender.info/api/tenders/get/favorites?account_id=5001&page=1&sort=cheap-top"
{
  "success": true,
  "data": [
    {
      "id": 92633254,
      "url": "https://rostender.info/tender/92633254",
      "dts": "2026-05-27 11:31:29",
      "dte": "2026-05-29 16:00:00",
      "price": {
        "value": 0,
        "currency": "RUB"
      },
      "place": "Архангельская обл",
      "regions": "Архангельская область",
      "stage": ""
    }
  ],
  "_meta": {
    "totalCount": 13,
    "pageCount": 1,
    "currentPage": 1,
    "perPage": 100,
    "sort": "cheap-top"
  }
}

Метки

GET api/tenders/get/tags

Возвращаются видимые метки клиента: id (integer) и name (string). Если меток нет, data — пустой массив.

curl -s -H "X-API-KEY: YOUR_API_KEY_HERE" \
  "https://rostender.info/api/tenders/get/tags"
{
  "success": true,
  "data": [
    { "id": 2351, "name": "Тест" },
    { "id": 405, "name": "Проверка" }
  ]
}

Тендеры по метке

GET api/tenders/get/tag/{id}?page=1&sort=new-first

id — обязательный ID метки клиента; неизвестная метка возвращает 404. page — номер страницы, по умолчанию 1. Параметр sort — см. Сортировка списков (по умолчанию new-first).

curl -s -H "X-API-KEY: YOUR_API_KEY_HERE" \
  "https://rostender.info/api/tenders/get/tag/55?page=1&sort=cheap-top"
{
  "success": true,
  "data": [
    {
      "id": 62414710,
      "url": "https://rostender.info/tender/62414710",
      "dts": "2022-09-05 16:45:14",
      "dte": "2022-09-08 17:00:00",
      "price": {
        "value": 220000,
        "currency": "RUB"
      },
      "place": "Георгиевский район, станица Георгиевская",
      "regions": "Ставропольский край",
      "stage": ""
    }
  ],
  "_meta": {
    "totalCount": 4,
    "pageCount": 1,
    "currentPage": 1,
    "perPage": 100,
    "sort": "cheap-top"
  }
}

Форматы данных

Полная карточка

Используется в {id} и eis/{number}. Поле data — один объект.

  • id, url — идентификатор и ссылка на карточку на сайте
  • dts, dte, dte-formatted — строки с датами либо null
  • price — value, currency, amounts; value — число или null при отсутствующей или нулевой цене
  • type — правовая категория закупки; stage — этап закупки; is_plans, smp — логические признаки
  • plan — связанная позиция плана или null. Поля: id (целое число), eis и contract (строка или null), url (путь /plan/{id})
  • place — место поставки; при отсутствии данных возможен false; delivery_address — адреса поставки (массив строк). Адрес поставки распознан автоматически. Проверьте его в документации; regions, cities, branches — массивы строк
  • placement — title, source (площадка / источник)
  • customer — name, inn, contacts (person, phone, email)
  • descr, positions[] — описание и позиции (name, unit, price, classifier)
  • favoritesAvailable, customerAvailable, tagsAvailable, commentsAvailable, inFavorites — возможности и состояние в текущем аккаунте
  • eis, etp, links — номера и внешние ссылки
  • files — документы (см. ниже)

Краткий формат (списки)

Используется в template/{id}, favorites, tag/{id}. Поле data — массив объектов:

  • id, url
  • dts, dte
  • price — value, currency
  • place, regions
  • stage — этап тендера или пустая строка

В списках цена передаётся без нормализации полной карточки: price.value может быть 0. Даты dts и dte могут быть null.

Для полных данных запросите карточку по id или eis/{number}.

Документы (files)

  • archive — ссылка на ZIP всех файлов; заголовок X-API-KEY при скачивании не нужен
  • items[] — отдельные файлы: title, link, extension, size, created_at
  • extension — формат файла (расширение, например pdf или docx); null, если не определён
  • У файлов по тендерам ЕП расширение отсутствует: extension возвращается со значением null

Пагинация и сортировка (_meta)

В списках с постраничной выдачей (шаблон, избранное, метки):

  • totalCount — всего записей
  • pageCount — число страниц
  • currentPage — текущая страница (с 1)
  • perPage — размер страницы (100 записей)
  • sort — применённый алиас сортировки

Параметры запроса: page (по умолчанию 1), sort — см. Сортировка списков. Используйте положительный номер страницы. Параметра для изменения perPage нет. При пустой выборке data = [], totalCount = 0 и pageCount = 0; при запросе страницы за пределами выдачи data будет пустым.


С чего начать

  1. Проверить ключ и лимит — GET .../info
  2. Получить шаблоны — GET .../templates
  3. Тендеры по шаблону — GET .../template/{id}?page=1&sort=new-first
  4. Полная карточка — GET .../{id} или GET .../eis/{number}
  5. Избранное и метки — favorites?sort=first-changed, tags, tag/{id}?sort=new-first

Успешные запросы (HTTP 2xx) к {id}, eis/{number} и template/{id} расходуют по одному запросу из дневного лимита.

Методы info, templates, tags, tag/{id} и favorites не расходуют дневной лимит. Все обращения можно посмотреть в журнале запросов личного кабинета.

Ответы с ошибками (HTTP 4xx/5xx) не расходуют дневной лимит. Следите за заголовками X-RateLimit-Remaining и полем remaining в ответе info.