Tendersight API
Közbeszerzési adatok a rendszereinekés az ügynökeinek.
Keressen hirdetményeket, és olvassa el a dokumentumaikat, ajánlataikat és ajánlatkérőiket a saját szoftveréből, egyetlen API-n keresztül. A hívások ugyanazokat a krediteket használják, mint az alkalmazás.
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
}Hirdetmények 28+ hivatalos forrásból
REST és MCP egyetlen kulccsal
Hívásonkénti kreditek minden csomagban
A hirdetmények, amelyeket a csapata a Tendersightban olvas, eljuttatva a CRM-jébe, az adattárházába vagy a saját ügynökéhez.
Az API ugyanazt az indexet olvassa, mint a Tendersight Leads. Használja egy értékesítési pipeline táplálására, ajánlatkérői és beszállítói adatok bővítésére, vagy arra, hogy egy ügynöknek saját közbeszerzési keresést adjon.
Amit az API visszaad.
Hatféle adat, 9 végponton.
Hirdetménykeresés
Szűrés szöveg, CPV-kód, az ajánlatkérő országa és régiója, euróban megadott becsült érték, határidő, közzététel dátuma és hirdetménytípus szerint.
Hirdetmény részletei
Egy hirdetmény a kulcsa alapján, ajánlatkérőivel, becsült értékével, határidőivel, értékelési szempontjaival, CPV-kódjával és eljárásállapotával.
Közbeszerzési dokumentumok
Egy hirdetmény dokumentumainak listája, és minden fájl, az API-n keresztül letöltve.
Ajánlatok és nyertesek
Ki tett ajánlatot egy hirdetményre, mekkora volt az egyes ajánlatok értéke és ki nyert, ha a forrás közzéteszi ezeket.
Ajánlatkérők és beszállítók
A hirdetményt közzétett ajánlatkérőket a nevük bármely részlete vagy az adószámuk alapján keresheti. Bármely ajánlatkérőt vagy beszállítót az adószáma vagy a kulcsa alapján talál meg.
Szűrő-metaadatok
A keresés által elfogadott szűrőértékek, és hogy mindegyikhez hány hirdetmény tartozik. Ez a hívás nem használ kreditet.
A regisztrációtól az első hívásáig.
Egy fiók, egy kulcs és egy fejléc. Az API-referencia minden végpontot, mezőt és hibát felsorol.
01
Hozzon létre ingyenes fiókot
Regisztráljon ingyen. Minden csomag tartalmazza az API-t, és a hívások ugyanazokból a kreditekből fogyasztanak, mint a Tendersight többi része.
02
Hozzon létre API-kulcsot
A csapat tulajdonosa a csapatbeállításokban megnyitja az API-kulcsok oldalt, elnevezi a kulcsot, és kiválasztja a jogosultságait. A kulcs csak egyszer jelenik meg, ezért tárolja biztonságos helyen.
03
Indítsa el az első hívást
Küldje a kulcsot Bearer tokenként. Kezdjen egy hirdetménykereséssel, majd nyissa meg a visszaadott hirdetményeket, dokumentumokat és ajánlatokat.
- Hitelesítés
Authorization: Bearer tsk_live_…Minden híváshoz küldje el a kulcsot. A kulcs a visszavonás pillanatától nem működik.
- Jogosultságok
notices:readdocuments:readawards:readorganizations:readEgy kulcs csak az Ön által választott jogosultságokkal rendelkezik. Az ezeken kívüli hívás 403-at kap.
- Lapozás
continuationTokenEgy keresés oldalanként legfeljebb 100 hirdetményt ad vissza, és egy tokent a következő oldalhoz. A folytatáshoz küldje vissza a tokent.
- Kéréskorlátok
429Retry-AfterAlapértelmezés szerint kulcsonként 10 kérés másodpercenként és 100 000 naponta. A korlát felett az API 429-cel válaszol, és közli, mikor lehet újrapróbálkozni.
- Hibák
application/problem+jsonHibarészletek JSON-ban: 401 hiányzó, ismeretlen vagy visszavont kulcsnál, 402, ha a csapat kreditjei nem fedezik a hívást, 403 hiányzó jogosultságnál, 429 túl sok kérésnél.
- Kreditek
X-Credits-ChargedX-RateLimit-RemainingMinden válasz megmutatja, mennyit használt a hívás, és hány kérés maradt még. Csak a sikeres hívások használnak kreditet.
Fizessen hívásonként, kreditben.
A hívások a csapata kreditegyenlegéből fogyasztanak, ugyanabból, amelyet a Flow is használ az alkalmazásban. A Team csomagban 1000 kredit ára 2,50 €. Egy ingyenes fiók regisztrációkor 2000 kreditet kap.
Csomagok és árak| Hívás | Kredit hívásonként |
|---|---|
Hirdetménykeresés POST /v1/notices/search | 2 |
Egy hirdetmény GET /v1/notices/{noticeKey} | 1 |
Egy hirdetmény dokumentumlistája GET /v1/notices/{noticeKey}/documents | 1 |
Egy dokumentum letöltése GET /v1/notices/{noticeKey}/documents/{documentId} | 5 |
Egy hirdetmény ajánlatai GET /v1/notices/{noticeKey}/bids | 5 |
Ajánlatkérőkeresés GET /v1/buyers?query=&limit= | 1 |
Ajánlatkérő vagy beszállító keresése adószám alapján GET /v1/organizations?fiscalId=&limit= | 1 |
Egy ajánlatkérő vagy beszállító GET /v1/organizations/{organizationKey} | 1 |
A keresés szűrőértékei GET /v1/meta/filters | 0 |
Csak a sikeres hívások használnak kreditet.
Ugyanazok az adatok az ügynökeinek, MCP-n keresztül.
Csatlakoztasson bármely MCP-klienst a Tendersight szerverhez ugyanazzal a kulccsal. Az eszközök a REST-végpontokat követik, és ugyanazokat a jogosultságokat és krediteket használják.
{
"mcpServers": {
"tendersight": {
"url": "https://api.tendersight.ai/mcp",
"headers": {
"Authorization": "Bearer tsk_live_…"
}
}
}
}- search_noticesHirdetmények keresése ugyanazokkal a szűrőkkel, mint az API-ban
- get_noticeEgy hirdetmény olvasása
- list_notice_documentsEgy hirdetmény dokumentumainak listázása
- list_notice_bidsEgy hirdetményre beadott ajánlatok listázása
- search_buyersAjánlatkérők keresése név vagy adószám alapján
- get_organizationEgy ajánlatkérő vagy beszállító adatainak olvasása
- search_organizationsAjánlatkérők és beszállítók keresése adószám alapján
Kapcsolódó
Közbeszerzési adatok
Csatlakozások
Csomagok
Kérdések a Tendersight API-ról
Mely közbeszerzésekre terjed ki az API?
Ugyanazokra a hirdetményekre, mint a Tendersight Leads: közbeszerzésekre 28+ hivatalos forrásból, a dokumentumaikkal, az érintett ajánlatkérőkkel és beszállítókkal, és ha a forrás közzéteszi őket, az ajánlatokkal és a nyertesekkel.
Mennyibe kerül egy hívás?
Egy sikeres hívás a végponttól függően 0 és 5 közötti kreditet használ fel a csapat egyenlegéből. Az oldalon lévő táblázat minden végpontot felsorol, a sikertelen hívások pedig nem használnak kreditet.
Kipróbálhatom ingyen az API-t?
Igen. Az API minden csomagban elérhető, az Ingyenes csomagban is. Egy ingyenes fiók regisztrációkor 2000 kreditet kap, és az API-hívások ugyanúgy ezekből fogyasztanak, mint a Tendersight többi része.
Milyen kéréskorlátok vannak?
Alapértelmezés szerint kulcsonként 10 kérés másodpercenként és 100 000 naponta. A korlát felett az API 429-cel és Retry-After fejléccel válaszol, a válaszok pedig tartalmazzák az X-RateLimit-Limit és az X-RateLimit-Remaining fejlécet.
Mennyire frissek az adatok?
Minden hívás ugyanazt az indexet olvassa, amelyben a Tendersight alkalmazás keres, és ez az index naponta frissül a hivatalos forrásokból.
Ki hozhat létre és vonhat vissza API-kulcsokat?
A csapat tulajdonosai, a csapatbeállításokban. Minden kulcsnak van neve és saját jogosultságai, csak egyszer, a létrehozásakor jelenik meg, és a visszavonás pillanatától nem működik.
Hozzon létre egy kulcsot, és indítsa el az első hívását.
Kezdje ingyen, hozzon létre API-kulcsot a csapatbeállításokban, és kövesse az API-referenciát.