API закупок: поиск извещений

API и MCP

Поиск извещений по ключевым словам и получение карточки закупки.

Поиск по сайту закупок. Сводная аналитика по поставщику и уведомления не входят.

Задача

Отбор закупок под профиль поставщика.

Быстрый старт

Проверьте доступ
Получите пробный доступ или подключите пакет в кабинете.
Подготовьте ключ
Используйте ключ с доступом к этому продукту из раздела API-ключи.
Выполните запрос с вашего сервера
Замените YOUR_API_KEY своим ключом. Начните с одного запроса, затем проверьте поля ответа.

curl · пример запроса

curl -X POST \
  https://api.atomno-mcp.ru/zakupki/v1/search \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"бумага","page":1}'

Доступ и авторизация

Заголовок ключа

X-API-Key: YOUR_API_KEY

Допустим также заголовок Authorization: Bearer YOUR_API_KEY. Передавайте один способ авторизации в запросе.

Храните ключ на сервере вашего приложения. Не публикуйте его в клиентском коде и не передавайте в URL.

Запрос и параметры

POSThttps://api.atomno-mcp.ru/zakupki/v1/search

JSON · тело запроса

{
  "query": "бумага",
  "page": 1
}

Параметр	Назначение
`query`	Поисковая строка
`page`	Номер страницы результатов

Ответ и поля

JSON · учебный пример

{
  "query_echo": {
    "query": "бумага"
  },
  "total_estimated": null,
  "tenders": [],
  "next_page_token": null
}

Учебный фрагмент структуры ответа. Это не результат проверки компании или поиска документов.

Поле	Что содержит
`tenders`	Найденные извещения
`total_estimated`	Оценка количества результатов
`reg_number`	Номер закупки
`publish_date`	Дата публикации
`url_eis`	Ссылка на извещение
`fetched_at`	Время получения
`search_meta`	Сведения об источнике поиска

Ошибки

HTTP	Причина и действие
`401`	Ключ отсутствует или не принят Проверьте заголовок и действующий ключ.
`403`	Нет доступа к продукту Проверьте подключённый пакет и срок подписки.
`400 / 422`	Ошибка параметров Исправьте формат и обязательные поля запроса.
`429`	Превышен лимит Уменьшите частоту и проверьте остаток квоты.
`502 / 503`	Источник или сервис недоступен Не трактуйте отказ как отсутствие данных; сохраните код и текст ошибки.

При повторяющейся ошибке сообщите поддержке метод, время запроса и код ответа. Ключ отправлять не нужно.

Условия использования

Карточка закупки: POST /zakupki/v1/tender, тело {"reg_number":"номер закупки"}.

Метод /supplier-stats не поддерживается: ответ not_implemented не означает отсутствие закупок.

Происхождение данных

zakupki.gov.ru. Дату сведений и ссылки на документы учитывайте вместе с результатом.

Все инструменты Тарифы и доступ