API pubblica dei bandi

Tendova pubblica i dati dei bandi raccolti da TED come API JSON in sola lettura. È gratuita, si può provare senza chiave e restituisce gli stessi avvisi mostrati dal sito.

Che cosa restituisce l'API

Due endpoint, entrambi JSON e in sola lettura.

GET /api/tenders — cerca i bandi attivi per testo, paese, codice CPV e ordinamento e restituisce una pagina di risultati con la paginazione.
GET /api/tenders/{id} — restituisce un bando completo: stazione appaltante, codici CPV, luogo di esecuzione, valore stimato, scadenze e i link ufficiali alla fonte.
Titoli e descrizioni vengono restituiti in ciascuna delle 24 lingue ufficiali dell'UE tramite il parametro locale.

Riepiloghi AI, punteggi di corrispondenza, valutazioni di idoneità e analisi dei documenti non fanno mai parte di una risposta API. Restano dentro il prodotto.

Autenticazione

Per provare l'API non serve alcuna chiave. Inviane una appena ci costruisci sopra: le chiavi sono gratuite su ogni piano e aumentano il budget. Funzionano entrambe le intestazioni.

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

Una chiave sconosciuta, malformata o revocata viene rifiutata con HTTP 401 e il codice di errore invalid_api_key. Non inviare alcuna chiave è una chiamata anonima, non un errore.

Crea una chiave nel tuo account

Limiti di frequenza

Chiamante	Budget di richieste	Record per richiesta
Senza chiave	20 richieste al minuto per indirizzo IP	fino a 20
Chiave sul piano Free	500 richieste al giorno per chiave	fino a 20
Chiave sul piano Pro	10.000 richieste al giorno per chiave	fino a 50

Le chiamate con chiave superano anche un limite di picco di 60 richieste al minuto, così un budget giornaliero non si esaurisce in una volta sola.

Ogni risposta contiene x-ratelimit-limit e x-ratelimit-remaining. Una chiamata oltre il limite restituisce HTTP 429 con retry-after in secondi.

Esempi

Cercare bandi

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

Recuperare un bando

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

Ometti l'intestazione Authorization per chiamare in modo anonimo. Ogni elemento della lista contiene il campo apiUrl: l'URL di dettaglio di quel bando, pronto da chiamare.

Per gli agenti AI

Un breve file di orientamento descrive gli stessi endpoint nel formato llmstxt.org, per assistenti di codice e framework di agenti.

Apri llms.txt

Da dove arrivano i dati

Tutti gli avvisi provengono da Tenders Electronic Daily (TED), il giornale ufficiale degli appalti dell'UE. Tendova aggiunge traduzione, struttura e ricerca; gli avvisi restano dati pubblici.

Per un accesso massivo o commerciale ai dati, scrivi a [email protected].