Ausschreibungsdaten über eine API

Jede Ausschreibung kommt in einem Format, egal wo sie veröffentlicht wurde: Nummer, Titel, Auftraggeber mit seiner Unternehmens-ID, CPV, erwarteter Wert, Fristen in der Zeitzone des Auftraggebers und in UTC, Status und ein Link zum Original. Steht dieselbe Ausschreibung auf mehreren Plattformen, erhalten Sie einen Datensatz, der alle Veröffentlichungsorte auflistet.

Quellen

• Prozorro – öffentliche Beschaffung der Ukraine
• Ukrainische kommerzielle Plattformen und Beschaffungsportale von Unternehmen
• Europäische Union (TED)
• Nationale Beschaffungssysteme anderer Länder, darunter das Vereinigte Königreich
• Internationale Organisationen, darunter die UN

Aktualität

Jede Quelle wird nach eigenem Zeitplan abgefragt: die häufigste alle paar Minuten, die übrigen stündlich bis alle paar Stunden. Das Feld updated_at gibt an, wann sich ein Datensatz zuletzt geändert hat.

Felder einer Ausschreibung

Jede Anfrage trägt den Schlüssel der Organisation im Header Authorization: Bearer rdr_live_…. Ein Schlüssel gehört dem Unternehmen, nicht einer Person: Geben Sie ihn einem Dienst oder einer Integration.

1. 1Schlüssel erstellt der Inhaber oder Admin des Unternehmens in Tender Radar: Einstellungen → «API».
2. 2Wir zeigen den vollständigen Schlüssel einmal, direkt nach der Erstellung. Bewahren Sie ihn in einem Secrets-Manager oder einer Umgebungsvariable auf.
3. 3Wir speichern nur einen Hash des Schlüssels, können ihn also nicht erneut anzeigen. Schlüssel verloren? Widerrufen Sie ihn und erstellen Sie einen neuen.
4. 4Ein widerrufener Schlüssel funktioniert sofort nicht mehr. Geben Sie jeder Integration einen eigenen Schlüssel (bis zu 10 aktive).

Basis-URL

https://app.metadani.com/v1/data

Authorization: Bearer rdr_live_…

Offene Dacharbeiten-Ausschreibungen in der Ukraine. Der Schlüssel wird aus der Umgebungsvariable RADAR_API_KEY gelesen.

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

import os
import httpx

API = "https://app.metadani.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://app.metadani.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);

Jede Antwort ist JSON in UTF-8. Listen kommen als Objekt mit einem Feld data. Listenparameter können wiederholt oder durch Kommas getrennt werden.

{
  "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"
}

{
  "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"
}

{
  "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
    }
  ]
}

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

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

{
  "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
  }
}

So halten Sie eine aktuelle Kopie: einmal alles laden, danach nur noch die Änderungen abrufen.

1. 1Erstes Laden: GET /v1/data/tenders?limit=500, dann next_cursor folgen, solange has_more true ist. Speichern Sie den letzten next_cursor.
2. 2Alle 10 Minuten: GET /v1/data/tenders?cursor=…&status=any&limit=500, wieder solange has_more. Führen Sie Upserts der Zeilen anhand von id durch: Eine geänderte Ausschreibung kommt erneut mit ihrem neuen Zustand, z. B. closed_by_deadline. Speichern Sie den neuen next_cursor.
3. 3status=any, damit auch geschlossene und abgesagte Ausschreibungen als Änderungen durchkommen. Zeilen, die Sie nie hatten und die nicht mehr offen sind, können Sie überspringen.

Keine Lücken und keine Duplikate: Eine Änderung, die noch geschrieben wird, wird zurückgehalten, bis sie bestätigt ist, sodass der Cursor sie nie überspringt. Bricht eine Anfrage ab, wiederholen Sie sie mit demselben Cursor.

#!/usr/bin/env bash
# Needs curl and jq. Upsert each line of tenders.jsonl into your database by "id".
API="https://app.metadani.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://app.metadani.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://app.metadani.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" });
}

Fügen Sie format=csv hinzu, und dieselben Zeilen kommen als CSV: flache Spalten, durch Kommas getrennt, eine Kopfzeile, UTF-8 mit BOM (Excel öffnet es direkt). Der Cursor kommt in den Headern X-Next-Cursor und X-Has-More, die Synchronisierung funktioniert also genauso.

curl -sf -D headers.txt -o tenders.csv \
  -H "Authorization: Bearer $RADAR_API_KEY" \
  "https://app.metadani.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://app.metadani.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://app.metadani.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 Anfragen pro Minute und Schlüssel.
• 100.000 Ausschreibungszeilen pro Tag und Organisation (UTC-Tag).
• Bis zu 500 Zeilen pro Seite.
• Beide Limits lassen sich für Ihre Organisation erhöhen – schreiben Sie uns.

Rate-Limit-Header

Jede Antwort trägt den aktuellen Stand der Limits:

Der Fehlerkörper ist immer gleich: code für Programme, message und detail für Menschen. Ein Validierungsfehler (422) hat den Standardkörper, in dem detail die Felder auflistet.

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