API · Для розробників

Тендерні дані через API

Ті самі дані, що бачать користувачі Tender Radar, у вашій ERP, CRM чи сховищі: Prozorro, понад сотня комерційних майданчиків і порталів компаній, ЄС, Велика Британія та ООН. Один формат для всіх майданчиків, оновлення кожні кілька хвилин.

Отримати ключ / Замовити доступ Як підключитися

Що дає API

Кожен тендер приходить в одному форматі, хоч би де його опублікували: номер, назва, замовник з ЄДРПОУ, CPV, очікувана вартість, строки в часовому поясі замовника й в UTC, статус і посилання на оригінал. Якщо той самий тендер є на кількох майданчиках, ви отримуєте один запис зі списком усіх місць публікації.

Джерела

Prozorro — публічні закупівлі України
Комерційні майданчики й портали закупівель компаній України
Європейський Союз (TED)
Національні системи закупівель інших країн, зокрема Велика Британія
Міжнародні організації, зокрема ООН

Свіжість

Кожне джерело опитується за власним розкладом: найчастіші — кожні кілька хвилин, решта — від години до кількох годин. Поле updated_at показує, коли запис востаннє змінився.

Поля тендера

Поле	Опис
id	Постійний ідентифікатор запису в Radar (UUID). За ним оновлюйте рядки у себе.
number	Номер тендера в джерелі, наприклад UA-2026-10-11-000337-a.
title · title_translated · description · language	Назва й опис мовою оригіналу; переклад назви іноземного тендера українською, якщо він є.
status · status_source	Статус в єдиній шкалі Radar і статус так, як його подає джерело.
procedure	Тип процедури: код і назва.
buyer	Замовник: назва, ЄДРПОУ або національний ідентифікатор, регіон, населений пункт.
cpv	Основний код CPV з назвою й додаткові коди.
value	Очікувана вартість, валюта і чи враховано ПДВ.
published_at · submission_deadline · enquiry_end · auction_at	Дати й строки: місцевий час замовника (local) і UTC (utc); time_zone — часовий пояс замовника.
source · url · also_on	Джерело, посилання на оригінал та інші майданчики, де опубліковано той самий тендер.
lots · items · documents	Лоти, позиції й документи, якщо джерело їх публікує.
radar_url · first_seen_at · updated_at	Картка в Radar, коли ми вперше побачили тендер і коли запис востаннє змінився.

Автентифікація

Кожен запит несе ключ організації в заголовку Authorization: Bearer rdr_live_…. Ключ належить компанії, а не людині: його можна віддати сервісу чи інтеграції.

1Ключі створює власник або адміністратор компанії в Tender Radar: Налаштування → «API».
2Повний ключ ми показуємо один раз, одразу після створення. Збережіть його в менеджері секретів або змінній оточення.
3Ми зберігаємо лише хеш ключа, тож показати його вдруге не зможемо. Загубили ключ — відкличте його й створіть новий.
4Відкликаний ключ перестає працювати одразу. Для кожної інтеграції краще мати окремий ключ (до 10 активних).

Базова адреса

https://platform.aurum-apps.com/v1/data

Authorization: Bearer rdr_live_…

Перший запит

Відкриті тендери на покрівельні роботи в Україні. Ключ береться зі змінної оточення RADAR_API_KEY.

curlPythonJavaScript

curl -H "Authorization: Bearer $RADAR_API_KEY" \
  "https://platform.aurum-apps.com/v1/data/tenders?cpv=4526&country=UA&limit=100"

import os
import httpx

API = "https://platform.aurum-apps.com/v1/data"
headers = {"Authorization": f"Bearer {os.environ['RADAR_API_KEY']}"}

r = httpx.get(f"{API}/tenders", params={"cpv": "4526", "country": "UA", "limit": 100}, headers=headers)
r.raise_for_status()
for tender in r.json()["data"]:
    print(tender["number"], tender["title"], tender["submission_deadline"])

const API = "https://platform.aurum-apps.com/v1/data";
const headers = { Authorization: `Bearer ${process.env.RADAR_API_KEY}` };

