API public de licitații

Tendova publică datele despre licitații colectate din TED ca API JSON doar pentru citire. Este gratuit, se poate încerca fără cheie și returnează aceleași anunțuri pe care le afișează site-ul.

Ce returnează API-ul

Două puncte de acces, ambele JSON și ambele doar pentru citire.

GET /api/tenders — caută licitații active după text integral, țară, cod CPV și ordonare și returnează o pagină de rezultate împreună cu paginarea.
GET /api/tenders/{id} — returnează o licitație completă: autoritatea contractantă, codurile CPV, locul de executare, valoarea estimată, termenele și linkurile oficiale către sursă.
Titlurile și descrierile se întorc în oricare dintre cele 24 de limbi oficiale ale UE prin parametrul locale.

Rezumatele IA, scorurile de potrivire, analizele de compatibilitate și analiza documentelor nu fac niciodată parte dintr-un răspuns API. Ele rămân în interiorul produsului.

Autentificare

Nu aveți nevoie de cheie pentru a încerca API-ul. Trimiteți una de îndată ce construiți pe el: cheile sunt gratuite în orice plan și vă măresc bugetul. Funcționează oricare dintre anteturi.

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

O cheie necunoscută, greșit formată sau revocată este respinsă cu HTTP 401 și codul de eroare invalid_api_key. Lipsa completă a cheii înseamnă un apel anonim, nu o eroare.

Creați o cheie în contul dumneavoastră

Limite de apel

Apelant	Buget de cereri	Înregistrări per cerere
Fără cheie	20 cereri pe minut, pentru fiecare adresă IP	până la 20
Cheie pe planul Free	500 cereri pe zi, pentru fiecare cheie	până la 20
Cheie pe planul Pro	10.000 cereri pe zi, pentru fiecare cheie	până la 50

Apelurile cu cheie trec și printr-o protecție de vârf de 60 cereri pe minut, astfel încât un buget zilnic să nu poată fi consumat dintr-odată.

Fiecare răspuns conține x-ratelimit-limit și x-ratelimit-remaining. Un apel peste limită returnează HTTP 429 cu retry-after în secunde.

Exemple

Căutarea licitațiilor

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

Preluarea unei licitații

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

Omiteți antetul Authorization pentru un apel anonim. Fiecare element din listă are un câmp apiUrl: adresa de detaliu a acelei licitații, gata de apelat.

Pentru agenți IA

Un scurt fișier de orientare descrie aceleași puncte de acces în formatul llmstxt.org, pentru asistenți de cod și cadre de lucru pentru agenți.

Deschideți llms.txt

De unde provin datele

Toate anunțurile provin din Tenders Electronic Daily (TED), jurnalul oficial al achizițiilor publice din UE. Tendova adaugă traducere, structură și căutare; anunțurile în sine rămân date publice.

Pentru acces în masă sau comercial la date, scrieți la [email protected].