API · Для разработчиков

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

Те же данные, что видят пользователи Tender Radar, в вашей ERP, CRM или хранилище: 123 источников, 23 613 открытых тендеров, 7 стран и регионов. Один формат для всех площадок, обновление каждые несколько минут.

Получить ключ / Заказать доступ Как подключиться

источников: 123
открытых тендеров: 23 613
стран и регионов: 7
мин — самое частое обновление: 5

Что дает API

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

Источники

Prozorro — публичные закупки Украины1 источник
Коммерческие площадки и порталы закупок компаний Украины110 источников
Европейский союз (TED)1 источник
Национальные системы закупок других стран, в том числе Великобритания6 источников
Международные организации, в том числе ООН5 источников

Свежесть

Каждый источник опрашивается по собственному расписанию: самые частые — каждые 5 мин. Сейчас вовремя обновляются 123 из 123 источников. Поле 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». Открыть настройки

Получить ключ / Заказать доступ