Publiskais iepirkumu API

Tendova publicē no TED savāktos iepirkumu datus kā tikai lasāmu JSON API. Tas ir bez maksas, izmēģināms bez atslēgas un atgriež tos pašus paziņojumus, ko rāda vietne.

Ko API atgriež

Divi galapunkti, abi JSON formātā un abi tikai lasāmi.

GET /api/tenders — meklē aktīvos iepirkumus pēc pilnteksta, valsts, CPV koda un kārtošanas un atgriež vienu rezultātu lapu kopā ar lapošanas datiem.
GET /api/tenders/{id} — atgriež vienu iepirkumu pilnībā: pasūtītāju, CPV kodus, izpildes vietu, paredzamo vērtību, termiņus un oficiālās saites uz avotu.
Nosaukumus un aprakstus ar parametru locale var saņemt jebkurā no 24 ES oficiālajām valodām.

MI kopsavilkumi, atbilstības vērtējumi, piemērotības pārbaudes un dokumentu analīze nekad nav API atbildes daļa. Tie paliek produkta iekšienē.

Autentifikācija

API izmēģināšanai atslēga nav vajadzīga. Nosūtiet to, tiklīdz sākat uz tā būvēt: atslēgas ir bez maksas visos plānos un palielina jūsu limitu. Der jebkura no galvenēm.

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

Nezināma, nepareizi veidota vai atsaukta atslēga tiek noraidīta ar HTTP 401 un kļūdas kodu invalid_api_key. Atslēgas neesamība ir anonīms izsaukums, nevis kļūda.

Izveidot atslēgu savā kontā

Pieprasījumu limiti

Izsaucējs	Pieprasījumu limits	Ieraksti vienā pieprasījumā
Bez atslēgas	20 pieprasījumi minūtē no vienas IP adreses	līdz 20
Atslēga plānā Free	500 pieprasījumi dienā vienai atslēgai	līdz 20
Atslēga plānā Pro	10 000 pieprasījumi dienā vienai atslēgai	līdz 50

Izsaukumi ar atslēgu iziet arī caur maksimuma aizsardzību 60 pieprasījumi minūtē, lai dienas limitu nevarētu iztērēt uzreiz.

Katra atbilde satur x-ratelimit-limit un x-ratelimit-remaining. Izsaukums virs limita atgriež HTTP 429 ar retry-after sekundēs.

Piemēri

Iepirkumu meklēšana

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

Viena iepirkuma iegūšana

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

Izlaidiet galveni Authorization, lai izsauktu anonīmi. Katrs saraksta ieraksts satur lauku apiUrl: gatavu šī iepirkuma detaļu adresi.

MI aģentiem

Īss orientācijas fails apraksta tos pašus galapunktus llmstxt.org formātā, koda asistentiem un aģentu ietvariem.

Atvērt llms.txt

No kurienes nāk dati

Visi paziņojumi nāk no Tenders Electronic Daily (TED), ES oficiālā publisko iepirkumu izdevuma. Tendova pievieno tulkojumu, struktūru un meklēšanu; paši paziņojumi paliek publiski dati.

Par masveida vai komerciālu datu piekļuvi rakstiet uz [email protected].