API & MCP pentru integratori

Verifică firme RO din codul tău

Un singur API REST + server MCP. Aceleași date oficiale (ANAF, Registrul Comerțului, Ministerul Finanțelor, portalul instanțelor, BPI) — curate, datate și citabile, fără să scrii scraper. Profil de firmă gratuit; verdictul complet de risc, per verificare.

De ce Firmoscop, nu un scraper propriu: date deduplicate cu CUI ca cheie, fiecare câmp cu sursă + dată, verdict determinist explicabil (nu scor cutie-neagră), și singurul API din categorie nativ pentru agenți AI (MCP + llms.txt).

Autentificare

Cheie fk_… în headerul Authorization: Bearer. Generează-ți una în contul de dezvoltator — 3 verificări gratuite, fără card.

Authorization: Bearer fk_CHEIA_TA

Prețuri

CeCost
Căutare, profil firmă, bilanțuri, contracte publice, grup de firmegratis
Verificare completă (verdict + semnale + dosare + narațiune)1 credit

Pachete de credite: 50 / 200 / 1000. Creditele nu expiră. Fără abonament obligatoriu. Raport uman one-off (pagină web partajabilă): 19 lei.

Limite

30 cereri/min per cheie, 60/min per IP. Fiecare răspuns întoarce X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. Ai nevoie de mai mult? Scrie-ne pentru un plan enterprise.

Quickstart

REST — verdict de risc (1 credit)

curl https://firmoscop.ro/api/v1/verify/16269340 \
  -H "Authorization: Bearer fk_CHEIA_TA"

REST — profil de firmă (gratis)

curl https://firmoscop.ro/api/v1/company/16269340 \
  -H "Authorization: Bearer fk_CHEIA_TA"

REST — verificare în lot (1 credit / firmă)

curl -X POST https://firmoscop.ro/api/v1/verify/batch \
  -H "Authorization: Bearer fk_CHEIA_TA" \
  -H "Content-Type: application/json" \
  -d '{"cuis":["16269340","48778300","18189531"]}'

JavaScript / TypeScript

const r = await fetch("https://firmoscop.ro/api/v1/verify/16269340", {
  headers: { Authorization: `Bearer ${process.env.FIRMOSCOP_KEY}` },
});
const report = await r.json();

Python

import os, requests
r = requests.get(
    "https://firmoscop.ro/api/v1/verify/16269340",
    headers={"Authorization": f"Bearer {os.environ['FIRMOSCOP_KEY']}"},
)
report = r.json()

MCP — conectează un agent (Claude, ChatGPT)

claude mcp add --transport http firmoscop https://firmoscop.ro/mcp \
  --header "Authorization: Bearer fk_CHEIA_TA"

Endpoint-uri

MetodăRutăCost
GET/api/v1/search?q=gratis
GET/api/v1/company/{cui}gratis
GET/api/v1/company/{cui}/financialsgratis
GET/api/v1/company/{cui}/contractsgratis
GET/api/v1/company/{cui}/connectionsgratis
GET/api/v1/vat/{cui}gratis
GET/api/v1/vies/{country}/{vat}gratis
GET/api/v1/caen/{code} · /api/v1/caen?q=gratis
GET/api/v1/verify/{cui}1 credit
POST/api/v1/verify/batch1 credit / firmă
GET/api/v1/companies?caen=&county= (prospectare)1 credit / pagină
GET/api/v1/watchlist (+ POST / DELETE)gratis
GET/api/v1/megratis
GET/api/v1/statspublic
POST/mcpper-tool

Specificația completă: OpenAPI · llms.txt

Termeni

Datele sunt din surse publice, orientative, la data verificării — nu garanție de plată sau consultanță. Revânzarea bulk a datelor e interzisă (ToS). Prelucrăm doar persoane juridice (confidențialitate).

Generează-ți cheia →