Verejné API zákaziek

Tendova sprístupňuje údaje o zákazkách zbierané z TED ako JSON API len na čítanie. Je bezplatné, vyskúšate ho bez kľúča a vracia tie isté oznámenia, aké zobrazuje web.

Čo API vracia

Dva koncové body, oba v JSON a oba len na čítanie.

GET /api/tenders — vyhľadáva aktívne zákazky podľa fulltextu, krajiny, kódu CPV a zoradenia a vracia jednu stranu výsledkov vrátane stránkovania.
GET /api/tenders/{id} — vracia celú zákazku: obstarávateľa, kódy CPV, miesto plnenia, odhadovanú hodnotu, lehoty a oficiálne odkazy na zdroj.
Názvy a opisy sa vracajú v ktoromkoľvek z 24 úradných jazykov EÚ pomocou parametra locale.

Zhrnutia od AI, skóre zhody, posúdenia vhodnosti a analýza dokumentov nikdy nie sú súčasťou odpovede API. Zostávajú vnútri produktu.

Overovanie

Na vyskúšanie API kľúč nepotrebujete. Pošlite ho, len čo na API staviate: kľúče sú zadarmo vo všetkých plánoch a zvyšujú váš limit. Funguje ktorákoľvek z hlavičiek.

Authorization: Bearer tdv_live_…
X-Api-Key: tdv_live_…

Neznámy, poškodený alebo zrušený kľúč je odmietnutý s HTTP 401 a chybovým kódom invalid_api_key. Žiadny kľúč znamená anonymné volanie, nie chybu.

Vytvoriť kľúč vo svojom účte

Limity volaní

Volajúci	Limit požiadaviek	Záznamov na požiadavku
Bez kľúča	20 požiadaviek za minútu na IP adresu	až 20
Kľúč v pláne Free	500 požiadaviek denne na kľúč	až 20
Kľúč v pláne Pro	10 000 požiadaviek denne na kľúč	až 50

Volania s kľúčom navyše prechádzajú špičkovou poistkou 60 požiadaviek za minútu, aby sa denný limit nedal vyčerpať naraz.

Každá odpoveď nesie x-ratelimit-limit a x-ratelimit-remaining. Volanie nad limit vracia HTTP 429 s hlavičkou retry-after v sekundách.

Príklady

Vyhľadanie zákaziek

curl -s "https://tendova.eu/api/tenders?q=software&country=DE&limit=20&locale=sk" \
  -H "Authorization: Bearer tdv_live_YOUR_KEY"

Načítanie jednej zákazky

curl -s "https://tendova.eu/api/tenders/{id}?locale=sk" \
  -H "Authorization: Bearer tdv_live_YOUR_KEY"

Hlavičku Authorization vynechajte, ak chcete volať anonymne. Každá položka zoznamu nesie pole apiUrl: pripravenú adresu detailu danej zákazky.

Pre agentov AI

Krátky orientačný súbor opisuje tie isté koncové body vo formáte llmstxt.org, pre kódovacích asistentov a agentné frameworky.

Otvoriť llms.txt

Odkiaľ údaje pochádzajú

Všetky oznámenia pochádzajú z Tenders Electronic Daily (TED), oficiálneho vestníka verejného obstarávania EÚ. Tendova dopĺňa preklad, štruktúru a vyhľadávanie; samotné oznámenia zostávajú verejnými údajmi.

Pri hromadnom alebo komerčnom prístupe k údajom píšte na [email protected].