const params = new URLSearchParams({ cpv: "4526", country: "UA", limit: "100" });
const res = await fetch(`${API}/tenders?${params}`, { headers });
if (!res.ok) throw new Error(`${res.status} ${(await res.json()).code}`);
const { data } = await res.json();
for (const t of data) console.log(t.number, t.title, t.submission_deadline);

Ендпоінти

Усі відповіді — JSON у UTF-8. Списки повертаються як об'єкт з полем data. Параметри-списки можна повторювати або писати через кому.

Тендери

GET/v1/data/tenders

Пошук і вивантаження тендерів. Порядок завжди за (updated_at, id) за зростанням, тому курсор не пропускає змін.

Параметр	Опис
q	Пошук за словами з урахуванням словоформ. Точна фраза — у лапках, `-слово` виключає.
cpv	Коди CPV або префікси від 2 до 8 цифр (45 — будівництво, 4526 — покрівельні роботи).
country	Країна за ISO 3166-1 alpha-2: UA, PL, GB…; EU — тендери ЄС з TED.
source	Коди джерел з `/v1/data/sources`.
group	Слаги груп компаній з `/v1/data/buyer-groups`.
buyer	Замовник: ЄДРПОУ, національний ідентифікатор або id замовника в Radar.
status	`open` (типово) — ще можна подати пропозицію і строк не минув; `any` — будь-який статус; або конкретні статуси: planned, active, enquiry, tendering, auction, qualification, awarded, complete, cancelled, unsuccessful, closed_by_deadline, withdrawn_from_hub, notice, non_competitive.
value_min, value_max	Очікувана вартість від / до, у валюті самого тендера.
deadline_from, deadline_to	Кінцевий строк подання від / до, дата й час ISO 8601.
updated_since	ISO 8601: лише тендери, створені або змінені починаючи з цього моменту.
cursor	Непрозорий курсор з `next_cursor` попередньої відповіді.
limit	Розмір сторінки, 1–500, типово 100.
lang	Мова назв CPV, процедур і джерел: uk (типово), ru, en.
format	json (типово) або csv.

Приклад відповіді

{
  "data": [
    {
      "id": "0d6f4f7e-1c3b-4a51-9b7e-5b9b1f0c2a11",
      "number": "UA-2026-10-11-000337-a",
      "title": "Капітальний ремонт покрівлі",
      "status": "tendering",
      "source": { "code": "prozorro", "name": "Prozorro" },
      "value": { "amount": 1250000.0, "currency": "UAH", "vat_included": true },
      "submission_deadline": { "local": "2026-10-21T00:00:00+03:00", "utc": "2026-10-20T21:00:00Z" },
      "updated_at": "2026-10-11T19:31:02.123456Z",
      "…": "…"
    }
  ],
  "next_cursor": "eyJ1IjoiMjAyNi0xMC0xMVQxOTozMTowMi4xMjM0NTZaIiwiaSI6IjZmMWMifQ",
  "has_more": true,
  "as_of": "2026-10-11T19:40:00Z"
}

Один тендер

GET/v1/data/tenders/{id}

Повний запис за id. Якщо такого немає — 404 tender_not_found.

Без параметрів.

Приклад відповіді

