Czytaj więcej

Tendersight API

Dane o przetargach dla Twoich systemówi Twoich agentów.

Przeszukuj ogłoszenia i czytaj ich dokumenty, oferty i zamawiających z poziomu własnego oprogramowania, przez jedno API. Wywołania korzystają z tych samych kredytów co aplikacja.

Przykładowe zapytanie
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
  }'
Przykładowa odpowiedź, skrócona
{
  "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
}

Ogłoszenia z 28+ oficjalnych źródeł

REST i MCP z jednym kluczem

Kredyty za wywołanie, w każdym planie

Ogłoszenia, które Twój zespół czyta w Tendersight, dostarczane do Twojego CRM, hurtowni danych lub własnego agenta.

API czyta ten sam indeks co Tendersight Leads. Użyj go, aby zasilać pipeline sprzedaży, uzupełniać dane zamawiających i dostawców albo dać agentowi własną wyszukiwarkę przetargów.

Co zwraca API.

Sześć rodzajów danych w 9 endpointach.

  • Wyszukiwanie ogłoszeń

    Filtruj po tekście, kodzie CPV, kraju i regionie zamawiającego, szacunkowej wartości w euro, terminie, dacie publikacji i rodzaju ogłoszenia.

  • Szczegóły ogłoszenia

    Jedno ogłoszenie według klucza, z zamawiającymi, szacunkową wartością, terminami, kryteriami oceny ofert, kodem CPV i statusem postępowania.

  • Dokumenty przetargowe

    Lista dokumentów ogłoszenia i każdy plik, pobierany przez API.

  • Oferty i zwycięzcy

    Kto złożył ofertę w postępowaniu, wartość każdej oferty i kto wygrał, jeśli źródło publikuje te dane.

  • Zamawiający i dostawcy

    Wyszukuj zamawiających, którzy opublikowali ogłoszenia, po dowolnej części nazwy lub po identyfikatorze podatkowym. Każdego zamawiającego lub dostawcę znajdziesz po identyfikatorze podatkowym lub kluczu.

  • Metadane filtrów

    Wartości filtrów akceptowane przez wyszukiwanie i liczba ogłoszeń dla każdej z nich. To wywołanie nie zużywa kredytów.

Od rejestracji do pierwszego wywołania.

Konto, klucz i jeden nagłówek. Dokumentacja API opisuje każdy endpoint, pole i błąd.

  1. 01

    Załóż darmowe konto

    Zarejestruj się za darmo. Każdy plan obejmuje API, a wywołania korzystają z tych samych kredytów co reszta Tendersight.

  2. 02

    Utwórz klucz API

    Właściciel zespołu otwiera sekcję kluczy API w ustawieniach zespołu, nadaje kluczowi nazwę i wybiera jego zakresy uprawnień. Klucz jest pokazywany tylko raz, więc przechowuj go bezpiecznie.

  3. 03

    Wykonaj pierwsze wywołanie

    Wysyłaj klucz jako token Bearer. Zacznij od wyszukiwania ogłoszeń, a potem otwieraj zwrócone ogłoszenia, dokumenty i oferty.

Uwierzytelnianie
Authorization: Bearer tsk_live_…

Wysyłaj klucz z każdym wywołaniem. Klucz przestaje działać, gdy tylko zostanie unieważniony.

Zakresy uprawnień
notices:readdocuments:readawards:readorganizations:read

Klucz ma tylko wybrane przez Ciebie zakresy. Wywołanie spoza nich otrzymuje 403.

Paginacja
continuationToken

Wyszukiwanie zwraca do 100 ogłoszeń na stronę i token do następnej. Odeślij token, aby kontynuować.

Limity zapytań
429Retry-After

Domyślnie 10 zapytań na sekundę i 100 000 na dobę dla każdego klucza. Po przekroczeniu limitu API odpowiada kodem 429 i podaje, kiedy ponowić próbę.

Błędy
application/problem+json

Szczegóły problemu w formacie JSON: 401 przy brakującym, nieznanym lub unieważnionym kluczu, 402, gdy kredyty zespołu nie pokrywają wywołania, 403 przy braku zakresu, 429 przy zbyt wielu zapytaniach.

Kredyty
X-Credits-ChargedX-RateLimit-Remaining

