Číst více

Tendersight API

Data o zakázkách pro vaše systémyi pro vaše agenty.

Vyhledávejte oznámení a čtěte jejich dokumenty, nabídky a zadavatele z vlastního softwaru, přes jedno API. Volání čerpají stejné kredity jako aplikace.

Ukázkový požadavek
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
  }'
Ukázková odpověď, zkrácená
{
  "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
}

Oznámení z 28+ oficiálních zdrojů

REST a MCP s jedním klíčem

Kredity za volání, v každém plánu

Oznámení, která váš tým čte v Tendersight, doručená do vašeho CRM, datového skladu nebo vlastního agenta.

API čte stejný index jako Tendersight Leads. Použijte ho k plnění obchodní pipeline, k obohacení záznamů o zadavatelích a dodavatelích nebo dejte agentovi vlastní vyhledávání zakázek.

Co API vrací.

Šest druhů dat na 9 endpointech.

  • Vyhledávání oznámení

    Filtrujte podle textu, kódu CPV, země a regionu zadavatele, předpokládané hodnoty v eurech, lhůty, data zveřejnění a typu oznámení.

  • Detail oznámení

    Jedno oznámení podle jeho klíče, se zadavateli, předpokládanou hodnotou, lhůtami, hodnoticími kritérii, kódem CPV a stavem řízení.

  • Zadávací dokumentace

    Seznam dokumentů oznámení a každý soubor, stažený přes API.

  • Nabídky a vítězové

    Kdo podal nabídku k oznámení, hodnota každé nabídky a kdo vyhrál, pokud je zdroj zveřejňuje.

  • Zadavatelé a dodavatelé

    Vyhledejte zadavatele, kteří zveřejnili oznámení, podle libovolné části názvu nebo podle daňového identifikačního čísla. Každého zadavatele nebo dodavatele dohledáte podle daňového identifikačního čísla nebo klíče.

  • Metadata filtrů

    Hodnoty filtrů, které vyhledávání přijímá, a kolik oznámení každá z nich obsahuje. Toto volání nespotřebuje žádné kredity.

Od registrace k prvnímu volání.

Účet, klíč a jedna hlavička. Referenční dokumentace API uvádí každý endpoint, pole i chybu.

  1. 01

    Vytvořte si bezplatný účet

    Zaregistrujte se zdarma. API je součástí každého plánu a volání čerpají stejné kredity jako zbytek Tendersight.

  2. 02

    Vytvořte klíč API

    Vlastník týmu otevře v nastavení týmu správu klíčů API, pojmenuje klíč a vybere jeho oprávnění. Klíč se zobrazí jen jednou, proto ho bezpečně uložte.

  3. 03

    Proveďte první volání

    Klíč posílejte jako Bearer token. Začněte vyhledáváním oznámení a pak otevřete oznámení, dokumenty a nabídky, které vrátí.

Ověření
Authorization: Bearer tsk_live_…

Klíč posílejte s každým voláním. Přestane fungovat, jakmile je zrušen.

Oprávnění
notices:readdocuments:readawards:readorganizations:read

Klíč má jen oprávnění, která vyberete. Volání mimo ně dostane odpověď 403.

Stránkování
continuationToken

Vyhledávání vrací až 100 oznámení na stránku a token pro další stránku. Pro pokračování pošlete token zpět.

Limity požadavků
429Retry-After

Ve výchozím nastavení 10 požadavků za sekundu a 100 000 za den na klíč. Po překročení limitu API odpoví 429 a sdělí, kdy to zkusit znovu.

Chyby
application/problem+json

Podrobnosti o problému v JSON: 401 pro chybějící, neznámý nebo zrušený klíč, 402, když kredity týmu volání nepokryjí, 403 pro chybějící oprávnění, 429 pro příliš mnoho požadavků.

Kredity
X-Credits-ChargedX-RateLimit-Remaining