{
  "id": "0d6f4f7e-1c3b-4a51-9b7e-5b9b1f0c2a11",
  "number": "UA-2026-10-11-000337-a",
  "title": "Капітальний ремонт покрівлі",
  "title_translated": null,
  "description": "…",
  "language": "uk",
  "status": "tendering",
  "status_source": "active.tendering",
  "procedure": {
    "code": "aboveThreshold",
    "label": "Відкриті торги з особливостями"
  },
  "buyer": {
    "name": "Київська міська рада",
    "edrpou": "22883141",
    "scheme": "UA-EDR",
    "region": "Київ",
    "locality": "Київ"
  },
  "country": "UA",
  "region": "Київ",
  "source": {
    "code": "prozorro",
    "name": "Prozorro"
  },
  "url": "https://prozorro.gov.ua/tender/UA-2026-10-11-000337-a",
  "also_on": [
    {
      "source": "smarttender",
      "url": "https://smarttender.biz/…"
    }
  ],
  "cpv": {
    "main": {
      "code": "45261000",
      "name": "Покрівельні роботи"
    },
    "extra": [
      {
        "code": "45262000",
        "name": "…"
      }
    ]
  },
  "value": {
    "amount": 1250000,
    "currency": "UAH",
    "vat_included": true
  },
  "time_zone": "Europe/Kyiv",
  "published_at": {
    "local": "2026-10-11T10:15:00+03:00",
    "utc": "2026-10-11T07:15:00Z"
  },
  "submission_start": {
    "local": "2026-10-11T10:15:00+03:00",
    "utc": "2026-10-11T07:15:00Z"
  },
  "enquiry_end": null,
  "submission_deadline": {
    "local": "2026-10-21T00:00:00+03:00",
    "utc": "2026-10-20T21:00:00Z"
  },
  "auction_at": null,
  "lots": [],
  "items": [],
  "documents": [],
  "radar_url": "https://platform.aurum-apps.com/uk/app/tenders/0d6f4f7e-1c3b-4a51-9b7e-5b9b1f0c2a11",
  "first_seen_at": "2026-10-11T07:16:40Z",
  "updated_at": "2026-10-11T19:31:02.123456Z"
}

Джерела

GET/v1/data/sources

Усі джерела: код, країна, сегмент, розклад опитування, час останнього успішного збору, стан і кількість відкритих тендерів. Коди — для параметра source.

Параметр	Опис
lang	Мова назв CPV, процедур і джерел: uk (типово), ru, en.

Приклад відповіді

{
  "data": [
    {
      "code": "prozorro",
      "name": "Prozorro",
      "country": "UA",
      "segment": "ua_public",
      "kind": "api",
      "schedule_minutes": 5,
      "last_success_at": "2026-10-11T19:35:00Z",
      "status": "ok",
      "open_tenders": 18950
    }
  ]
}

Групи компаній

GET/v1/data/buyer-groups

Групи замовників (холдинги) з учасниками та їхніми кодами. Слаги — для параметра group.

Параметр	Опис
lang	Мова назв CPV, процедур і джерел: uk (типово), ru, en.

Приклад відповіді

{
  "data": [
    {
      "slug": "metinvest",
      "name": "Метінвест",
      "aliases": [
        "Metinvest"
      ],
      "members": [
        {
          "edrpou": "00191000",
          "name": "ПрАТ «ММК ім. Ілліча»"
        }
      ]
    }
  ]
}

Довідник CPV

GET/v1/data/cpv

Пошук кодів CPV за префіксом коду або словами, з назвами трьома мовами.

Параметр	Опис
q	Префікс коду або слова.
lang	Мова назв CPV, процедур і джерел: uk (типово), ru, en.
limit	Скільки кодів повернути.

Приклад відповіді

{
  "data": [
    {
      "code": "45261000",
      "name": "Покрівельні роботи",
      "names": {
        "uk": "Покрівельні роботи",
        "en": "Roofing works",
        "ru": "Кровельные работы"
      }
    }
  ]
}

Використання

GET/v1/data/usage

Ваш ключ, ліміти, скільки запитів і рядків уже використано сьогодні та стан доступу.

Без параметрів.

Приклад відповіді

{
  "org": "ТОВ «Альфа»",
  "key": {
    "name": "ERP sync",
    "prefix": "rdr_live_ab12cd"
  },
  "limits": {
    "requests_per_minute": 120,
    "rows_per_day": 100000,
    "max_page": 500
  },
  "today": {
    "requests": 14,
    "rows": 1200,
    "rows_remaining": 98800
  },
  "subscription": {
    "status": "active",
    "plan": "api",
    "trial_until": null
  }
}

Схема OpenAPI

GET/v1/data/openapi.json

Схема OpenAPI 3 лише для API даних; ключ не потрібен. З неї можна згенерувати клієнт для своєї мови.

Без параметрів.

Інкрементальна синхронізація

Так тримають у себе актуальну копію: один раз завантажити все, а далі забирати лише зміни.

