API тендерів компанії: замовник і переможець у Prozorro
Оновлено 26.09.2026
Initask API за кодом ЄДРПОУ повертає підсумок участі компанії у публічних закупівлях Prozorro: кількість тендерів замовника і їх очікувану суму, кількість перемог і суму договорів. До підсумку додається перелік тендерів обраної ролі з номером, назвою, статусом, сумою, датою і посиланням, найсвіжіші першими. Адреса `GET https://dani.initask.com/v1/company/{edrpou}/tenders`.
Для чого
Оцінка контрагента за досвідом у держзакупівлях, пошук постачальників з перемогами і аналітика ринку закупівель. Компанія, яка регулярно виграє тендери, пройшла кваліфікацію замовників і виконує договори з державою. Для нового партнера це вагомий сигнал.
Параметри
| Параметр | Де | Обовʼязковий | Опис |
|---|---|---|---|
| edrpou | у шляху | так | код ЄДРПОУ (8 цифр) або РНОКПП підприємця (10 цифр) |
| role | у запиті | ні | buyer: тендери, які компанія оголосила як замовник; winner: тендери, які вона виграла; без параметра buyer |
| limit | у запиті | ні | скільки тендерів у переліку, від 1 до 200; без параметра 50 |
На відміну від картки компанії, тут працює і РНОКПП підприємця: ФОП часто беруть участь у закупівлях як постачальники.
``` curl -H "Authorization: Bearer $INITASK_KEY" "https://dani.initask.com/v1/company/42062483/tenders?role=buyer&limit=3" ```
Поля відповіді
| Поле | Значення |
|---|---|
| edrpou | код |
| name | назва з Prozorro |
| as_buyer | тендерів як замовник |
| buyer_sum | очікувана сума тендерів замовника, грн |
| as_winner | перемог як учасник |
| win_sum | сума перемог, грн |
| role | роль переліку: buyer або winner |
| total | скільки всього тендерів у цій ролі |
| items | тендери, найсвіжіші першими; null, коли перелік тимчасово недоступний |
| items[].tenderID | номер тендера в Prozorro |
| items[].title | назва закупівлі |
| items[].status | статус у Prozorro |
| items[].amount | очікувана сума замовника або сума перемоги |
| items[].date | дата оголошення або перемоги |
Крім цих полів, відповідь містить посилання на сторінки тендерів замовника і перемог учасника, валюту кожного тендера і посилання на сторінку тендера. Повний перелік є в документації.
Підсумкові поля `as_buyer`, `buyer_sum`, `as_winner` і `win_sum` приходять завжди, незалежно від ролі переліку. Тому один запит дає загальну картину, а перелік показує деталі потрібної ролі.
Як отримати перемоги
Додайте `role=winner`: у `items` прийдуть перемоги з сумою договору і датою перемоги. Параметр `limit` задає до 200 тендерів за запит. Для перевірки контрагента зазвичай вистачає кількох останніх перемог: видно, що і для кого компанія постачала останнім часом.
Як використати тендери в перевірці контрагента
Для постачальника найцікавіше число це перемоги і їх сума. Кілька перемог за останній рік означають, що компанія реально працює, має досвід оформлення документів і пройшла перевірки замовників. Відсутність перемог нічого поганого не означає: багато сумлінних компаній просто не працюють з державою.
Для замовника, тобто державної установи чи комунального підприємства, корисна інша картина: скільки закупівель оголошено і на яку суму. Це показує масштаб і регулярність потреб, що важливо для постачальника, який планує участь у торгах.
Перелік останніх тендерів з назвами дає зрозуміти профіль компанії: що саме вона купує чи постачає.
Нулі і null
Нулі в підсумку означають, що у завантажених тендерах компанія не була ні замовником, ні переможцем. Поле `name` тоді дорівнює null, а `items` порожній масив. Це нормальна відповідь по суті.
Значення `items: null` означає інше: перелік тимчасово недоступний, а підсумок прийшов. Код має розрізняти ці два випадки і не показувати «тендерів немає», коли перелік просто не завантажився.
Помилки
| Код | Помилка | Коли |
|---|---|---|
| 400 | bad_request | код має довжину, відмінну від 5-8 або 10 цифр, role поза buyer і winner або limit поза 1-200 |
Джерело і ліміти
Дані з відкритого API Prozorro: сервіс tender.initask.com завантажує тендери і рахує підсумки за кодом замовника і переможця. Кеш відповіді 10 хвилин.
| План | Запитів | Ціна, грн на місяць |
|---|---|---|
| Безкоштовний | 100 на добу | 0 |
| Старт | 10000 на місяць | 990 |
| Про | 100000 на місяць | 2990 |
Ключ передається заголовком `Authorization: Bearer КЛЮЧ` або параметром `key`. Коли ліміт вичерпано, приходить 429 з `Retry-After`.
Що робити
- Відкрийте документацію тендерів і запитайте код з прикладу.
- Повторіть запит з `role=winner` для компанії, яка постачає державі.
- У картці контрагента показуйте чотири підсумкові числа і посилання на сторінки замовника і учасника.
- Обробляйте `items: null` окремо від порожнього масиву.
- Назву і стан компанії беріть з картки за ЄДРПОУ, а якщо відома лише назва, почніть з пошуку компаній.
Питання і відповіді
Як отримати тендери компанії з Prozorro через API?
Зробіть запит GET https://dani.initask.com/v1/company/{edrpou}/tenders. Відповідь містить кількість тендерів замовника, перемоги, суми і перелік тендерів обраної ролі.
Як отримати тендери, які компанія виграла?
Додайте role=winner: у items прийдуть перемоги з сумою договору і датою перемоги. Параметр limit задає до 200 тендерів за запит.
Чому у відповіді нулі?
Нулі означають, що у завантажених тендерах компанія не була ні замовником, ні переможцем. Поле name тоді дорівнює null, а items порожній масив.