Přeskočit na obsah

Veřejné API zakázek

Tendova zveřejňuje data o zakázkách sbíraná z TED jako JSON API pouze pro čtení. Je bezplatné, vyzkoušíte je bez klíče a vrací stejná oznámení, jaká ukazuje web.

Co API vrací

Dva koncové body, oba v JSON a oba pouze pro čtení.

  • GET /api/tenders — vyhledává aktivní zakázky podle fulltextu, země, kódu CPV a řazení a vrací jednu stránku výsledků včetně stránkování.
  • GET /api/tenders/{id} — vrací celou zakázku: zadavatele, kódy CPV, místo plnění, odhadovanou hodnotu, lhůty a oficiální odkazy na zdroj.
  • Názvy a popisy se vracejí v kterémkoli z 24 úředních jazyků EU pomocí parametru locale.

Shrnutí od AI, skóre shody, posouzení vhodnosti a analýza dokumentů nikdy nejsou součástí odpovědi API. Zůstávají uvnitř produktu.

Ověřování

K vyzkoušení API klíč nepotřebujete. Pošlete jej, jakmile na API stavíte: klíče jsou zdarma ve všech tarifech a zvyšují váš limit. Funguje kterákoli z hlaviček.

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

Neznámý, poškozený nebo zrušený klíč je odmítnut s HTTP 401 a chybovým kódem invalid_api_key. Žádný klíč znamená anonymní volání, nikoli chybu.

Vytvořit klíč ve svém účtu

Limity volání

VolajícíLimit požadavkůZáznamů na požadavek
Bez klíče20 požadavků za minutu na IP adresuaž 20
Klíč v tarifu Free500 požadavků denně na klíčaž 20
Klíč v tarifu Pro10 000 požadavků denně na klíčaž 50

Volání s klíčem navíc prochází špičkovou pojistkou 60 požadavků za minutu, aby denní limit nešlo vyčerpat naráz.

Každá odpověď nese x-ratelimit-limit a x-ratelimit-remaining. Volání nad limit vrací HTTP 429 s hlavičkou retry-after v sekundách.

Příklady

Vyhledání zakázek

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

Načtení jedné zakázky

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

Hlavičku Authorization vynechte, chcete-li volat anonymně. Každá položka seznamu nese pole apiUrl: připravenou adresu detailu dané zakázky.

Pro agenty AI

Krátký orientační soubor popisuje tytéž koncové body ve formátu llmstxt.org, pro kódovací asistenty a agentní frameworky.

Otevřít llms.txt

Odkud data pocházejí

Všechna oznámení pocházejí z Tenders Electronic Daily (TED), oficiálního věstníku veřejných zakázek EU. Tendova doplňuje překlad, strukturu a vyhledávání; samotná oznámení zůstávají veřejnými daty.

Contains data from Tenders Electronic Daily (TED), © European Union, ted.europa.eu — CC BY 4.0.

Pro hromadný nebo komerční přístup k datům pište na [email protected].