Publiczne API przetargów

Tendova udostępnia dane przetargowe zbierane z TED jako API JSON tylko do odczytu. Jest bezpłatne, można je wypróbować bez klucza i zwraca te same ogłoszenia, które pokazuje serwis.

Co zwraca API

Dwa punkty końcowe, oba w JSON i oba tylko do odczytu.

GET /api/tenders — wyszukuje aktywne przetargi według pełnego tekstu, kraju, kodu CPV i sortowania oraz zwraca stronę wyników wraz z paginacją.
GET /api/tenders/{id} — zwraca pełne ogłoszenie: zamawiającego, kody CPV, miejsce realizacji, wartość szacunkową, terminy i oficjalne odnośniki do źródła.
Tytuły i opisy wracają w każdym z 24 języków urzędowych UE dzięki parametrowi locale.

Streszczenia AI, oceny dopasowania, analizy szans i analiza dokumentów nigdy nie są częścią odpowiedzi API. Pozostają wewnątrz produktu.

Uwierzytelnianie

Do wypróbowania API klucz nie jest potrzebny. Wyślij go, gdy zaczniesz na nim budować: klucze są bezpłatne w każdym planie i zwiększają limit. Działa każdy z nagłówków.

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

Nieznany, błędny lub unieważniony klucz zostaje odrzucony kodem HTTP 401 i błędem invalid_api_key. Brak klucza to wywołanie anonimowe, a nie błąd.

Utwórz klucz na swoim koncie

Limity zapytań

Wywołujący	Limit zapytań	Rekordów na zapytanie
Bez klucza	20 zapytań na minutę na adres IP	do 20
Klucz w planie Free	500 zapytań dziennie na klucz	do 20
Klucz w planie Pro	10 000 zapytań dziennie na klucz	do 50

Wywołania z kluczem przechodzą dodatkowo przez zabezpieczenie szczytowe 60 zapytań na minutę, aby limitu dziennego nie dało się zużyć za jednym razem.

Każda odpowiedź zawiera x-ratelimit-limit oraz x-ratelimit-remaining. Wywołanie ponad limit zwraca HTTP 429 z nagłówkiem retry-after w sekundach.

Przykłady

Wyszukiwanie przetargów

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

Pobranie jednego przetargu

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

Pomiń nagłówek Authorization, aby wywołać anonimowo. Każdy element listy zawiera pole apiUrl: gotowy adres szczegółów tego przetargu.

Dla agentów AI

Krótki plik orientacyjny opisuje te same punkty końcowe w formacie llmstxt.org, z myślą o asystentach kodu i frameworkach agentowych.

Otwórz llms.txt

Skąd pochodzą dane

Wszystkie ogłoszenia pochodzą z Tenders Electronic Daily (TED), oficjalnego dziennika zamówień publicznych UE. Tendova dodaje tłumaczenie, strukturę i wyszukiwanie; same ogłoszenia pozostają danymi publicznymi.

W sprawie masowego lub komercyjnego dostępu do danych napisz na [email protected].