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.
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
}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.
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.
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.
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:readKlucz ma tylko wybrane przez Ciebie zakresy. Wywołanie spoza nich otrzymuje 403.
- Paginacja
continuationTokenWyszukiwanie zwraca do 100 ogłoszeń na stronę i token do następnej. Odeślij token, aby kontynuować.
- Limity zapytań
429Retry-AfterDomyś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+jsonSzczegół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-RemainingKaż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| Wywołanie | Kredyty za wywołanie |
|---|---|
Wyszukiwanie ogłoszeń POST /v1/notices/search | 2 |
Jedno ogłoszenie GET /v1/notices/{noticeKey} | 1 |
Lista dokumentów ogłoszenia GET /v1/notices/{noticeKey}/documents | 1 |
Pobranie dokumentu GET /v1/notices/{noticeKey}/documents/{documentId} | 5 |
Oferty złożone w postępowaniu GET /v1/notices/{noticeKey}/bids | 5 |
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/filters | 0 |
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.
{
"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
Powiązane
Dane przetargowe
Połączenia
Plany
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.