API pentru firme din România

URL de bază

https://api.srleads.ro/v1

Autentificare

Fiecare request necesită o cheie API trimisă în header-ul Authorization. Cheile se generează din dashboard după activarea unui plan cu acces API.

curl https://api.srleads.ro/v1/companies/search?q=restaurant \
  -H "Authorization: Bearer YOUR_API_KEY"

Alternativ: header x-api-key: YOUR_API_KEY

Căutare companii

Caută companii active din România. Filtrare după nume, cod CAEN sau județ. Returnează rezultate paginate.

Parametri

Exemplu request

GET https://api.srleads.ro/v1/companies/search?q=restaurant&county=CJ&limit=10

Exemplu răspuns

{
  "data": [
    {
      "cui": 12345678,
      "name": "EXEMPLU SRL",
      "county_name": "BUCURESTI",
      "city_name": "Sector 1",
      "caen_code": "6201",
      "legal_form": "SRL",
      "status": "ACTIVA",
      "is_vat_payer": 1
    }
  ],
  "pagination": {
    "limit": 25,
    "offset": 0,
    "has_more": false
  },
  "meta": {
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "credits_remaining": 94
  }
}

Interogare după CUI

Returnează datele complete ale unei firme după codul unic de identificare (CUI). Include date financiare din ultimul an fiscal, administrator, telefon și adresă.

Parametri

Exemplu request

GET https://api.srleads.ro/v1/companies/12345678

Exemplu răspuns

{
  "data": {
    "cui": 12345678,
    "name": "EXEMPLU SRL",
    "county_name": "BUCURESTI",
    "city_name": "Sector 1",
    "full_address": "Str. Exemplu nr. 1",
    "caen_code": "6201",
    "status": "ACTIVA",
    "is_vat_payer": 1,
    "phone": "+40212345678",
    "admin_name": "Ion Popescu",
    "financial_year": 2024,
    "net_revenue": 1500000,
    "employees": 25
  },
  "meta": {
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "credits_remaining": 93
  }
}

Cazuri de utilizare

Coduri de eroare

Limite și prețuri

Header-ele X-Usage-Limit și X-Usage-Used indică cota și consumul curent. Câmpul credits_remaining din corpul răspunsului arată apelurile rămase.

Întrebări frecvente

Cum pot accesa API-ul SRLeads?

Creează un cont gratuit și generează o cheie API din dashboard. Planul Free include 250 de apeluri pe lună. Folosește cheia în header-ul Authorization: Bearer YOUR_API_KEY la fiecare request.

Cât costă accesul la API?

Planul Free include 250 de apeluri API pe lună. Planul Starter (79 RON/lună) oferă 10.000 de apeluri pe lună. Planul Pro (159 RON/lună) oferă acces nelimitat. Planurile plătite includ 14 zile de test gratuit.

Ce date returnează API-ul pentru o firmă?

Endpoint-ul de lookup returnează: denumire, CUI, cod CAEN cu denumire, adresă completă (județ, oraș, stradă), stare fiscală, plătitor TVA, telefon, administrator, cifra de afaceri, profit net și număr de angajați din ultimul an fiscal.

Pot folosi API-ul pentru autofill în formulare?

Da. Trimite un CUI la endpoint-ul /v1/companies/:cui și primești înapoi denumirea, adresa, codul CAEN și starea fiscală — ideal pentru auto-completare în formulare de facturare, onboarding sau KYC.

Care este limita de rate?

Toate planurile au o limită de 10 request-uri pe secundă per cheie API. Limita lunară depinde de plan: 250/lună pe Free, 10.000/lună pe Starter, nelimitat pe Pro. Header-ele X-Usage-Limit și X-Usage-Used indică cota și consumul curent.