Citește mai mult

Tendersight API

Date despre licitații pentru sistemele taleși pentru agenții tăi.

Caută anunțuri și citește documentele, ofertele și autoritățile lor din propriul tău software, printr-un singur API. Apelurile folosesc aceleași credite ca aplicația.

Exemplu de cerere
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
  }'
Exemplu de răspuns, prescurtat
{
  "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
}

Anunțuri din 28+ surse oficiale

REST și MCP cu o singură cheie

Credite pe apel, în fiecare plan

Anunțurile pe care echipa ta le citește în Tendersight, livrate în CRM-ul tău, în depozitul de date sau către propriul tău agent.

API-ul citește același index ca Tendersight Leads. Folosește-l ca să alimentezi un pipeline de vânzări, să completezi datele despre autorități contractante și furnizori sau să-i dai unui agent propria căutare de licitații.

Ce returnează API-ul.

Șase tipuri de date, în 9 endpointuri.

  • Căutare de anunțuri

    Filtrează după text, cod CPV, țara și regiunea autorității contractante, valoarea estimată în euro, termen, data publicării și tipul anunțului.

  • Detaliile anunțului

    Un anunț după cheia sa, cu autoritățile contractante, valoarea estimată, termenele, criteriile de atribuire, codul CPV și starea procedurii.

  • Documentele licitației

    Lista documentelor unui anunț și fiecare fișier, descărcat prin API.

  • Oferte și câștigători

    Cine a depus ofertă la un anunț, valoarea fiecărei oferte și cine a câștigat, acolo unde sursa le publică.

  • Autorități contractante și furnizori

    Caută autoritățile contractante care au publicat anunțuri după orice parte a numelui sau după codul fiscal. Orice autoritate contractantă sau furnizor se găsește după codul fiscal sau după cheie.

  • Metadatele filtrelor

    Valorile de filtru acceptate de căutare și câte anunțuri are fiecare. Acest apel nu consumă credite.

De la înregistrare la primul tău apel.

Un cont, o cheie și un header. Referința API listează fiecare endpoint, câmp și eroare.

  1. 01

    Creează un cont gratuit

    Înregistrează-te gratuit. Fiecare plan include API-ul, iar apelurile consumă din aceleași credite ca restul Tendersight.

  2. 02

    Creează o cheie API

    Proprietarul echipei deschide Chei API în setările echipei, dă un nume cheii și îi alege permisiunile. Cheia este afișată o singură dată, așa că păstreaz-o în siguranță.

  3. 03

    Fă primul apel

    Trimite cheia ca token Bearer. Începe cu o căutare de anunțuri, apoi deschide anunțurile, documentele și ofertele pe care le returnează.

Autentificare
Authorization: Bearer tsk_live_…

Trimite cheia la fiecare apel. Cheia nu mai funcționează din momentul în care este revocată.

Permisiuni
notices:readdocuments:readawards:readorganizations:read

O cheie are doar permisiunile pe care le alegi. Un apel în afara lor primește 403.

Paginare
continuationToken

O căutare returnează până la 100 de anunțuri pe pagină și un token pentru pagina următoare. Trimite tokenul înapoi ca să continui.

Limite de cereri
429Retry-After

Implicit, 10 cereri pe secundă și 100.000 pe zi pentru fiecare cheie. Peste limită, API-ul răspunde cu 429 și spune când să reîncerci.

Erori
application/problem+json

Detalii despre problemă, în JSON: 401 pentru o cheie lipsă, necunoscută sau revocată, 402 când creditele echipei nu acoperă apelul, 403 pentru o permisiune lipsă, 429 pentru prea multe cereri.

Credite
X-Credits-ChargedX-RateLimit-Remaining

Fiecare răspuns arată cât a consumat apelul și câte cereri au mai rămas. Doar apelurile reușite consumă credite.

Plătești pe apel, în credite.

Apelurile consumă din soldul de credite al echipei, același pe care îl folosește Flow în aplicație. În Team, 1.000 de credite costă 2,50 €. Un cont gratuit primește 2.000 de credite la înregistrare.

Vezi planurile și prețurile
Credite pe apel la Tendersight API
ApelCredite pe apel
O căutare de anunțuri POST /v1/notices/search2
Un anunț GET /v1/notices/{noticeKey}1
Lista documentelor unui anunț GET /v1/notices/{noticeKey}/documents1
Descărcarea unui document GET /v1/notices/{noticeKey}/documents/{documentId}5
Ofertele depuse la un anunț GET /v1/notices/{noticeKey}/bids5
O căutare de autorități contractante GET /v1/buyers?query=&limit=1
O căutare de autorități contractante sau furnizori după codul fiscal GET /v1/organizations?fiscalId=&limit=1
O autoritate contractantă sau un furnizor GET /v1/organizations/{organizationKey}1
Valorile de filtru ale căutării GET /v1/meta/filters0

Doar apelurile reușite consumă credite.

Aceleași date pentru agenții tăi, prin MCP.

Conectează orice client MCP la serverul Tendersight cu aceeași cheie. Instrumentele urmează endpointurile REST și folosesc aceleași permisiuni și credite.

Exemplu de configurare a clientului
{
  "mcpServers": {
    "tendersight": {
      "url": "https://api.tendersight.ai/mcp",
      "headers": {
        "Authorization": "Bearer tsk_live_…"
      }
    }
  }
}
  • search_noticesCaută anunțuri cu aceleași filtre ca API-ul
  • get_noticeCitește un anunț
  • list_notice_documentsListează documentele unui anunț
  • list_notice_bidsListează ofertele depuse la un anunț
  • search_buyersGăsește autorități contractante după nume sau cod fiscal
  • get_organizationCitește o autoritate contractantă sau un furnizor
  • search_organizationsGăsește autorități contractante și furnizori după codul fiscal

Întrebări despre Tendersight API

Ce licitații acoperă API-ul?

Aceleași anunțuri ca Tendersight Leads: licitații publice din 28+ surse oficiale, cu documentele lor, autoritățile contractante și furnizorii implicați și, acolo unde sursa le publică, ofertele și câștigătorii.

Cât costă un apel?

Fiecare apel reușit consumă între 0 și 5 credite din soldul echipei, în funcție de endpoint. Tabelul de pe această pagină listează fiecare endpoint, iar apelurile eșuate nu consumă nimic.

Pot încerca API-ul gratuit?

Da. API-ul este inclus în fiecare plan, inclusiv în planul Gratuit. Un cont gratuit primește 2.000 de credite la înregistrare, iar apelurile API consumă din ele la fel ca restul Tendersight.

Care sunt limitele de cereri?

Implicit, 10 cereri pe secundă și 100.000 pe zi pentru fiecare cheie. Peste limită, API-ul răspunde cu 429 și un header Retry-After, iar răspunsurile includ X-RateLimit-Limit și X-RateLimit-Remaining.

Cât de actuale sunt datele?

Fiecare apel citește același index în care caută aplicația Tendersight, iar indexul este actualizat zilnic din sursele oficiale.

Cine poate crea și revoca chei API?

Proprietarii echipei, în setările echipei. Fiecare cheie are un nume și propriile permisiuni, este afișată o singură dată, la creare, și nu mai funcționează din momentul în care este revocată.

Creează o cheie și fă primul tău apel.

Începe gratuit, creează o cheie API în setările echipei și urmează referința API.