API ir MCP dokumentacija
Bazinis adresas: https://apibase.lt/api/pirkimai/. Atsakymai – JSON (UTF-8). Raktas siunčiamas antraštėje X-Api-Key: vp_…, arba Authorization: Bearer vp_…, arba parametru ?key=vp_…. Nemokamą raktą su 100 užklausų gausite čia. OpenAPI aprašas: openapi.json.
Duomenys – aktyvūs Lietuvos viešieji pirkimai iš Europos TED ir viešojo CVP IS sąrašo. Prie kiekvieno įrašo yra nuoroda į originalų skelbimą.
REST API
Būsena: GET v1/status
Nemokama, rakto nereikia. Rodo aktyvių pirkimų skaičių pagal šaltinį, duomenų atnaujinimo laiką ir kainas.
curl "https://apibase.lt/api/pirkimai/v1/status"
{"ok":true,"active_tenders":{"ted":123,"cvpis":456},
"data":{"ted_updated":"…","cvpis_updated":"…","exported":"…","note":"…"},"pricing":{…}}
Paieška: GET v1/tenders
1 užklausa. Parametrai (visi nebūtini):
text– paieška pavadinime ir aprašyme.cpv– CPV kodai ar jų pradžia, atskirti kableliais (pvz.,72arba45233000).region– NUTS kodas (LT011…LT029) arba apskrities pavadinimas.min_value,max_value– numatoma vertė.deadline_from,deadline_to– paraiškų termino intervalas (YYYY-MM-DD). Pagal nutylėjimądeadline_from= dabar, t. y. tik aktyvūs.published_from– paskelbta nuo (YYYY-MM-DD).contract_type–works|services|supplies.buyer– perkančiosios organizacijos pavadinimas.source–ted|cvpis.sort–deadline|published|value.limit(iki 50, pagal nutylėjimą 20),offset.
curl -H "X-Api-Key: vp_…" "https://apibase.lt/api/pirkimai/v1/tenders?cpv=72®ion=LT011&limit=2"
{"total":37,"count":2,"offset":0,
"items":[{"id":"cvpis:10556371","source":"cvpis","title":"…","buyer":"…",
"deadline":"2026-12-05T08:00:00Z","published":"2026-11-18","value":120000,"currency":"EUR",
"cpv":["72000000"],"cpv_names":["IT paslaugos: konsultavimas, programinės įrangos kūrimas, internetas ir pagalba"],
"region":[{"nuts":"LT011","name":"Vilniaus apskritis"}],
"contract_type":"services","procedure":"…","status":"…",
"url":"https://…","notice_pdf":"…","ted_url":null,"active":true,
"first_seen":"…","updated":"…","description":"…"}],
"data":{…},"requests_remaining":98,"plan":"free"}
Terminas (deadline) grąžinamas ISO formatu UTC laiku. Atsakyme taip pat yra antraštė X-Requests-Remaining.
Vienas pirkimas: GET v1/tenders/{id}
1 užklausa. id – iš paieškos rezultato, pvz., cvpis:10556371 arba ted:787554-2023. Grąžinamas pilnas aprašymas.
curl -H "X-Api-Key: vp_…" "https://apibase.lt/api/pirkimai/v1/tenders/cvpis:10556371"
Pokyčiai: GET v1/changes
1 užklausa. Parametrai: since (pvz., 2026-11-20T00:00:00Z) arba cursor (iš ankstesnio atsakymo), nebūtini cpv ir limit (iki 100). Kiekvienas įrašas turi lauką change: new, updated arba closed.
curl -H "X-Api-Key: vp_…" "https://apibase.lt/api/pirkimai/v1/changes?since=2026-11-20T00:00:00Z&cpv=72"
{"items":[{"change":"new","id":"ted:787554-2023", …}],"next_cursor":"…","has_more":false}
CPV paieška: GET v1/cpv?q=…
Nemokama. Randa CPV kodą pagal pavadinimą (lietuvių ar anglų kalba).
curl "https://apibase.lt/api/pirkimai/v1/cpv?q=programin"
{"items":[{"code":"72000000","name_lt":"…","name_en":"…","n":123}]}
Rakto būsena: GET v1/key
Nemokama. Grąžina id, plan (free | monthly), free_left, monthly_used, monthly_quota, plan_until, used_total, created, subscribe (prenumeratos mokėjimo nuoroda) ir pricing.
curl -H "X-Api-Key: vp_…" "https://apibase.lt/api/pirkimai/v1/key"
Klaidos ir limitai
- Klaidos formatas:
{"error":"rate_limited","message":"…"}. Žinutė (message) lietuvių kalba. 400– blogi parametrai,401– blogas raktas,402 payment_required– nemokamos užklausos baigėsi (atsakyme yrasubscribe),429 rate_limited– per daug užklausų,429 monthly_quota_used– išnaudota mėnesio kvota.- Be rakto – 10 užklausų per dieną iš vieno IP (bandymui). Iš šio puslapio paieškos, atsakius į apsaugos klausimą, – iki 100 per dieną.
- Paieška, vienas pirkimas ir pokyčiai kainuoja po 1 užklausą.
status,cpvirkey– nemokami.
MCP serveris
Adresas: https://apibase.lt/api/pirkimai/mcp (Streamable HTTP, be sesijos, JSON). Raktas – Authorization: Bearer vp_…. Klientams, kurie negali nustatyti antraščių, tinka ?key=vp_… adrese. Be rakto – 10 iškvietimų per dieną.
Įrankiai:
search_tenders– tie patys parametrai kaipGET v1/tenders.get_tender(id) – vienas pirkimas su pilnu aprašymu.changes_since(sincearbacursor,cpv,limit) – nauji, pakeisti ir pasibaigę pirkimai.list_cpv(query,limit) – CPV kodų paieška, nemokama.
# Claude Code
claude mcp add --transport http lt-procurement https://apibase.lt/api/pirkimai/mcp --header "Authorization: Bearer vp_..."
// Claude Desktop, Cursor ir kt. (mcp.json)
{"mcpServers":{"lt-procurement":{"url":"https://apibase.lt/api/pirkimai/mcp",
"headers":{"Authorization":"Bearer vp_..."}}}}
// Jei klientas negali nustatyti antraščių
{"mcpServers":{"lt-procurement":{"url":"https://apibase.lt/api/pirkimai/mcp?key=vp_..."}}}
Kaina
- Nemokamai: 100 užklausų su raktu (be kortelės); be rakto – 10 užklausų per dieną bandymui.
- Prenumerata – 19 € per mėnesį: iki 10 000 užklausų per mėnesį, pokyčių sekimas. Galutinė kaina (PVM netaikomas). Mokėjimas kortele per Stripe, atšaukti galima bet kada.
- Prenumeratos nuorodą rasite atsakyme
GET v1/key(laukassubscribe) arba puslapyje. Po apmokėjimo grįšite į patvirtinimo puslapį.
Sąlygos ir privatumas
- Paslaugą teikia MB „Web studija“, įmonės kodas 306455709, Alaušo g. 1C, Vilnius, info@saitai.lt.
- Duomenys imami iš viešai skelbiamų pirkimų: TED (ES institucijų duomenų pakartotinis naudojimas leidžiamas) ir viešo CVP IS sąrašo (vieša informacija). Duomenys gali vėluoti iki 24 valandų. Garantijų nesuteikiame – prieš teikdami pasiūlymą visada patikrinkite originalų skelbimą.
- Skelbimuose esančių kontaktinių asmenų duomenų nekopijuojame.
- Saugome raktą, el. paštą (tik su raktu susijusiems pranešimams) ir užklausų skaičių. IP adresas saugomas tik kaip neatkuriama santrauka limitams.
- Mokėjimą tvarko Stripe – kortelės duomenų negauname. Prenumeratą galima atšaukti bet kada Stripe kvito nuoroda arba parašius info@saitai.lt.
- Klausimai ir ištrynimo prašymai: info@saitai.lt.
Šaltiniai
- TED (Tenders Electronic Daily) – Europos Sąjungos viešųjų pirkimų portalas. Naudojame oficialią TED Search API: docs.ted.europa.eu.
- CVP IS – Lietuvos centrinė viešųjų pirkimų informacinė sistema. Skaitome viešą sąrašą „Naujausi pirkimai“ adresu viesiejipirkimai.lt: be prisijungimo ir lėtai, viena užklausa per 30 sekundžių, kad neapkrautume sistemos.
- Kiekvienas įrašas turi nuorodą į originalų skelbimą (
url, kai yra –notice_pdfirted_url).