Documentație tehnică

Referința completă a endpoint-urilor API DataDriven, generată direct din specificația OpenAPI 3.1, plus catalogul complet al uneltelor MCP. Pentru o prezentare a produsului și tarifelor vezi pagina de detalii API & MCP.

Base URL: https://api.datadriven.ro/v1 openapi.yaml mcp-tools.yaml
Claude
ChatGPT
Copilot
Gemini
DataDriven.ro
CRM
BI

Unelte MCP disponibile

Server-ul MCP la https://api.datadriven.ro/mcp expune următoarele unelte cu descrieri optimizate pentru consum LLM. Definițiile complete sunt în mcp-tools.yaml.

Cont
get_me
Identitatea proiectului asociat cheii: { projectId, projectName }.
get_usage
Contorul de retrieve-uri + creditele de overflow + starea limitei de operațiuni: callsCap = max(callsCapFloor, creditsUsedThisCycle × callsPerCredit) — fiecare credit folosit ridică limita de apeluri cu 500. Ciclurile sunt ancorate pe ziua de plată Stripe.
Licitații — listări
list_monitored_tenders
Licitațiile care matchează criteriile proiectului (CPV/cuvinte cheie/autorități) — același feed ca Monitorizare Licitații. Include overlay tags/color/comment.
list_saved_tenders
Licitațiile salvate (bookmarked) în proiect — același set ca meniul Salvate.
list_all_tenders
Recentele din întreg corpusul (Toate Licitațiile) — fără filtre de monitorizare, fără overlay.
Licitații — detalii
get_tender_by_id
Obiectul complet (NoticeComplete) după id-ul intern — loturi, atribuiri, attachments cu SAS, AI, plus overlay tags/color/comment. Consumă 1 full-retrieval per ciclu (deduplicat).
get_tender_by_notice
Aceeași licitație după numărul public SEAP/SICAP (ex. SCN1174909). Aceeași limită.
get_tender_history
Date pentru panoul Istoric: licitații similare ale autorității + top furnizori pe acel CPV/categorie. Nu intră în limită.
Licitații — text din documente

Toate trei împart același pool de deduplicare cu get_tender_by_id: dacă ai cerut deja licitația în acest ciclu, sunt gratuite.

get_tender_pages
Textul OCR-uit din attachments, paginat (pages.json). Răspuns tăiat la ~60 000 caractere cu nextPage/nextAttachment pentru a continua.
download_tender_pages
URL SAS 15-min către pages.json + preview per-attachment (totalPages + primele 200 caractere). Pentru agenți cu acces filesystem care vor să descarce și să grep-uiască local.
find_in_tender
Căutare substring case-insensitive prin textul attachments — returnează doar fragmente cu context. Token-efficient pentru găsit garanții, cantități, modele etc.
get_tender_attachments
Lista attachment-urilor cu link-uri de descărcare: originalUrl (fișierul brut) și searchableUrl (PDF OCR-uit, text selectabil), arhivele zip (originale + searchable) și pagesJsonUrl (textul extras pagină cu pagină). Pentru când utilizatorul cere fișiere, PDF-uri sau „textul licitației”.
Atribuiri
search_awards_full
Aceeași căutare ca meniul Atribuiri — toate filtrele (CPV, categorie, zonă, autoritate, companie, date, valori) plus flag-urile applyMonitoringCriteria și onlyOngoingAcquisitions.
Companii
get_company
Identitate + statistici precomputate din tabelul companyStats (valori câștigate, număr loturi, top autorități, top competitori). Două citiri punctuale, fără agregare on-the-fly.