1Перше завантаження: GET /v1/data/tenders?limit=500 і далі за next_cursor, поки has_more дорівнює true. Збережіть останній next_cursor.
2Кожні 10 хвилин: GET /v1/data/tenders?cursor=…&status=any&limit=500, знову поки has_more. Оновлюйте рядки за id: змінений тендер приходить ще раз уже з новим станом, наприклад closed_by_deadline. Збережіть новий next_cursor.
3status=any — щоб закриті й скасовані тендери теж приходили як зміни. Рядки, яких у вас не було і які вже не відкриті, можна пропускати.

Без пропусків і дублікатів: зміна, яка ще записується, чекає завершення запису, тож курсор її не перестрибне. Якщо запит обірвався, просто повторіть його з тим самим курсором.

curlPythonJavaScript

#!/usr/bin/env bash
# Needs curl and jq. Upsert each line of tenders.jsonl into your database by "id".
API="https://platform.aurum-apps.com/v1/data"
AUTH="Authorization: Bearer $RADAR_API_KEY"

pull() {   # $1 = filters, $2 = cursor to start from; follows next_cursor while has_more is true
  local filters="$1" cursor="$2" page
  while :; do
    page=$(curl -sf -H "$AUTH" "$API/tenders?$filters${cursor:+&cursor=$cursor}") || return 1
    echo "$page" | jq -c '.data[]' >> tenders.jsonl
    cursor=$(echo "$page" | jq -r '.next_cursor')
    echo "$cursor" > cursor.txt
    [ "$(echo "$page" | jq -r '.has_more')" = "true" ] || break
  done
}

if [ ! -s cursor.txt ]; then
  # 1. First full load: open tenders
  pull "limit=500"
else
  # 2. Every 10 minutes (cron: */10 * * * *): everything changed since the saved cursor,
  #    closed and cancelled tenders included
  pull "status=any&limit=500" "$(cat cursor.txt)"
fi

import os
import pathlib
import time

import httpx

API = "https://platform.aurum-apps.com/v1/data"
CURSOR = pathlib.Path("radar_cursor.txt")
client = httpx.Client(headers={"Authorization": f"Bearer {os.environ['RADAR_API_KEY']}"}, timeout=60)


def upsert(tender: dict) -> None:
    """Insert or update the row with id = tender["id"] in your database."""
    ...


def pull(params: dict) -> None:
    """Follows next_cursor while has_more is true and saves the cursor after every page."""
    while True:
        r = client.get(f"{API}/tenders", params=params)
        if r.status_code == 429:  # rate limit: wait as long as the API asks
            time.sleep(int(r.headers.get("Retry-After", "60")))
            continue
        r.raise_for_status()
        page = r.json()
        for tender in page["data"]:
            upsert(tender)
        CURSOR.write_text(page["next_cursor"])
        if not page["has_more"]:
            return
        params = {**params, "cursor": page["next_cursor"]}


# 1. First full load: open tenders
if not CURSOR.exists():
    pull({"limit": 500})

# 2. Every 10 minutes: everything changed since the saved cursor, closed and cancelled included
while True:
    time.sleep(600)
    pull({"cursor": CURSOR.read_text(), "status": "any", "limit": 500})

// Node 18+ (global fetch). Run as an ES module.
import { existsSync, readFileSync, writeFileSync } from "node:fs";

const API = "https://platform.aurum-apps.com/v1/data";
const CURSOR = "radar_cursor.txt";
const headers = { Authorization: `Bearer ${process.env.RADAR_API_KEY}` };
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));

async function upsert(tender) {
  // Insert or update the row with id = tender.id in your database.
}

// Follows next_cursor while has_more is true and saves the cursor after every page.
async function pull(params) {
  for (;;) {
    const res = await fetch(`${API}/tenders?${new URLSearchParams(params)}`, { headers });
    if (res.status === 429) {
      await sleep(Number(res.headers.get("Retry-After") ?? 60) * 1000);
      continue;
    }
    if (!res.ok) throw new Error(`${res.status} ${(await res.json()).code}`);
    const page = await res.json();
    for (const tender of page.data) await upsert(tender);
    writeFileSync(CURSOR, page.next_cursor);
    if (!page.has_more) return;
    params = { ...params, cursor: page.next_cursor };
  }
}

// 1. First full load: open tenders
if (!existsSync(CURSOR)) await pull({ limit: "500" });

