API Prozorro.Продажі: як отримувати дані аукціонів у свою програму

Усі дані Prozorro.Продажі — лоти, документи, підсумки торгів — відкриті: система публікує їх через програмний інтерфейс, і брати їх може будь-хто. Нижче — як влаштований цей API, на що зважати, якщо писати свою інтеграцію, і як отримати ті самі дані вже готовими.

Відкритий API Prozorro.Продажі

Центральна база ЦБД-нова відповідає за двома адресами:

Основні запити:

• /search/byDateModified/{дата}?limit=100 — стрічка всіх процедур за датою зміни; з неї будують синхронізацію;
• /procedures/{_id} — повна процедура; /procedures/{_id}/history — її версії;
• /search/byAuctionId/{UA-…} — лот за номером аукціону;
• /search/byAuctionOrganizer/{ЄДРПОУ}, /search/byText/{текст}, /search/bySellingMethod/{метод} — пошук;
• /registry/objects/{_id}, /registry/assets/{_id} — об’єкти оренди й приватизації.

curl -s --compressed "https://procedure.prozorro.sale/api/search/byDateModified/2026-10-01T00:00:00Z?limit=100"

Ключ не потрібен. Опис полів (Swagger) є лише на тестовому сервері procedure-sandbox.prozorro.sale/api/doc; стара база ЦБД-1 (public.api.ea.openprocurement.org) заморожена з 2021 року — нових лотів там немає.

Граблі власної інтеграції

• Дві бази. Лотів ФГВФО в основній базі немає — опитувати треба обидві.
• Не більше 100 записів за запит. limit=500 мовчки віддає 100; щоб пройти місяць, потрібні сотні запитів.
• Лише поточний стан. Стрічка віддає процедуру такою, як вона є зараз: якщо між двома опитуваннями ціну змінили двічі, проміжне значення ви не побачите. Що саме змінилося — рахувати самому, порівнюючи з попередньою версією.
• Немає фільтрів за областю чи типом. Щоб знайти «оренду приміщень у Вінниці», доведеться завантажити все й відбирати в себе — і розбирати адреси, бо місто записане по-різному.
• Повтори того самого об’єкта — окремі процедури; зв’язок — через previousAuctionId і об’єкти реєстру.

Це все розв’язно — ми самі так збираємо базу: зараз у ній 41 тисяча лотів, щомісяця додається 10–12 тисяч. Але на це йдуть тижні розробки й постійний нагляд.

Готовий API LotRadar

Ті самі дані, вже очищені й розкладені, — через REST API /api/v1/:

• /lots — лоти з тими самими фільтрами, що й у каталозі: тип, область, місто, тема, ціна, слова, статус, дати публікації й зміни;
• /lots/{UA-…} — усі поля лота, 50 останніх змін і інші аукціони того самого об’єкта;
• /changes — стрічка подій (новий лот, зміна статусу, ціни, дат, документів, підсумок) з курсором — нічого не пропустите між запитами;
• /filters/{id}/lots — лоти за фільтром, збереженим у кабінеті;
• вебхуки — сервер сам надсилає вам POST із новими лотами й змінами (lot.new, lot.changed, lot.relisted), з підписом HMAC і повторами, якщо ваш сервер не відповів.

Відповіді — JSON, підписи українською або англійською (?lang=en). Ключ — у кабінеті, передається в заголовку Authorization: Bearer. Ліміт — 1 000 запитів на добу на тарифі Профі й 20 000 на тарифі Бізнес. Повний опис з прикладами — у документації API, ціни — на сторінці тарифів.

Що обрати

• Потрібна вся система з усіма полями, наукове дослідження чи власне сховище — беріть відкритий API Prozorro.Продажі.
• Потрібні конкретні лоти у вашій CRM, таблиці чи боті, з фільтрами й подіями — простіше взяти наш API: перші результати за годину, а не за місяць.
• Програміст не потрібен зовсім — фільтр у кабінеті, сповіщення в Telegram-бот і вивантаження в Excel.

Дані про відкритий API — наша перевірка запитами; кількість лотів — наша база станом на 17 жовтня 2026 року.