firme
api
.ro
Căutare & Filtrare Avansată

API Lista Firme

Căutare și filtrare peste 3 milioane de firme din România. Taxare echitabilă — plătești doar pentru rezultatele primite.

3M+ firme
10+ filtre
<100ms răspuns
0.70 credite/rezultat
Obține Cheie API Documentație

Filtre Avansate

10 Parametri de Filtrare

Găsește exact firmele de care ai nevoie cu filtre puternice combinate

q

Text (CUI, nume)

judet

Cod Județ

localitate

Localitate

caen

Cod CAEN

stare

Stare Firmă

data

Data Exactă

data_start

De la Data

data_end

Până la Data

tva

Plătitor TVA

telefon

Are Telefon

Cum Funcționează

Taxare Dinamică per Rezultat

Spre deosebire de alte API-uri, la /firme nu plătești per cerere, ci doar pentru rezultatele efectiv primite. 0 rezultate = 0 credite consumate.

Formula de Calcul

credite = rezultate × 0.70

Costul final se rotunjește în sus (ceil)

0 rezultate = 0 credite

Nu plătești nimic dacă nu există rezultate.

Max 20 rezultate / pagină

Costul maxim per cerere: 14 credite (20 × 0.70).

Verificare credite înainte de cerere

Dacă nu ai suficiente credite, primești eroare fără consum.

Erori (4xx, 5xx) — 0 credite

Doar răspunsurile cu succes (200 OK) consumă credite.

Exemple de Cost

Pagină completă20 × 0.70
14 credite
15 rezultate15 × 0.70
11 credite
10 rezultate10 × 0.70
7 credite
5 rezultate5 × 0.70
4 credite
3 rezultate3 × 0.70
3 credite
1 rezultat1 × 0.70
1 credite
Niciun rezultat0 × 0.70
0 credite

Header răspuns

"credits": {
  "cost": 14,
  "results_charged": 20,
  "cost_per_result": 0.70
}

Același model de taxare se aplică și la /puncte-lucru

Endpoint-ul pentru puncte de lucru folosește aceeași taxare dinamică: 0.70 credite per rezultat, max 20 rezultate per pagină.

Cazuri de Utilizare

Pentru Ce Folosești Lista de Firme?

Analiză de Piață

Studiază competiția și dimensiunea pieței pe un domeniu CAEN specific.

Marketing B2B

Liste de prospecți pentru campanii email și cold outreach targetat.

Lead Generation

Lead-uri calificate pentru echipa de vânzări cu filtre geografice.

Îmbogățire CRM

Completează și actualizează automat datele din aplicația ta CRM.

Referință

Documentație API

Taxare dinamică — plătești doar pentru rezultatele primite

GET/api/v1/firme0.70 credite/rezultat

Exemplu Request

curl -X GET "https://www.firmeapi.ro/api/v1/firme?judet=CJ&caen=6201&tva=1" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Exemplu Response

200 OK
{
  "success": true,
  "data": {
    "items": [
      {
        "cui": 12345678,
        "denumire": "POPESCU TECH SRL",
        "data_inregistrare": "2020-03-15",
        "stare": "INREGISTRAT",
        "cod_caen": "6201",
        "nr_reg_com": "J12/1234/2020",
        "adresa_sediu_social": {
          "localitate": "Cluj-Napoca",
          "judet": "CLUJ"
        },
        "tva": { "platitor": true },
        "siruta_sediu_social": {
          "denloc": "CLUJ-NAPOCA",
          "nuts": "RO113",
          "codp": 400001
        }
      }
    ],
    "pagination": {
      "total": 1542,
      "page": 1,
      "per_page": 20,
      "total_pages": 78
    }
  },
  "credits": {
    "cost": 14,
    "results_charged": 20,
    "cost_per_result": 0.70
  }
}

Taxare Dinamică

0.70 credite × număr rezultate. 0 rezultate = 0 credite.

20 Rezultate / Pagină

Rezultate paginate cu metadata pentru navigare.

Date SIRUTA

Include cod SIRUTA, NUTS, regiune, cod poștal per rezultat.

Documentație completă cu coduri județe, stări și exemple →

Începe să Cauți Firme

Creează un cont gratuit, generează o cheie API și ai acces instant la peste 3 milioane de firme din România.

Creează Cont Gratuit Contactează-ne