Javni API natječaja

Tendova objavljuje podatke o natječajima prikupljene s TED-a kao JSON API samo za čitanje. Besplatan je, može se isprobati bez ključa i vraća iste obavijesti koje prikazuje stranica.

Što API vraća

Dvije krajnje točke, obje u JSON-u i obje samo za čitanje.

GET /api/tenders — pretražuje aktivne natječaje po punom tekstu, državi, CPV oznaci i redoslijedu te vraća jednu stranicu rezultata s paginacijom.
GET /api/tenders/{id} — vraća cijeli natječaj: naručitelja, CPV oznake, mjesto izvršenja, procijenjenu vrijednost, rokove i službene poveznice na izvor.
Naslovi i opisi vraćaju se na bilo kojem od 24 službena jezika EU putem parametra locale.

Sažeci umjetne inteligencije, ocjene podudarnosti, provjere prikladnosti i analiza dokumenata nikada nisu dio odgovora API-ja. Ostaju unutar proizvoda.

Autentifikacija

Za isprobavanje API-ja ključ nije potreban. Pošaljite ga čim na njemu gradite: ključevi su besplatni u svakom paketu i povećavaju kvotu. Radi bilo koje zaglavlje.

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

Nepoznat, neispravan ili opozvan ključ odbija se s HTTP 401 i kodom pogreške invalid_api_key. Izostanak ključa znači anonimni poziv, a ne pogrešku.

Izradite ključ u svom računu

Ograničenja poziva

Pozivatelj	Kvota zahtjeva	Zapisa po zahtjevu
Bez ključa	20 zahtjeva u minuti po IP adresi	do 20
Ključ na paketu Free	500 zahtjeva dnevno po ključu	do 20
Ključ na paketu Pro	10.000 zahtjeva dnevno po ključu	do 50

Pozivi s ključem prolaze i kroz zaštitu od naleta od 60 zahtjeva u minuti, pa se dnevna kvota ne može potrošiti odjednom.

Svaki odgovor nosi x-ratelimit-limit i x-ratelimit-remaining. Poziv iznad ograničenja vraća HTTP 429 sa zaglavljem retry-after u sekundama.

Primjeri

Pretraga natječaja

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

Dohvat jednog natječaja

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

Izostavite zaglavlje Authorization za anoniman poziv. Svaka stavka popisa nosi polje apiUrl: gotovu adresu detalja tog natječaja.

Za AI agente

Kratka datoteka za orijentaciju opisuje iste krajnje točke u formatu llmstxt.org, za pomoćnike pri kodiranju i agentske okvire.

Otvori llms.txt

Odakle dolaze podaci

Sve obavijesti dolaze iz Tenders Electronic Daily (TED), službenog glasnika javne nabave EU. Tendova dodaje prijevod, strukturu i pretragu; same obavijesti ostaju javni podaci.

Za skupni ili komercijalni pristup podacima pišite na [email protected].