Tendersight API
Dati sulle gare per i tuoi sistemie i tuoi agenti.
Cerca bandi e leggi i loro documenti, offerte e committenti dal tuo software, tramite un'unica API. Le chiamate usano gli stessi crediti dell'app.
curl https://api.tendersight.ai/v1/notices/search \
-H "Authorization: Bearer $TENDERSIGHT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"filters": {
"searchText": "lift maintenance",
"contractTypes": ["services"],
"buyer": { "countries": ["AUT", "DEU"] },
"deadline": { "from": "2026-11-16T00:00:00Z" },
"estimatedValue": { "min": 250000 }
},
"pageSize": 20
}'{
"items": [
{
"key": "not_01kf3m8q2vx7d9hk4tz6rbn5cw",
"title": "Maintenance of lifts in federal buildings, 3 lots",
"publicationDate": "2026-11-03T08:00:00+00:00",
"estimatedValue": {
"minAmount": null,
"maxAmount": 1800000,
"currency": "EUR",
"minAmountEur": null,
"maxAmountEur": 1800000
},
"buyers": [
{
"organizationKey": "org_01jz8r5t2kw4n6p9c3x7v1hmqd",
"name": "Federal property agency",
"country": "AUT",
"fiscalId": "ATU12345678"
}
],
"milestones": [
{
"type": "deadline",
"name": "Time limit for receipt of tenders",
"date": "2026-12-01T10:00:00+00:00"
}
],
"contractType": "services",
"primaryCpv": {
"code": "50750000-7",
"description": "Lift-maintenance services"
},
"biddability": "biddable",
"nextDeadlineAt": "2026-12-01T10:00:00+00:00"
}
],
"continuationToken": "eyJhZnRlciI6WzEuOTQs…",
"totalCount": 23
}Bandi da 28+ fonti ufficiali
REST e MCP con una sola chiave
Crediti per chiamata, in ogni piano
I bandi che il tuo team legge in Tendersight, consegnati al tuo CRM, al tuo data warehouse o al tuo agente.
L'API legge lo stesso indice di Tendersight Leads. Usala per alimentare una pipeline commerciale, arricchire le anagrafiche di committenti e fornitori o dare a un agente la sua ricerca di gare.
Cosa restituisce l'API.
Sei tipi di dati, su 9 endpoint.
Ricerca di bandi
Filtra per testo, codice CPV, paese e regione del committente, importo stimato in euro, scadenza, data di pubblicazione e tipo di bando.
Dettagli del bando
Un bando tramite la sua chiave, con committenti, importo stimato, scadenze, criteri di aggiudicazione, codice CPV e stato della procedura.
Documentazione di gara
L'elenco dei documenti di un bando e ogni file, scaricato tramite l'API.
Offerte e aggiudicatari
Chi ha presentato offerta per un bando, l'importo di ogni offerta e chi ha vinto, quando la fonte pubblica questi dati.
Committenti e fornitori
Cerca i committenti che hanno pubblicato bandi con una parte qualsiasi del nome o con l'identificativo fiscale. Ogni committente o fornitore si trova tramite identificativo fiscale o chiave.
Metadati dei filtri
I valori di filtro che la ricerca accetta e quanti bandi contiene ciascuno. Questa chiamata non usa crediti.
Dall'iscrizione alla prima chiamata.
Un account, una chiave e un'intestazione. La documentazione dell'API elenca ogni endpoint, campo ed errore.
01
Crea un account gratuito
Iscriviti gratis. Ogni piano include l'API e le chiamate usano gli stessi crediti del resto di Tendersight.
02
Crea una chiave API
Un proprietario del team apre la sezione delle chiavi API nelle impostazioni del team, dà un nome alla chiave e ne sceglie gli ambiti. La chiave viene mostrata una sola volta, quindi conservala in modo sicuro.
03
Fai la prima chiamata
Invia la chiave come token Bearer. Inizia con una ricerca di bandi, poi apri i bandi, i documenti e le offerte che restituisce.
- Autenticazione
Authorization: Bearer tsk_live_…Invia la chiave con ogni chiamata. Smette di funzionare appena viene revocata.
- Ambiti
notices:readdocuments:readawards:readorganizations:readUna chiave ha solo gli ambiti che scegli. Una chiamata al di fuori di questi riceve un 403.
- Paginazione
continuationTokenUna ricerca restituisce fino a 100 bandi per pagina e un token per la successiva. Rimanda il token per continuare.
- Limiti di richieste
429Retry-AfterPer impostazione predefinita, 10 richieste al secondo e 100.000 al giorno per chiave. Oltre il limite, l'API risponde 429 e indica quando riprovare.
- Errori
application/problem+jsonDettagli del problema in JSON: 401 per una chiave mancante, sconosciuta o revocata, 402 quando i crediti del team non coprono la chiamata, 403 per un ambito mancante, 429 per troppe richieste.
- Crediti
X-Credits-ChargedX-RateLimit-RemainingOgni risposta indica quanti crediti ha usato la chiamata e quante richieste restano. Solo le chiamate riuscite usano crediti.
Paghi per chiamata, in crediti.
Le chiamate usano il saldo crediti del tuo team, lo stesso che Flow usa nell'app. Con Team, 1000 crediti costano 2,50 €. Un account gratuito riceve 2000 crediti all'iscrizione.
Vedi piani e prezzi| Chiamata | Crediti per chiamata |
|---|---|
Una ricerca di bandi POST /v1/notices/search | 2 |
Un bando GET /v1/notices/{noticeKey} | 1 |
L'elenco dei documenti di un bando GET /v1/notices/{noticeKey}/documents | 1 |
Il download di un documento GET /v1/notices/{noticeKey}/documents/{documentId} | 5 |
Le offerte presentate per un bando GET /v1/notices/{noticeKey}/bids | 5 |
Una ricerca di committenti GET /v1/buyers?query=&limit= | 1 |
Una ricerca di committenti o fornitori per identificativo fiscale GET /v1/organizations?fiscalId=&limit= | 1 |
Un committente o un fornitore GET /v1/organizations/{organizationKey} | 1 |
I valori dei filtri di ricerca GET /v1/meta/filters | 0 |
Solo le chiamate riuscite usano crediti.
Gli stessi dati per i tuoi agenti, tramite MCP.
Collega qualsiasi client MCP al server di Tendersight con la stessa chiave. Gli strumenti seguono gli endpoint REST e usano gli stessi ambiti e crediti.
{
"mcpServers": {
"tendersight": {
"url": "https://api.tendersight.ai/mcp",
"headers": {
"Authorization": "Bearer tsk_live_…"
}
}
}
}- search_noticesCerca bandi con gli stessi filtri dell'API
- get_noticeLeggi un bando
- list_notice_documentsElenca i documenti di un bando
- list_notice_bidsElenca le offerte presentate per un bando
- search_buyersTrova committenti per nome o identificativo fiscale
- get_organizationLeggi un committente o un fornitore
- search_organizationsTrova committenti e fornitori per identificativo fiscale
Correlati
Dati sulle gare
Connessioni
Piani
Domande su Tendersight API
Quali gare copre l'API?
Gli stessi bandi di Tendersight Leads: gare pubbliche da 28+ fonti ufficiali, con i loro documenti, i committenti e i fornitori coinvolti e, quando la fonte li pubblica, le offerte e gli aggiudicatari.
Quanto costa una chiamata?
Ogni chiamata riuscita usa tra 0 e 5 crediti dal saldo del tuo team, a seconda dell'endpoint. La tabella in questa pagina elenca ogni endpoint, e le chiamate non riuscite non ne usano.
Posso provare l'API gratis?
Sì. L'API è inclusa in ogni piano, Gratuito compreso. Un account gratuito riceve 2000 crediti all'iscrizione, e le chiamate API li usano come il resto di Tendersight.
Quali sono i limiti di richieste?
Per impostazione predefinita, 10 richieste al secondo e 100.000 al giorno per chiave. Oltre il limite l'API risponde 429 con un'intestazione Retry-After, e le risposte includono X-RateLimit-Limit e X-RateLimit-Remaining.
Quanto sono aggiornati i dati?
Ogni chiamata legge lo stesso indice in cui cerca l'app Tendersight, e quell'indice viene aggiornato ogni giorno dalle fonti ufficiali.
Chi può creare e revocare le chiavi API?
I proprietari del team, nelle impostazioni del team. Ogni chiave ha un nome e i propri ambiti, viene mostrata una sola volta alla creazione e smette di funzionare appena viene revocata.
Crea una chiave e fai la prima chiamata.
Inizia gratis, crea una chiave API nelle impostazioni del team e segui la documentazione dell'API.