Openbare aanbestedings-API

Tendova publiceert de aanbestedingsgegevens die het bij TED verzamelt als een alleen-lezen JSON-API. Die is gratis, werkt zonder sleutel om te proberen en levert dezelfde aankondigingen als de website.

Wat de API teruggeeft

Twee endpoints, allebei JSON en allebei alleen-lezen.

GET /api/tenders — zoekt actieve aanbestedingen op volledige tekst, land, CPV-code en sortering, en geeft één pagina resultaten met paginering terug.
GET /api/tenders/{id} — geeft één aanbesteding volledig terug: aanbestedende dienst, CPV-codes, plaats van uitvoering, geraamde waarde, termijnen en de officiële bronlinks.
Titels en beschrijvingen komen via de parameter locale terug in elk van de 24 officiële EU-talen.

AI-samenvattingen, matchscores, geschiktheidschecks en documentanalyse maken nooit deel uit van een API-antwoord. Die blijven in het product.

Authenticatie

Om de API te proberen heb je geen sleutel nodig. Stuur er een zodra je erop bouwt: sleutels zijn gratis in elk abonnement en verhogen je budget. Beide headers werken.

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

Een onbekende, onjuist gevormde of ingetrokken sleutel wordt geweigerd met HTTP 401 en de foutcode invalid_api_key. Helemaal geen sleutel sturen is een anonieme aanroep, geen fout.

Maak een sleutel aan in je account

Aanroeplimieten

Aanroeper	Verzoekbudget	Records per verzoek
Geen sleutel	20 verzoeken per minuut, per IP-adres	tot 20
Sleutel op Free	500 verzoeken per dag, per sleutel	tot 20
Sleutel op Pro	10.000 verzoeken per dag, per sleutel	tot 50

Aanroepen met sleutel passeren ook een piekgrens van 60 verzoeken per minuut, zodat een dagbudget niet in één keer opgaat.

Elk antwoord bevat x-ratelimit-limit en x-ratelimit-remaining. Een aanroep boven de limiet geeft HTTP 429 met retry-after in seconden.

Voorbeelden

Aanbestedingen zoeken

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

Eén aanbesteding ophalen

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

Laat de Authorization-header weg om anoniem aan te roepen. Elk lijstitem bevat een apiUrl-veld: de detail-URL van die aanbesteding, klaar om op te halen.

Voor AI-agents

Een kort oriëntatiebestand beschrijft dezelfde endpoints in het llmstxt.org-formaat, voor codeassistenten en agentframeworks.

llms.txt openen

Waar de gegevens vandaan komen

Alle aankondigingen komen uit Tenders Electronic Daily (TED), het officiële aanbestedingsblad van de EU. Tendova voegt vertaling, structuur en zoeken toe; de aankondigingen zelf blijven openbare gegevens.

Voor bulk- of commerciële datatoegang mail je naar [email protected].