Публично API за обществени поръчки

Tendova публикува данните за поръчки, събрани от TED, като JSON API само за четене. То е безплатно, може да се изпробва без ключ и връща същите обявления, които показва сайтът.

Какво връща API

Две крайни точки, и двете в JSON и само за четене.

GET /api/tenders — търси активни поръчки по пълен текст, държава, CPV код и подредба и връща една страница резултати заедно с данните за страниране.
GET /api/tenders/{id} — връща една поръчка изцяло: възложител, CPV кодове, място на изпълнение, прогнозна стойност, срокове и официалните връзки към източника.
Заглавията и описанията се връщат на всеки от 24-те официални езика на ЕС чрез параметъра locale.

Резюметата от ИИ, оценките за съответствие, проверките за пригодност и анализът на документи никога не са част от отговор на API. Те остават в продукта.

Удостоверяване

За да изпробвате API, не е нужен ключ. Изпратете такъв веднага щом започнете да градите върху него: ключовете са безплатни във всеки план и увеличават лимита ви. Работи всяка от двете заглавки.

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

Непознат, неправилен или отменен ключ се отхвърля с HTTP 401 и код на грешка invalid_api_key. Липсата на ключ е анонимна заявка, а не грешка.

Създайте ключ в профила си

Лимити на заявките

Извикващ	Лимит от заявки	Записи на заявка
Без ключ	20 заявки в минута на IP адрес	до 20
Ключ в план Free	500 заявки на ден на ключ	до 20
Ключ в план Pro	10 000 заявки на ден на ключ	до 50

Заявките с ключ минават и през защита от пикове от 60 заявки в минута, така че дневният лимит не може да се изразходва наведнъж.

Всеки отговор носи x-ratelimit-limit и x-ratelimit-remaining. Заявка над лимита връща HTTP 429 със заглавка retry-after в секунди.

Примери

Търсене на поръчки

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

Извличане на една поръчка

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

Пропуснете заглавката Authorization, за да извикате анонимно. Всеки елемент от списъка носи поле apiUrl: готовия адрес с детайлите на тази поръчка.

За ИИ агенти

Кратък ориентиращ файл описва същите крайни точки във формата на llmstxt.org, за асистенти за код и агентни рамки.

Отвори llms.txt

Откъде идват данните

Всички обявления идват от Tenders Electronic Daily (TED), официалния вестник за обществени поръчки на ЕС. Tendova добавя превод, структура и търсене; самите обявления остават публични данни.

За масов или търговски достъп до данните пишете на [email protected].