Leggi di più

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.

Richiesta di esempio
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
  }'
Risposta di esempio, abbreviata
{
  "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.

  1. 01

    Crea un account gratuito

    Iscriviti gratis. Ogni piano include l'API e le chiamate usano gli stessi crediti del resto di Tendersight.

  2. 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.

  3. 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:read

Una chiave ha solo gli ambiti che scegli. Una chiamata al di fuori di questi riceve un 403.

Paginazione
continuationToken

Una ricerca restituisce fino a 100 bandi per pagina e un token per la successiva. Rimanda il token per continuare.

Limiti di richieste
429Retry-After

Per 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+json

Dettagli 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-Remaining

Ogni 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
Crediti per chiamata a Tendersight API
ChiamataCrediti per chiamata
Una ricerca di bandi POST /v1/notices/search2
Un bando GET /v1/notices/{noticeKey}1
L'elenco dei documenti di un bando GET /v1/notices/{noticeKey}/documents1
Il download di un documento GET /v1/notices/{noticeKey}/documents/{documentId}5
Le offerte presentate per un bando GET /v1/notices/{noticeKey}/bids5
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/filters0

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.

Configurazione di esempio del client
{
  "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

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.