Każda odpowiedź podaje, ile kredytów zużyło wywołanie i ile zapytań pozostało. Kredyty zużywają tylko udane wywołania.

Płacisz za wywołanie, kredytami.

Wywołania korzystają z salda kredytów Twojego zespołu, tego samego, z którego korzysta Flow w aplikacji. W planie Team 1000 kredytów kosztuje 2,50 €. Darmowe konto dostaje 2000 kredytów przy rejestracji.

Zobacz plany i cennik
Kredyty za wywołanie Tendersight API
WywołanieKredyty za wywołanie
Wyszukiwanie ogłoszeń POST /v1/notices/search2
Jedno ogłoszenie GET /v1/notices/{noticeKey}1
Lista dokumentów ogłoszenia GET /v1/notices/{noticeKey}/documents1
Pobranie dokumentu GET /v1/notices/{noticeKey}/documents/{documentId}5
Oferty złożone w postępowaniu GET /v1/notices/{noticeKey}/bids5
Wyszukiwanie zamawiających GET /v1/buyers?query=&limit=1
Wyszukiwanie zamawiających lub dostawców po identyfikatorze podatkowym GET /v1/organizations?fiscalId=&limit=1
Jeden zamawiający lub dostawca GET /v1/organizations/{organizationKey}1
Wartości filtrów wyszukiwania GET /v1/meta/filters0

Kredyty zużywają tylko udane wywołania.

Te same dane dla Twoich agentów, przez MCP.

Połącz dowolnego klienta MCP z serwerem Tendersight tym samym kluczem. Narzędzia odpowiadają endpointom REST i korzystają z tych samych zakresów i kredytów.

Przykładowa konfiguracja klienta
{
  "mcpServers": {
    "tendersight": {
      "url": "https://api.tendersight.ai/mcp",
      "headers": {
        "Authorization": "Bearer tsk_live_…"
      }
    }
  }
}
  • search_noticesWyszukiwanie ogłoszeń z tymi samymi filtrami co w API
  • get_noticeOdczyt jednego ogłoszenia
  • list_notice_documentsLista dokumentów ogłoszenia
  • list_notice_bidsLista ofert złożonych w postępowaniu
  • search_buyersWyszukiwanie zamawiających po nazwie lub identyfikatorze podatkowym
  • get_organizationOdczyt jednego zamawiającego lub dostawcy
  • search_organizationsWyszukiwanie zamawiających i dostawców po identyfikatorze podatkowym

Pytania o Tendersight API

Jakie przetargi obejmuje API?

Te same ogłoszenia co Tendersight Leads: przetargi publiczne z 28+ oficjalnych źródeł, z dokumentami, zamawiającymi i dostawcami, których dotyczą, a także z ofertami i zwycięzcami, jeśli źródło je publikuje.

Ile kosztuje wywołanie?

Każde udane wywołanie zużywa od 0 do 5 kredytów z salda Twojego zespołu, zależnie od endpointu. Tabela na tej stronie wymienia każdy endpoint, a nieudane wywołania nie zużywają kredytów.

Czy mogę wypróbować API za darmo?

Tak. API jest dostępne w każdym planie, także w planie Darmowym. Darmowe konto dostaje 2000 kredytów przy rejestracji, a wywołania API korzystają z nich tak jak reszta Tendersight.

Jakie są limity zapytań?

Domyślnie 10 zapytań na sekundę i 100 000 na dobę dla każdego klucza. Po przekroczeniu limitu API odpowiada kodem 429 z nagłówkiem Retry-After, a odpowiedzi zawierają nagłówki X-RateLimit-Limit i X-RateLimit-Remaining.

Jak aktualne są dane?

Każde wywołanie czyta ten sam indeks, który przeszukuje aplikacja Tendersight, a indeks ten jest codziennie aktualizowany na podstawie oficjalnych źródeł.

Kto może tworzyć i unieważniać klucze API?

Właściciele zespołu, w ustawieniach zespołu. Każdy klucz ma nazwę i własne zakresy uprawnień, jest pokazywany tylko raz, przy utworzeniu, i przestaje działać, gdy tylko zostanie unieważniony.

Utwórz klucz i wykonaj pierwsze wywołanie.

Zacznij bezpłatnie, utwórz klucz API w ustawieniach zespołu i postępuj zgodnie z dokumentacją API.