// 2. Every 10 minutes: everything changed since the saved cursor, closed and cancelled included
for (;;) {
  await sleep(10 * 60 * 1000);
  await pull({ cursor: readFileSync(CURSOR, "utf8"), status: "any", limit: "500" });
}

Експорт у CSV

Додайте format=csv — ті самі рядки прийдуть як CSV: плоскі колонки, кома як роздільник, рядок заголовків, UTF-8 з BOM (Excel відкриває без налаштувань). Курсор приходить у заголовках X-Next-Cursor і X-Has-More, тож синхронізація працює так само.

curlPythonJavaScript

curl -sf -D headers.txt -o tenders.csv \
  -H "Authorization: Bearer $RADAR_API_KEY" \
  "https://platform.aurum-apps.com/v1/data/tenders?cpv=45&country=UA&limit=500&format=csv"

grep -i '^x-next-cursor:' headers.txt   # send it as cursor= for the next page
grep -i '^x-has-more:' headers.txt      # true = fetch the next page right away

import os
import httpx

API = "https://platform.aurum-apps.com/v1/data"
headers = {"Authorization": f"Bearer {os.environ['RADAR_API_KEY']}"}

r = httpx.get(f"{API}/tenders", params={"cpv": "45", "limit": 500, "format": "csv"}, headers=headers)
r.raise_for_status()
with open("tenders.csv", "wb") as f:
    f.write(r.content)  # UTF-8 with BOM: opens in Excel as is
next_cursor = r.headers["X-Next-Cursor"]
has_more = r.headers["X-Has-More"] == "true"

import { writeFileSync } from "node:fs";

const API = "https://platform.aurum-apps.com/v1/data";
const headers = { Authorization: `Bearer ${process.env.RADAR_API_KEY}` };

const res = await fetch(`${API}/tenders?cpv=45&limit=500&format=csv`, { headers });
if (!res.ok) throw new Error(String(res.status));
writeFileSync("tenders.csv", Buffer.from(await res.arrayBuffer())); // UTF-8 with BOM
const nextCursor = res.headers.get("X-Next-Cursor");
const hasMore = res.headers.get("X-Has-More") === "true";

Ліміти

120 запитів на хвилину на кожен ключ.
100 000 рядків тендерів на день на організацію (доба за UTC).
До 500 рядків на сторінку.
Обидва ліміти можна підняти для вашої організації — напишіть нам.

Заголовки лімітів

Кожна відповідь несе поточний стан лімітів:

Заголовок	Опис
X-RateLimit-Limit	Запитів на хвилину для цього ключа.
X-RateLimit-Remaining	Скільки запитів лишилося в поточній хвилині.
X-RateLimit-Reset	Секунд до початку нової хвилини.
X-RateLimit-Rows-Limit	Рядків на день для організації.
X-RateLimit-Rows-Remaining	Скільки рядків лишилося на сьогодні.
Retry-After	Лише у відповіді 429: через скільки секунд повторити запит.

Помилки

Тіло помилки завжди однакове: code для програми, message і detail для людини. Помилка валідації (422) має стандартне тіло, де detail — список полів.

Код	Що сталося
401 missing_api_key	Немає заголовка Authorization: Bearer.
401 invalid_api_key	Невідомий ключ.
401 api_key_revoked	Ключ відкликано.
402 api_plan_required	В організації немає активної підписки на API.
400 invalid_cursor	Курсор пошкоджено або він не з цього API.
404 tender_not_found	Тендера з таким id немає.
422 —	Параметр має неправильне значення.
429 rate_limited	Перевищено ліміт запитів на хвилину; повторіть після Retry-After.
429 daily_rows_exceeded	Вичерпано денний ліміт рядків; він оновиться опівночі за UTC.

{
  "code": "invalid_api_key",
  "message": "Unknown API key",
  "detail": "Check the Authorization header"
}

API за підпискою

Залиште заявку: узгодимо обсяг і ціну, увімкнемо підписку вашій організації, і власник чи адміністратор одразу створить ключ.

Доступ уже є? Ключі створюються в Налаштуваннях → «API». Відкрити налаштування

Отримати ключ / Замовити доступ