Každá odpověď uvádí, kolik volání spotřebovalo a kolik požadavků zbývá. Kredity spotřebují jen úspěšná volání.

Platíte za volání, v kreditech.

Volání čerpají z kreditového zůstatku vašeho týmu, stejného, ze kterého čerpá Flow v aplikaci. V plánu Team stojí 1 000 kreditů 2,50 €. Bezplatný účet dostane při registraci 2 000 kreditů.

Zobrazit plány a ceny
Kredity za volání Tendersight API
VoláníKredity za volání
Vyhledávání oznámení POST /v1/notices/search2
Jedno oznámení GET /v1/notices/{noticeKey}1
Seznam dokumentů oznámení GET /v1/notices/{noticeKey}/documents1
Stažení dokumentu GET /v1/notices/{noticeKey}/documents/{documentId}5
Nabídky k oznámení GET /v1/notices/{noticeKey}/bids5
Vyhledávání zadavatelů GET /v1/buyers?query=&limit=1
Vyhledávání zadavatelů nebo dodavatelů podle daňového identifikačního čísla GET /v1/organizations?fiscalId=&limit=1
Jeden zadavatel nebo dodavatel GET /v1/organizations/{organizationKey}1
Hodnoty filtrů pro vyhledávání GET /v1/meta/filters0

Kredity spotřebují jen úspěšná volání.

Stejná data pro vaše agenty, přes MCP.

Připojte libovolného klienta MCP k serveru Tendersight se stejným klíčem. Nástroje odpovídají endpointům REST a používají stejná oprávnění a kredity.

Ukázková konfigurace klienta
{
  "mcpServers": {
    "tendersight": {
      "url": "https://api.tendersight.ai/mcp",
      "headers": {
        "Authorization": "Bearer tsk_live_…"
      }
    }
  }
}
  • search_noticesVyhledá oznámení se stejnými filtry jako API
  • get_noticePřečte jedno oznámení
  • list_notice_documentsVypíše dokumenty oznámení
  • list_notice_bidsVypíše nabídky k oznámení
  • search_buyersNajde zadavatele podle názvu nebo daňového identifikačního čísla
  • get_organizationPřečte jednoho zadavatele nebo dodavatele
  • search_organizationsNajde zadavatele a dodavatele podle daňového identifikačního čísla

Otázky k Tendersight API

Které zakázky API pokrývá?

Stejná oznámení jako Tendersight Leads: veřejné zakázky z 28+ oficiálních zdrojů, s jejich dokumenty, zúčastněnými zadavateli a dodavateli a, pokud je zdroj zveřejňuje, s nabídkami a vítězi.

Kolik stojí jedno volání?

Každé úspěšné volání spotřebuje ze zůstatku vašeho týmu 0 až 5 kreditů, podle endpointu. Tabulka na této stránce uvádí každý endpoint a neúspěšná volání nespotřebují nic.

Mohu API vyzkoušet zdarma?

Ano. API je v každém plánu, včetně plánu Zdarma. Bezplatný účet dostane při registraci 2 000 kreditů a volání API z nich čerpají stejně jako zbytek Tendersight.

Jaké jsou limity požadavků?

Ve výchozím nastavení 10 požadavků za sekundu a 100 000 za den na klíč. Po překročení limitu API odpoví 429 s hlavičkou Retry-After a odpovědi obsahují X-RateLimit-Limit a X-RateLimit-Remaining.

Jak aktuální jsou data?

Každé volání čte stejný index, ve kterém vyhledává aplikace Tendersight, a tento index se denně aktualizuje z oficiálních zdrojů.

Kdo může vytvářet a rušit klíče API?

Vlastníci týmu, v nastavení týmu. Každý klíč má název a vlastní oprávnění, zobrazí se jednou při vytvoření a přestane fungovat, jakmile je zrušen.

Vytvořte klíč a proveďte první volání.

Začněte zdarma, vytvořte klíč API v nastavení týmu a postupujte podle referenční dokumentace API.